허용 목록 생성

Amazon Macie 콘솔을 사용하여 허용 목록의 설정을 구성하려면 다음 단계를 따르세요.

Macie는 목록의 설정을 테스트합니다. 또한 Macie는 Amazon S3에서 목록을 검색하고 목록의 콘텐츠를 구문 분석할 수 있는지 확인합니다. 오류가 발생한 경우, Macie는 해당 오류를 설명하는 메시지를 표시합니다. 오류를 해결하는 데 도움이 되는 자세한 정보는 사전 정의된 텍스트 목록의 옵션 및 요구 사항을 참조하세요. 오류를 해결한 후, 목록의 설정을 저장할 수 있습니다.

허용 목록 설정을 프로그래밍 방식으로 구성하려면, Amazon Macie API의 CreateAllowList 작업을 사용하여 필수 매개 변수에 적절한 값을 지정하세요.

criteria 매개 변수에는 s3WordsList 객체를 사용하여 S3 버킷 이름(bucketName)과 목록을 저장하는 S3 객체(objectKey)의 이름을 지정합니다. 버킷 이름은 Amazon S3의 Name 필드를 참조하세요. 객체 이름은 Amazon S3의 Key 필드를 참조하세요. 이러한 값은 대소문자를 구분합니다. 추가로 이름을 지정할 때 와일드카드 문자나 부분 값을 사용하지 마세요.

를 사용하여 설정을 구성하려면 create-allow-list 명령을 AWS CLI실행하고 필요한 파라미터에 적절한 값을 지정합니다. 다음 예제는 amzn-s3-demo-bucket이라는 이름의 S3 버킷에 저장된 허용 목록의 설정을 구성하는 방법입니다. 목록을 저장하는 S3 객체의 이름은 allowlists/macie/mylist.txt입니다.

이 예제는 Linux, macOS 또는 Unix용으로 포맷되었으며, 가독성을 높이기 위해 백슬래시(\) 줄 연속 문자를 사용합니다.

$ aws macie2 create-allow-list \
--criteria '{"s3WordsList":{"bucketName":"amzn-s3-demo-bucket","objectKey":"allowlists/macie/mylist.txt"}}' \
--name my_allow_list \
--description "Lists public phone numbers and names for Example Corp."

이 예제는 Microsoft Windows용으로 포맷되었으며 가독성을 높이기 위해 캐럿(^) 줄 연속 문자를 사용합니다.

