建立允許清單

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

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

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

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

若要使用 來設定設定 AWS CLI，請執行 create-allow-list命令，並為所需的參數指定適當的值。下列範例示範如何設定儲存在名為 的 S3 儲存貯體中的允許清單的設定 amzn-s3-demo-bucket。 存放清單的 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 （^） 換行字元來改善可讀性。

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"
}

允許清單建立的 Amazon Resource Name （ARN） arn位於此處，id是清單的唯一識別符。

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

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

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

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

當您準備好建立此類型的允許清單時，請使用 Amazon Macie CreateAllowList的操作，API並為所需的參數指定適當的值。針對 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 （^） 換行字元來改善可讀性。

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"
}

允許清單建立的 Amazon Resource Name （ARN） arn位於此處，id是清單的唯一識別符。