View a markdown version of this page

Permissions - Amazon IoT Device Defender
Give Amazon IoT Device Defender detect permission to publish alarms to an SNS topic
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Permissions

Note

The Amazon IoT Device Defender detect feature will no longer be available to new customers starting August 31, 2026. If you would like to use the detect feature, sign up prior to August 31, 2026. To learn about alternatives to Amazon IoT Device Defender detect, see Amazon IoT Device Defender detect feature availability change. There is no change to Amazon IoT Device Defender audit availability.

This section contains information about how to set up the IAM roles and policies required to manage Amazon IoT Device Defender Detect. For more information, see the IAM User Guide.

Give Amazon IoT Device Defender detect permission to publish alarms to an SNS topic

If you use the alertTargets parameter in CreateSecurityProfile, you must specify an IAM role with two policies: a permissions policy and a trust policy. The permissions policy grants permission to Amazon IoT Device Defender to publish notifications to your SNS topic. The trust policy grants Amazon IoT Device Defender permission to assume the required role.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sns:Publish"
            ],
            "Resource": [
                "arn:aws-cn:sns:us-east-1:123456789012:your-topic-name"
            ]
        }
    ]
}
JSON
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
        "Service": "iot.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

You also need an IAM permissions policy attached to the IAM user that allows the user to pass roles. See Granting a User Permissions to Pass a Role to an Amazon Service.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": [
                "iam:GetRole",
                "iam:PassRole"
            ],
            "Resource": "arn:aws-cn:iam::123456789012:role/Role_To_Pass"
        }
    ]
}