C:\> aws macie2 create-allow-list ^
--criteria={\"s3WordsList\":{\"bucketName\":\"amzn-s3-demo-bucket\",\"objectKey\":\"allowlists/macie/mylist.txt\"}} ^
--name my_allow_list ^
--description "Lists public phone numbers and names for Example Corp."

요청을 제출하면, Macie는 목록 설정을 테스트합니다. 또한 Macie는 Amazon S3에서 목록을 검색하고 목록의 콘텐츠를 구문 분석할 수 있는지 확인합니다. 오류가 발생하면 요청이 실패하고 Macie는 오류를 설명하는 메시지를 반환합니다. 오류를 해결하는 데 도움이 되는 자세한 정보는 사전 정의된 텍스트 목록의 옵션 및 요구 사항을 참조하세요.

Macie가 목록을 검색하고 구문 분석할 수 있으면, 요청이 성공하고 다음과 비슷한 출력이 표시됩니다.

{
    "arn": "arn:aws:macie2:us-west-2:123456789012:allow-list/nkr81bmtu2542yyexample",
    "id": "nkr81bmtu2542yyexample"
}

여기서 arn은 생성된 허용 목록의 Amazon 리소스 이름(ARN)이고, id는 목록의 고유 식별자입니다.

Amazon Macie 콘솔을 사용하여 허용 목록을 생성하려면 다음 단계를 따르세요.

Macie는 목록의 설정을 테스트합니다. Macie는 또한 정규식을 테스트하여 표현식을 컴파일할 수 있는지 확인합니다. 오류가 발생한 경우, Macie는 해당 오류를 설명하는 메시지를 표시합니다. 오류를 해결하는 데 도움이 되는 자세한 정보는 정규 표현식의 옵션 및 요구 사항을 참조하세요. 오류를 해결한 후 허용 목록을 저장할 수 있습니다.

Macie에서 이러한 유형의 허용 목록을 만들기 전에 여러 샘플 데이터세트를 사용하여 정규식을 테스트하고 수정하는 것이 좋습니다. 너무 일반적인 정규식을 만들면, Macie는 민감하다고 생각되는 텍스트의 발생을 무시할 수 있습니다. 정규식이 너무 구체적일 경우, Macie는 사용자가 민감하다고 생각하지 않는 텍스트의 발생을 무시할 수 있습니다.

Macie를 사용하여 표현식을 테스트하려면 Amazon Macie API의 TestCustomDataIdentifier 작업을 사용하거나에 대해 test-custom-data-identifier 명령을 AWS CLI실행할 수 있습니다. Macie는 동일한 기본 코드를 사용하여 허용 목록 및 사용자 지정 데이터 식별자에 대한 표현식을 컴파일합니다. 이러한 방식으로 표현식을 테스트하는 경우 regex 및 sampleText 매개 변수에 대한 값만 지정해야 합니다. 그렇지 않으면 부정확한 결과를 얻을 수 있습니다.

이러한 유형의 허용 목록을 생성할 준비가 되면 Amazon Macie API의 CreateAllowList 작업을 사용하여 필수 매개 변수에 적절한 값을 지정합니다. criteria 매개 변수의 경우, regex 필드를 사용하여 무시할 텍스트 패턴을 정의하는 정규 표현식을 지정합니다. 표현식에는 512자까지 포함할 수 있습니다.

를 사용하여이 유형의 목록을 생성하려면 create-allow-list 명령을 AWS CLI실행하고 필요한 파라미터에 적절한 값을 지정합니다. 다음 예제에서는 my_allow_list라는 이름의 허용 목록을 만듭니다. 이 정규식은 사용자 지정 데이터 식별자가 example.com 도메인에 대해 감지할 수 있는 모든 이메일 주소를 무시하도록 설계되었습니다.

이 예제는 Linux, macOS 또는 Unix용으로 포맷되었으며, 가독성을 높이기 위해 백슬래시(\) 줄 연속 문자를 사용합니다.

$ aws macie2 create-allow-list \
--criteria '{"regex":"[a-z]@example.com"}' \
--name my_allow_list \
--description "Ignores all email addresses for Example Corp."

이 예제는 Microsoft Windows용으로 포맷되었으며 가독성을 높이기 위해 캐럿(^) 줄 연속 문자를 사용합니다.

C:\> aws macie2 create-allow-list ^
--criteria={\"regex\":\"[a-z]@example.com\"} ^
--name my_allow_list ^
--description "Ignores all email addresses for Example Corp."

요청을 제출하면, Macie는 목록 설정을 테스트합니다. Macie는 또한 정규식을 테스트하여 표현식을 컴파일할 수 있는지 확인합니다. 오류가 발생하면, 요청이 실패하고 Macie는 오류를 설명하는 메시지를 반환합니다. 오류를 해결하는 데 도움이 되는 자세한 정보는 정규 표현식의 옵션 및 요구 사항을 참조하세요.

Macie가 표현식을 컴파일할 수 있으면, 요청이 성공하고 다음과 유사한 출력이 표시됩니다.

{
    "arn": "arn:aws:macie2:us-west-2:123456789012:allow-list/km2d4y22hp6rv05example",
    "id": "km2d4y22hp6rv05example"
}

여기서 arn은 생성된 허용 목록의 Amazon 리소스 이름(ARN)이고, id는 목록의 고유 식별자입니다.