Utilisation de rôles liés à un service pour Classic AWS WAF - AWS WAF, AWS Firewall Manager, et AWS Shield Advanced

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Avertissement

AWS WAF Le support classique prendra fin le 30 septembre 2025.

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 du WebACLs, AWS WAF avant novembre 2019, et que vous ne les avez pas encore migrées vers la dernière version. Pour migrer votre site WebACLs, consultezMigration de vos ressources AWS WAF classiques vers AWS WAF.

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

AWS WAF Classic utilise AWS Identity and Access Management (IAM) des rôles liés à un service. Un rôle lié à un service est un type unique de IAM rôle directement lié à AWS WAF Classic. 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'autorisation ne peut être attachée à aucune autre IAM entité.

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 à un service, consultez la section AWS Services compatibles avec IAM et recherchez les services dont la valeur est Oui dans la colonne Rôle lié au service. Choisissez un 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 de plus amples informations, veuillez consulter Enregistrement des informations relatives au ACL trafic 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 pour autoriser une IAM entité (telle qu'un utilisateur, un groupe ou un rôle) à créer, modifier ou supprimer un rôle lié à un service. Pour plus d'informations, consultez la section Autorisations relatives aux rôles liés à un service dans le guide de l'IAMutilisateur.

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 AWS WAF version classique CLI ou AWS WAF classiqueAPI, 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. Vous pouvez toutefois modifier la description du rôle à l'aide deIAM. Pour plus d'informations, consultez la section Modification d'un rôle lié à un service dans le guide de l'IAMutilisateur.

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

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 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 site WebACL. Pour de plus amples informations, veuillez consulter Enregistrement des informations relatives au ACL trafic Web.

  2. À l'aide du API ouCLI, soumettez une DeleteLoggingConfiguration demande pour chaque site Web sur ACL lequel la journalisation est activée. Pour plus d'informations, consultez la section APIRéférence AWS WAF classique.

Pour supprimer manuellement le rôle lié à un service à l'aide de IAM

Utilisez la IAM console IAMCLI, le ou le IAM API pour supprimer les rôles AWSServiceRoleForWAFRegionalLogging liés au service AWSServiceRoleForWAFLogging et. Pour plus d'informations, consultez la section Suppression d'un rôle lié à un service dans le guide de l'IAMutilisateur.

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