Utilisation de rôles liés à un service pour les intégrations gérées

Les intégrations gérées pour la gestion des AWS IoT appareils utilisent des rôles AWS Identity and Access Management liés aux services (IAM). Un rôle lié à un service est un type unique de rôle IAM directement lié aux intégrations gérées. Les rôles liés aux services sont prédéfinis par les intégrations gérées et incluent toutes les autorisations dont le service a besoin pour appeler d'autres AWS services en votre nom.

Un rôle lié à un service facilite la configuration des intégrations gérées, car vous n'avez pas à ajouter manuellement les autorisations nécessaires. Les intégrations gérées pour AWS IoT Device Management définissent les autorisations associées à ses rôles liés aux services et, sauf indication contraire, seules les intégrations gérées peuvent assumer ces rôles. Les autorisations définies comprennent la politique d’approbation et la politique d’autorisation. De plus, cette politique d’autorisation ne peut pas être attachée à une autre entité IAM.

Vous pouvez supprimer un rôle lié à un service uniquement après la suppression préalable de ses ressources connexes. Cela protège les ressources de vos intégrations gérées, car vous ne pouvez pas supprimer par inadvertance l'autorisation d'accès aux ressources.

Pour plus d'informations sur les autres services qui prennent en charge les rôles liés à un service, consultez la section AWS Services qui fonctionnent avec IAM et recherchez les services dont la valeur est Oui dans la colonne Rôles liés à un service. Sélectionnez un Oui ayant un lien pour consulter la documentation du rôle lié à un service, pour ce service.

Autorisations de rôle liées à un service pour les intégrations gérées

Les intégrations gérées pour la gestion des AWS IoT appareils utilisent le rôle lié au service nommé AWSServiceRoleForIoTManagedIntégrations : fournit des intégrations gérées pour autoriser la gestion des AWS IoT appareils à publier des journaux et des statistiques en votre nom.

Le rôle lié au service AWSService RoleForIo TManaged Integrations fait confiance aux services suivants pour assumer ce rôle :

• iotmanagedintegrations.amazonaws.com

La politique d'autorisations de rôle nommée AWSIo TManaged IntegrationsServiceRolePolicy permet aux intégrations gérées d'effectuer les actions suivantes sur les ressources spécifiées :

• Action : logs:CreateLogGroup, logs:DescribeLogGroups, logs:CreateLogStream, logs:PutLogEvents, logs:DescribeLogStreams, cloudwatch:PutMetricData on all of your managed integrations resources.

{
  "Version" : "2012-10-17",
  "Statement" : [
    { 
      "Sid" : "CloudWatchLogs",
      "Effect" : "Allow",
      "Action" : [
        "logs:CreateLogGroup",
        "logs:DescribeLogGroups"
      ],
      "Resource" : [
        "arn:aws:logs:*:*:log-group:/aws/iotmanagedintegrations/*"
      ]
    },
    {
      "Sid" : "CloudWatchStreams",
      "Effect" : "Allow",
      "Action" : [
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
      ],
      "Resource" : [
        "arn:aws:logs:*:*:log-group:/aws/iotmanagedintegrations/*:log-stream:*"
      ]
    },
    {
      "Sid" : "CloudWatchMetrics",
      "Effect" : "Allow",
      "Action" : [
        "cloudwatch:PutMetricData"
      ],
      "Resource" : "*",
      "Condition" : {
        "StringEquals" : {
          "cloudwatch:namespace" : [
            "AWS/IoTManagedIntegrations",
            "AWS/Usage"
          ]
        }
      }
    }
  ]
}

Vous devez configurer les autorisations de manière à permettre à vos utilisateurs, groupes ou rôles de créer, modifier ou supprimer un rôle lié à un service. Pour plus d’informations, consultez Autorisations de rôles liés à un service dans le Guide de l’utilisateur IAM.

Création d'un rôle lié à un service pour les intégrations gérées

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous provoquez un type d'événement tel que l'PutRuntimeLogConfigurationappel de commandes ou d'RegisterCustomEndpointAPI dans le AWS Management Console, ou l' AWS API AWS CLI, les intégrations gérées créent le rôle lié au service pour vous. CreateEventLogConfiguration Pour plus d'informations sur PutRuntimeLogConfigurationCreateEventLogConfiguration, ouRegisterCustomEndpoint, voir PutRuntimeLogConfigurationCreateEventLogConfiguration, ou RegisterCustomEndpoint.

Si vous supprimez ce rôle lié à un service et que vous avez ensuite besoin de le recréer, vous pouvez utiliser la même procédure pour recréer le rôle dans votre compte. Lorsque vous provoquez un type d'événement tel que l'appel de commandes ou d'RegisterCustomEndpointAPI PutRuntimeLogConfigurationCreateEventLogConfiguration, Managed Integrations crée à nouveau le rôle lié au service pour vous. Vous pouvez également contacter AWS le Support client via le AWS Support Center Console. Pour plus d'informations sur les plans de AWS support, consultez Comparer les plans de support AWS.

Vous pouvez également utiliser la console IAM pour créer un rôle lié à un service avec le cas d'utilisation IoT ManagedIntegrations - Managed Role. Dans l'API AWS CLI ou dans l' AWS API, créez un rôle lié à un service avec le nom du iotmanagedintegrations.amazonaws.com service. Pour plus d’informations, consultez Création d’un rôle lié à un service dans le Guide de l’utilisateur IAM. Si vous supprimez ce rôle lié à un service, vous pouvez utiliser ce même processus pour créer le rôle à nouveau.

Modification d'un rôle lié à un service pour les intégrations gérées

les intégrations gérées ne vous permettent pas de modifier le rôle lié au service AWSService RoleForIo TManaged Intégrations. Une fois que vous avez créé un rôle lié à un service, vous ne pouvez pas changer le nom du rôle, car plusieurs entités peuvent faire référence à ce rôle. Néanmoins, vous pouvez modifier la description du rôle à l’aide d’IAM. Pour plus d’informations, consultez Modification d’un rôle lié à un service dans le IAM Guide de l’utilisateur.

Supprimer un rôle lié à un service pour les intégrations gérées

Si vous n’avez plus besoin d’utiliser une fonctionnalité ou un service qui nécessite un rôle lié à un service, nous vous recommandons de supprimer ce rôle. De cette façon, vous n’avez aucune entité inutilisée qui n’est pas surveillée ou gérée activement. Cependant, vous devez nettoyer les ressources de votre rôle lié à un service avant de pouvoir les supprimer manuellement.

Note

Si les intégrations gérées utilisent le rôle lorsque vous essayez de supprimer les ressources, la suppression risque d'échouer. Si cela se produit, patientez quelques minutes et réessayez.

Pour supprimer manuellement le rôle lié à un service à l’aide d’IAM

Utilisez la console IAM AWS CLI, le ou l' AWS API pour supprimer le rôle lié au service AWSService RoleForIo TManaged Integrations. Pour plus d’informations, consultez Suppression d’un rôle lié à un service dans le Guide de l’utilisateur IAM.

Régions prises en charge pour les intégrations gérées, les rôles liés aux services

Les intégrations gérées pour la gestion des AWS IoT appareils prennent en charge l'utilisation de rôles liés au service dans toutes les régions où le service est disponible. Pour de plus amples informations, veuillez consulter AWS Régions et points de terminaison.