기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 허용 목록의 상태 확인 허용 목록을 생성하는 경우 주기적으로 허용 목록의 상태를 확인하는 것이 중요합니다. 그렇지 않으면 오류가 발생하여 Amazon Macie가 Amazon Simple Storage Service(Amazon S3) 데이터에 대한 예상치 못한 분석 결과를 생성할 수 있습니다. 예를 들어 Macie는 허용 목록에 지정한 텍스트에 대해 민감한 데이터 조사 결과를 생성할 수 있습니다. 허용 목록을 사용하도록 민감한 데이터 검색 작업을 구성했는데 작업이 실행되기 시작할 때 Macie가 해당 목록에 액세스하거나 목록을 사용할 수 없더라도 작업은 계속 실행됩니다. 하지만 Macie는 S3 객체를 분석할 때 이 목록을 사용하지 않습니다. 마찬가지로, 민감한 데이터 자동 검색을 위한 분석 주기가 시작되고 Macie가 지정된 허용 목록에 액세스하거나 이를 사용할 수 없는 경우에도 분석은 계속되지만 Macie는 해당 목록을 사용하지 않습니다. 정규 표현식(*정규식*)을 지정하는 허용 목록에서는 오류가 발생할 가능성이 거의 없습니다. 이는 목록 설정을 만들거나 업데이트할 때 Macie가 자동으로 정규식을 테스트하기 때문입니다. 또한 정규식 및 기타 모든 목록 설정을 Macie에 저장됩니다. 하지만 사전 정의된 텍스트를 지정하는 허용 목록에 오류가 발생할 수 있는데, 이는 사용자가 목록을 Macie 대신 Amazon S3에 저장하기 때문입니다. 일반적인 오류 원인은 다음과 같습니다. + S3 버킷 또는 객체를 삭제한 경우. + S3 버킷 또는 객체의 이름이 변경되었지만 Macie의 목록 설정에 새 이름이 지정되지 않은 경우. + S3 버킷의 권한 설정이 변경되고 Macie가 버킷 및 객체에 대한 액세스 권한을 상실한 경우. + S3 버킷의 암호화 설정이 변경되어 Macie가 목록을 저장하는 객체의 암호를 해독할 수 없는 경우. + 암호화 키에 대한 정책이 변경되어 Macie가 키에 대한 액세스 권한을 잃은 경우. Macie가 목록을 저장한 S3 객체를 해독할 수 없는 경우. **중요** 이러한 오류는 분석 결과에 영향을 미치므로 모든 허용 목록의 상태를 주기적으로 확인하는 것이 좋습니다. 허용 목록을 저장하는 S3 버킷의 권한 또는 암호화 설정을 변경하거나 목록을 암호화하는 데 사용되는 AWS Key Management Service (AWS KMS) 키에 대한 정책을 변경하는 경우에도이 작업을 수행하는 것이 좋습니다. 오류를 해결하는 데 도움이 되는 자세한 정보는 [사전 정의된 텍스트 목록의 옵션 및 요구 사항](allow-lists-options.md#allow-lists-options-s3list)을 참조하세요. **허용 목록의 상태를 확인하려면** Amazon Macie 콘솔 또는 Amazon Macie API를 사용하여 허용 목록의 상태를 확인할 수 있습니다. 콘솔에서 단일 페이지를 사용하여 모든 허용 목록의 상태를 동시에 확인할 수 있습니다. Amazon Macie API를 사용하는 경우 개별 허용 목록의 상태를 한 번에 하나씩 확인할 수 있습니다. ------ #### [ Console ] Amazon Macie 콘솔을 사용하여 허용 목록의 상태를 확인하려면 다음 단계를 따르세요. **허용 목록의 상태를 확인하려면** 1. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)에서 Amazon Macie 콘솔을 엽니다. 1. 탐색 창의 **설정**에서 **허용 목록**을 선택합니다. 1. **허용 목록** 페이지에서 새로 고침(![\[The refresh button, which is a button that displays an empty blue circle with an arrow.\]](http://docs.aws.amazon.com/ko_kr/macie/latest/user/images/btn-refresh-data.png))을 선택합니다. Macie는 모든 허용 목록의 설정을 테스트하고 각 목록의 현재 상태가 표시되도록 **상태** 필드를 업데이트합니다. 목록에 정규 표현식이 지정되어 있는 경우, 해당 상태는 일반적으로 **정상**입니다. 즉, Macie가 표현식을 컴파일할 수 있다는 뜻입니다. 목록에 사전 정의된 텍스트가 지정된 경우 상태는 다음 값 중 하나일 수 있습니다. **정상** Macie는 목록의 내용을 검색하고 구문 분석할 수 있습니다. **액세스 거부됨** Macie는 목록을 저장하는 S3 객체에 액세스할 수 없습니다. Amazon S3가 객체 검색 요청을 거부했습니다. Macie가 사용할 수 없는 고객 관리형 로 객체를 암호화 AWS KMS key 한 경우에도 목록에이 상태가 있을 수 있습니다. 이 오류를 해결하려면, 버킷 및 객체에 대한 버킷 정책 및 기타 권한 설정을 확인합니다. Macie가 객체에 액세스하고 검색할 수 있는지 확인합니다. 객체가 고객 관리형 AWS KMS 키로 암호화된 경우 키 정책도 검토하고 Macie가 키를 사용할 수 있는지 확인합니다. **오류** Macie가 목록의 내용을 검색하거나 구문 분석하려고 할 때 일시적인 또는 내부 오류가 발생했습니다. 허용 목록이 Amazon S3와 Macie가 액세스하거나 사용할 수 없는 암호화 키로 목록을 암호화한 경우에도 이 상태가 될 수 있습니다. 이 오류를 해결하려면 몇 분 정도 기다렸다가 새로 고침(![\[The refresh button, which is a button that displays an empty blue circle with an arrow.\]](http://docs.aws.amazon.com/ko_kr/macie/latest/user/images/btn-refresh-data.png))을 선택합니다. 상태가 계속 **오류**로 표시되면 S3 객체의 암호화 설정을 확인합니다. 객체가 Amazon S3와 Macie가 액세스하고 사용할 수 있는 키로 암호화되어 있는지 확인합니다. **객체가 비어 있음** Macie는 Amazon S3에서 목록을 검색할 수 있지만 목록에 콘텐츠가 없습니다. 이 오류를 해결하려면 Amazon S3에서 객체를 다운로드하고 객체에 포함된 항목이 올바른지 확인합니다. 항목이 올바르면 Macie에서 목록의 설정을 검토합니다. 지정된 버킷과 객체 이름이 정확한지 확인합니다. **객체를 찾을 수 없음** Amazon S3에 목록이 없습니다. 이 오류를 해결하려면, Macie에서 목록의 설정을 검토합니다. 지정된 버킷과 객체 이름이 정확한지 확인합니다. **할당량 초과** Macie는 Amazon S3에 있는 목록에 액세스할 수 있습니다. 하지만 목록의 항목 수 또는 목록의 스토리지 크기가 허용 목록의 할당량을 초과합니다. 이 오류를 해결하려면, 목록을 여러 파일로 나누세요. 각 파일에 포함된 항목이 100,000개 미만인지 확인합니다. 또한 각 파일의 크기가 35MB 미만이어야 합니다. 그런 다음 각 파일을 Amazon S3에 업로드합니다. 이후 Macie에서 각 파일의 목록 설정을 구성합니다. 지원되는 각 AWS 리전에 사전 정의된 텍스트 목록을 최대 5개까지 포함할 수 있습니다. **병목 현상 발생** Amazon S3가 목록 검색 요청을 제한했습니다. 이 오류를 해결하려면 몇 분 정도 기다렸다가 새로 고침(![\[The refresh button, which is a button that displays an empty blue circle with an arrow.\]](http://docs.aws.amazon.com/ko_kr/macie/latest/user/images/btn-refresh-data.png))을 선택합니다. **사용자 액세스 거부됨** Amazon S3가 객체 검색 요청을 거부했습니다. 지정된 객체가 있는 경우 객체에 액세스할 수 없거나 사용할 수 없는 AWS KMS 키로 암호화됩니다. 이 오류를 해결하려면 AWS 관리자와 협력하여 목록의 설정이 올바른 버킷 및 객체 이름을 지정하고 버킷 및 객체에 대한 읽기 액세스 권한이 있는지 확인합니다. 객체가 암호화된 경우, 사용할 수 있는 키로 해당 객체를 암호화해야 합니다. 1. 특정 목록의 설정과 상태를 검토하려면, 해당 목록 이름을 선택합니다. ------ #### [ API ] 허용 목록의 상태를 프로그래밍 방식으로 확인하려면 Amazon Macie API의 [GetAllowList](https://docs.aws.amazon.com/macie/latest/APIReference/allow-lists-id.html) 작업을 사용합니다. 또는를 사용하는 경우 [get-allow-list](https://docs.aws.amazon.com/cli/latest/reference/macie2/get-allow-list.html) 명령을 AWS CLI실행합니다. `id` 매개 변수에 상태를 확인하려는 허용 목록의 고유 식별자를 지정합니다. 이 식별자를 얻으려면, [ListAllowLists](https://docs.aws.amazon.com/macie/latest/APIReference/allow-lists.html) 작업을 사용합니다. 이 **ListAllowLists** 작업은 계정의 모든 허용 목록에 대한 정보를 검색합니다. 를 사용하는 경우 [list-allow-lists](https://docs.aws.amazon.com/cli/latest/reference/macie2/list-allow-lists.html) 명령을 실행하여이 정보를 검색할 AWS CLI수 있습니다. **GetAllowList** 요청을 제출하면, Macie는 허용 목록에 대한 모든 설정을 테스트합니다. 설정에 정규 표현식(`regex`)이 지정되어 있는 경우, Macie에서 해당 표현식을 컴파일할 수 있는지 확인합니다. 설정에 사전 정의된 텍스트(`s3WordsList`) 목록이 지정된 경우, Macie는 목록을 검색하고 구문 분석할 수 있는지 확인합니다. 그러면 Macie는 허용 목록의 세부 정보를 제공하는 `GetAllowListResponse` 객체를 반환합니다. `GetAllowListResponse` 객체에서 `status` 객체는 목록의 현재 상태, 즉 상태 코드(`code`)와 상태 코드에 따라 목록의 상태에 대한 간략한 설명(`description`)을 표시합니다. 허용 목록에 정규식이 지정되어 있는 경우, 상태 코드는 일반적으로 `OK`이며 관련 설명은 없습니다. 이는 Macie가 표현식을 성공적으로 컴파일했음을 뜻합니다. 허용 목록에 사전 정의된 텍스트가 지정되어 있는 경우, 다음과 같이 상태 코드는 테스트 결과에 따라 달라집니다. + Macie가 목록을 성공적으로 검색하고 구문 분석하면 상태 코드는 `OK` 이며 관련 설명은 없습니다. + 오류로 인해 Macie가 목록을 검색하거나 구문 분석을 할 수 없는 경우, 상태 코드와 설명에 발생한 오류의 특성이 표시됩니다. 가능한 상태 코드 목록과 각 상태 코드에 대한 설명은 *Amazon Macie API 참조*에 있는 [AllowListStatus](https://docs.aws.amazon.com/macie/latest/APIReference/allow-lists-id.html#allow-lists-id-model-allowliststatus)를 참조하세요. ------