创建允许列表

按照以下步骤，使用 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命令，并为所需参数指定相应的值。以下示例介绍了如何为存储于 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 进行格式化，并使用脱字号 (^) 行继续符来提高可读性。

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 中创建此类允许列表前，我们建议您使用多组示例数据测试和完善 regex。如果您创建的正则表达式过于笼统，Macie 可能会忽略您视为敏感的文本。如果正则表达式过于具体，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的允许列表。正则表达式旨在忽略自定义数据标识符能够检测到的、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是此列表的唯一标识符。