Utilisation de rôles liés à un service pour Classic AWS WAF

Note

Il s'agit d'une documentation AWS WAF classique. Vous ne devez utiliser cette version que si vous avez créé AWS WAF des ressources, telles que des règles et des ACL Web, AWS WAF avant novembre 2019, et que vous ne les avez pas encore migrées vers la dernière version. Pour migrer vos ressources, veuillez consulter Migration de vos ressources AWS WAF classiques vers AWS WAF.

Pour la dernière version de AWS WAF, voirAWS WAF.

AWS WAF Utilise les rôles AWS Identity and Access Management liés au service (IAM) de façon classique. Un rôle lié à un service est un type unique de rôle IAM directement lié à Classic. AWS WAF Les rôles liés à un service sont prédéfinis par AWS WAF Classic 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 de AWS WAF Classic, car il n'est pas nécessaire d'ajouter manuellement les autorisations nécessaires. AWS WAF Classic définit les autorisations associées à ses rôles liés aux services et, sauf indication contraire, seul AWS WAF Classic peut assumer ses rôles. Les autorisations définies comprennent la politique d'approbation et la politique d'autorisations. Cette politique d'autorisations ne peut pas être attachée à une autre entité IAM.

Vous ne pouvez supprimer un rôle lié à un service qu’après avoir supprimé les ressources connexes du rôle. Cela protège vos ressources AWS WAF Classic, 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 aux services, consultez Services AWS fonctionnant avec IAM et recherchez les services où Oui figure dans la colonne Rôle lié à un service. Choisissez un Yes (oui) ayant un lien permettant de consulter les détails du rôle pour ce service.

Autorisations de rôle liées à un service pour Classic AWS WAF

AWS WAF Classic utilise les rôles liés aux services suivants :

• AWSServiceRoleForWAFLogging

• AWSServiceRoleForWAFRegionalLogging

AWS WAF Classic utilise ces rôles liés à des services pour écrire des journaux sur Amazon Data Firehose. Ces rôles ne sont utilisés que si vous activez la connexion AWS WAF. Pour plus d’informations, consultez Journalisation des informations de trafic de la liste ACL web.

Les rôles AWSServiceRoleForWAFLogging et AWSServiceRoleForWAFRegionalLogging liés à un service font confiance aux services suivants (respectivement) pour assumer le rôle :

• waf.amazonaws.com

  waf-regional.amazonaws.com

Les politiques d'autorisation des rôles permettent à AWS WAF Classic d'effectuer les actions suivantes sur les ressources spécifiées :

• Action : firehose:PutRecord et firehose:PutRecordBatch sur les ressources de flux de données Amazon Data Firehose dont le nom commence par « aws-waf-logs - ». Par exemple, aws-waf-logs-us-east-2-analytics.

Vous devez configurer les autorisations de manière à permettre à une entité IAM (comme un utilisateur, un groupe ou un rôle) de créer, modifier ou supprimer un rôle lié à un service. Pour plus d'informations, consultez Service-Linked Role Permissions (autorisations du rôle lié à un service) dans le IAM User Guide (guide de l'utilisateur IAM).

Création d'un rôle lié à un service pour Classic AWS WAF

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous activez la connexion AWS WAF classique sur le AWS Management Console, ou que vous faites une PutLoggingConfiguration demande dans la CLI AWS WAF classique ou l'API AWS WAF classique, AWS WAF Classic crée le rôle lié au service pour vous.

Vous devez disposez de l'autorisation iam:CreateServiceLinkedRole pour activer la journalisation.

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 activez la journalisation AWS WAF classique, AWS WAF Classic crée à nouveau le rôle lié au service pour vous.

Modification d'un rôle lié à un service pour Classic AWS WAF

AWS WAF Classic ne vous permet pas de modifier les rôles AWSServiceRoleForWAFLogging et les rôles AWSServiceRoleForWAFRegionalLogging liés à un service. 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 au 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 Guide de l’utilisateur IAM.

Supprimer un rôle lié à un service pour Classic AWS WAF

Si vous n'avez plus besoin d'utiliser une fonction 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 le service AWS WAF Classic utilise 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 les ressources AWS WAF classiques utilisées par AWSServiceRoleForWAFLogging et AWSServiceRoleForWAFRegionalLogging

1. Sur la console AWS WAF Classic, supprimez la journalisation de chaque ACL Web. Pour plus d’informations, consultez Journalisation des informations de trafic de la liste ACL web.

2. Au moyen de l'API ou de l'interface de ligne de commande, envoyez une requête DeleteLoggingConfiguration pour chaque liste ACL web avec la journalisation activée. Pour plus d'informations, consultez la section AWS WAF Classic API Reference.

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

Utilisez la console IAM, la CLI IAM ou l'API IAM pour supprimer les rôles liés à un serviceAWSServiceRoleForWAFLogging. AWSServiceRoleForWAFRegionalLogging Pour plus d’informations, veuillez consulter Suppression d’un rôle lié à un service dans le Guide de l’utilisateur IAM.

Régions prises en charge pour les AWS WAF rôles classiques liés à un service

AWS WAF Classic prend en charge l'utilisation de rôles liés à un service dans les sections suivantes. Régions AWS

Nom de la région	Identité de la région	Support dans la AWS WAF version classique
USA Est (Virginie du Nord)	us-east-1	Oui
USA Est (Ohio)	us-east-2	Oui
USA Ouest (Californie du Nord)	us-west-1	Oui
USA Ouest (Oregon)	us-west-2	Oui
Asie-Pacifique (Mumbai)	ap-south-1	Oui
Asie-Pacifique (Osaka)	ap-northeast-3	Oui
Asie-Pacifique (Séoul)	ap-northeast-2	Oui
Asie-Pacifique (Singapour)	ap-southeast-1	Oui
Asie-Pacifique (Sydney)	ap-southeast-2	Oui
Asie-Pacifique (Tokyo)	ap-northeast-1	Oui
Canada (Centre)	ca-central-1	Oui
Europe (Francfort)	eu-central-1	Oui
Europe (Irlande)	eu-west-1	Oui
Europe (Londres)	eu-west-2	Oui
Europe (Paris)	eu-west-3	Oui
Amérique du Sud (São Paulo)	sa-east-1	Oui