建立允許清單

請依照下列步驟，使用 Amazon Macie 主控台來設定允許清單的設定。

Macie 會測試清單的設定。Macie 也會驗證它可以從 Amazon S3 擷取清單，並剖析清單的內容。如果發生錯誤，Macie 會顯示說明錯誤的訊息。如需可協助您對錯誤進行故障診斷的詳細資訊，請參閱 預先定義文字清單的選項和需求。解決任何錯誤之後，您可以儲存清單的設定。

若要以程式設計方式設定允許清單設定，請使用 Amazon Macie API 的 CreateAllowList 操作，並為所需的參數指定適當的值。

針對 criteria 參數，使用 s3WordsList 物件來指定 S3 儲存貯體 (bucketName) 的名稱，以及存放清單的 S3 物件 (objectKey) 名稱。若要判斷儲存貯體名稱，請參閱 Amazon S3 中的 Name 欄位。若要判斷物件名稱，請參閱 Amazon S3 中的 Key 欄位。請注意，這些值區分大小寫。此外，當您指定這些名稱時，請勿使用萬用字元或部分值。

若要使用 來設定設定 AWS CLI，請執行 create-allow-list 命令，並指定所需參數的適當值。下列範例示範如何為存放在名為 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 進行格式化，並使用 caret (^) line-contination 字元來改善可讀性。

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 Resource Name (ARN)，id也是清單的唯一識別符。

請依照下列步驟，使用 Amazon Macie 主控台建立允許清單。

Macie 會測試清單的設定。Macie 也會測試 regex，以確認它可以編譯表達式。如果發生錯誤，Macie 會顯示說明錯誤的訊息。如需可協助您排除錯誤的詳細資訊，請參閱 規則表達式的選項和要求。解決任何錯誤之後，您可以儲存允許清單。

在 Macie 中建立此類型的允許清單之前，我們建議您使用多組範例資料來測試和精簡 regex。如果您建立過於一般的 regex，Macie 可能會忽略您認為敏感的文字。如果 regex 太具體，Macie 可能不會忽略您不認為敏感的文字。

若要使用 Macie 測試表達式，您可以使用 Amazon Macie API 的 TestCustomDataIdentifier 操作，或針對 AWS CLI執行 test-custom-data-identifier 命令。Macie 使用相同的基礎程式碼來編譯允許清單和自訂資料識別符的表達式。如果您以這種方式測試表達式，請務必僅指定 regex和 sampleText 參數的值。否則，您將收到不準確的結果。

當您準備好建立此類型的允許清單時，請使用 Amazon Macie API 的 CreateAllowList 操作，並為所需的參數指定適當的值。針對 criteria 參數，使用 regex 欄位指定定義要忽略的文字模式的規則表達式。該運算式最多可包含 512 個字元。

若要使用 建立此類型的清單 AWS CLI，請執行 create-allow-list 命令，並指定所需參數的適當值。下列範例會建立名為 my_allow_list 的允許清單。regex 旨在忽略自訂資料識別符可能以其他方式為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 進行格式化，並使用 caret (^) line-contination 字元來改善可讀性。

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 也會測試 regex，以確認它可以編譯表達式。如果發生錯誤，請求會失敗，Macie 會傳回說明錯誤的訊息。如需可協助您排除錯誤的詳細資訊，請參閱 規則表達式的選項和要求。

如果 Macie 可以編譯表達式，則請求會成功，而您會收到類似以下的輸出：

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

其中 arn是所建立允許清單的 Amazon Resource Name (ARN)，id也是清單的唯一識別符。