View a markdown version of this page

AWS Abuse Signal API identity-based policy examples - AWS Abuse Signal API

AWS Abuse Signal API identity-based policy examples

By default, IAM users and roles don’t have permission to call AWS Abuse Signal API. An IAM administrator must create IAM policies that grant identities permission to perform the abuse: actions they need, and then attach those policies to the IAM users, groups, or roles that require them.

To learn how to create an IAM identity-based policy using these example JSON policy documents, see Creating policies on the JSON tab in the IAM User Guide.

Note

The abuse: actions operate at the account level and do not support resource-level permissions. AWS Abuse Signal API has no report ARN that you can name in a policy, so you must set "Resource" to "*" in the following examples. The service still scopes results from ListAbuseReportStatuses to the caller’s own AWS account.

Policy best practices

  • Apply least-privilege permissions – Grant only the abuse: actions each identity needs.

  • Use IAM roles and short-lived credentials – Avoid long-lived access keys and the account root user.

  • Require multi-factor authentication (MFA) – Turn on MFA for identities that require it.

For more information, see Security best practices in IAM in the IAM User Guide.

Least-privilege policy: submit only

The following policy grants permission to submit abuse reports, but not to read or list them. Because the abuse: actions don’t support resource-level permissions, "Resource" is set to "*".

{ "Version": "2012-10-17", "Statement": [ { "Sid": "SubmitAbuseReports", "Effect": "Allow", "Action": "abuse:CreateAbuseReport", "Resource": "*" } ] }

Least-privilege policy: submit and track

The following policy grants permission to submit, retrieve, and list abuse reports. Because the abuse: actions don’t support resource-level permissions, "Resource" is set to "*".

{ "Version": "2012-10-17", "Statement": [ { "Sid": "SubmitAndTrackAbuseReports", "Effect": "Allow", "Action": [ "abuse:CreateAbuseReport", "abuse:GetAbuseReportStatus", "abuse:ListAbuseReportStatuses" ], "Resource": "*" } ] }