Intégrer AWS WAF à Google SecOps

Ce document explique comment intégrer AWS WAF à Google Security Operations (Google SecOps).

Cas d'utilisation

L'intégration d'AWS WAF vous aide à sécuriser vos applications Web en vous permettant d'effectuer les opérations suivantes :

  • Automatiser le blocage des adresses IP : ajoutez automatiquement les adresses IP malveillantes détectées par Google SecOps aux ensembles d'adresses IP AWS WAF pour bloquer le trafic en périphérie du réseau.
  • Gérer les listes de contrôle des accès (LCA) : créez et mettez à jour de manière dynamique des LCA Web pour répondre aux nouvelles menaces.
  • Orchestrer la sécurité globale et régionale : gérez les règles pour les ressources régionales (comme les ALB) et les ressources globales (Amazon CloudFront) à partir d'une seule interface.

Paramètres d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
AWS Access Key ID (ID de clé d'accès AWS) Chaîne N/A Oui ID de clé d'accès AWS à utiliser dans l'intégration.
Clé secrète AWS Mot de passe N/A Oui Clé secrète AWS à utiliser dans l'intégration.
Région AWS par défaut Chaîne N/A Oui Région AWS par défaut à utiliser dans l'intégration, par exemple "us-west-2".

Le champ d'application Regional dans AWS WAF correspond à la région définie ici. Le champ d'application CloudFront est global et ne dépend pas de cette région, mais les ressources créées sous Regional sont limitées à cette valeur.

Pour gérer les ressources AWS WAF dans plusieurs régions AWS, vous devez configurer une instance d'intégration distincte pour chaque région.

Pour savoir comment configurer une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement si nécessaire. Après avoir configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour en savoir plus sur la configuration et la prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis votre bureau et Exécuter une action manuelle dans votre demande.

Ping

Testez la connectivité à AWS WAF.

Paramètres

N/A

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit : "Connexion au serveur AWS WAF établie avec les paramètres de connexion fournis."

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'échec : "Échec de la connexion au serveur AWS WAF ! Error is {0}".format(exception.stacktrace)

 Général

Créer un ensemble d'IP

Créez un ensemble d'adresses IP dans AWS WAF, en fonction des entités.

L'ensemble d'adresses IP est créé au format suivant :

Siemplify_NAME_IP Type`

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Name Chaîne N/A Oui Spécifiez le nom de l'ensemble d'adresses IP. Remarque : L'action créera un ensemble d'adresses IP au format suivant : Siemplify_{Name}_{IP Type}. Le nom doit comporter entre 1 et 128 caractères. Caractères valides : A-Z, a-z, 0-9, - (trait d'union) et _ (trait de soulignement).
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Spécifiez le champ d'application pour la création d'ensembles d'adresses IP. Si l'option "Les deux" est sélectionnée, l'action crée un jeu d'adresses IP dans les champs d'application régional et Amazon CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Description Chaîne N/A Non Spécifiez la description de l'ensemble d'adresses IP.
Tags CSV N/A Non Spécifiez les tags supplémentaires à ajouter au jeu d'adresses IP. Format : clé_1:valeur_1,clé_2:valeur_1.

Exécuter sur

Cette action s'exécute sur l'entité "Adresse IP".

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
"Regional": ["IPv4_set", "IPv6_set"]
"Cloudfront":  ["IPv4_set", "IPv6_set"]
}
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit et qu'au moins l'une des entités fournies a été utilisée pour créer un jeu d'adresses IP (is_success = true) : "Successfully created {0} {1} IP Set '{2}' in AWS WAF with the following IPs: \n {3}".format("Regional"/"Cloudfront", "IPv4"/"IPv6", full_name, entity.identifier list)

Si l'utilisation d'entités spécifiques échoue(is_success = true) : "Action was not able to use the following IPs in order to create AWS WAF IP Set\n: {0}".format([entity.identifier])

Si l'utilisation de toutes les entités échoue (is_success = false) : "Aucun jeu d'adresses IP n'a été créé. Raison : Aucune des entités d'adresse IP fournies n'était valide."

Si tous les ensembles existent déjà (is_success=false) ou si seulement certains ensembles existent déjà (is_success=true) : "The following {0} IP Pattern Sets '{1}' already exist: \n.".format("Regional/CloudFront", list_of_full_names)

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'erreur fatale (identifiants incorrects, absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Créer un ensemble d'adresses IP". Reason: {0}''.format(error.Stacktrace)

Ajouter une adresse IP à un ensemble d'adresses IP

Ajoutez des adresses IP à l'ensemble d'adresses IP dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Noms des ensembles d'IP CSV N/A Oui Spécifiez la liste des noms d'ensembles d'adresses IP, séparés par une virgule. Exemple : nom_1,nom_2
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Spécifiez le champ d'application de l'ensemble d'adresses IP. Si vous sélectionnez "Les deux", l'action ajoutera des adresses IP aux ensembles d'adresses IP dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.

Exécuter sur

Cette action s'exécute sur l'entité "Adresse IP".

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit et qu'au moins une adresse IP a été ajoutée à un ensemble d'adresses IP(is_success = true) : "Successfully added the following IPs to the {0} IP Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, entity.identifier list)

Si l'ajout d'entités spécifiques à l'un des ensembles d'adresses IP échoue(is_success = true) : "Action was not able to add the following IPs to the {0} IP Set '{1}' in AWS WAF\n: {2}".format("Regional"/"Cloudfront", full_name,[entity.identifier])

Si l'un des ensembles d'adresses IP est introuvable (is_success = true) : "Action wasn't able to find the following '{0}' IP Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

Si l'action ne parvient pas à trouver tous les ensembles d'adresses IP fournis dans le ou les champs d'application sélectionnés (is_success=false) : "L'action n'a pas trouvé les ensembles d'adresses IP fournis."

L'action doit échouer et arrêter l'exécution d'un playbook :

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Add IP To IP Set". Reason: {0}''.format(error.Stacktrace)

 Général

Créer un ensemble de modèles d'expression régulière

Créez un ensemble de modèles d'expressions régulières dans AWS WAF en fonction des entités.

L'ensemble de modèles d'expression régulière ne peut contenir que 10 modèles par ensemble, et il ne peut y avoir que 10 ensembles de modèles d'expression régulière au total.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Name Chaîne N/A Oui Spécifiez le nom de l'ensemble de modèles d'expressions régulières. Remarque : Le nom doit comporter entre 1 et 128 caractères. Caractères valides : A-Z, a-z, 0-9, - (trait d'union) et _ (trait de soulignement).
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Spécifiez le champ d'application pour la création d'ensembles de modèles d'expressions régulières. Si l'option "Les deux" est sélectionnée, l'action crée un jeu de modèles d'expressions régulières dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Description Chaîne N/A Non Spécifiez la description de l'ensemble de modèles d'expressions régulières.
Tags CSV N/A Non Spécifiez les tags supplémentaires à ajouter à l'ensemble de modèles d'expressions régulières. Format : clé_1:valeur_1,clé_2:valeur_1.
Modèle de domaine Case à cocher Cochée Non Si cette option est activée, l'action récupère la partie domaine des URL et crée un modèle d'expression régulière basé sur celles-ci. Par exemple, http://test.com/folder est converti en ^(http|https)(:\/\/)(\Qtest.com\E).*".format(entity).
Format d'adresse IP Case à cocher Cochée Non Si cette option est activée, l'action crée un modèle d'expression régulière approprié à partir de l'adresse IP au lieu d'utiliser une valeur brute, par exemple 10.0.0.1 est converti en ^(http|https)(:\/\/)(\Q10.0.1\E).*".format(entity).

Exécuter sur

Cette action s'exécute sur les entités suivantes :

  • Adresse IP
  • URL

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
"Regional": "Regex_set"
"Cloudfront": "Regex_set"
}
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

En cas de réussite et si au moins l'une des entités fournies a été utilisée pour créer un ensemble d'expressions régulières (is_success = true) : "Successfully created {0} Regex Pattern Set '{1}' in AWS WAF with the following entities: \n {2}".format("Regional"/"Cloudfront", name, entity.identifier list)

Si plus de 10 entités sont utilisées pour créer un ensemble de modèles d'expressions régulières : "L'action n'a pas pu créer d'ensembles de modèles d'expressions régulières avec toutes les entités fournies, car la limite a été dépassée. Les entités suivantes ont été ignorées : {0}".format(entity.identifier)

Si l'ensemble existe déjà (is_success=false) : "{0} Regex Pattern Set '{1}' already exists.".format("Regional/CloudFront", name)

L'action doit échouer et arrêter l'exécution d'un playbook :

If fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Create Regex Pattern Set". Reason: {0}''.format(error.Stacktrace)

 Général

Créer des LCA Web

Créez une LCA Web dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Name Chaîne N/A Oui Spécifiez le nom de la LCA Web. Remarque : Le nom doit comporter entre 1 et 128 caractères. Caractères valides : A-Z, a-z, 0-9, - (trait d'union) et _ (trait de soulignement).
Type de source de la règle LDD

Ensemble d'IP

Valeur possible

Ensemble d'IP

Groupe de règles

 Oui Spécifiez le type de règle à utiliser.
Nom de la source de la règle Chaîne N/A Oui Spécifiez le nom de la source à utiliser pour la LCA Web. Si le "Type de source de la règle" est "Ensemble d'adresses IP", l'action recherchera les ensembles d'adresses IP portant ce nom. Si le "Type de source de la règle" est "Groupe de règles", l'action recherchera les groupes de règles portant ce nom.
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Spécifiez le champ d'application pour la création de la LCA Web. Si vous sélectionnez "Les deux", l'action créera une LCA Web dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Activer les requêtes échantillonnées Case à cocher Décochée Oui Si cette option est activée, AWS WAF stockera un échantillon des requêtes Web qui correspondent aux règles.
Activer les métriques CloudWatch Case à cocher Décochée Oui Si cette option est activée, la ressource associée envoie des métriques à CloudWatch.
Nom de la métrique CloudWatch Case à cocher Décochée Oui Spécifiez le nom de la métrique CloudWatch. Remarque : Le nom doit comporter entre 1 et 128 caractères. Caractères valides : A-Z, a-z, 0-9, - (trait d'union) et _ (trait de soulignement).
Action par défaut LDD

Autoriser

Valeurs possibles :

  • Autoriser
  • Bloquer
 Oui Spécifiez l'action par défaut pour les requêtes qui ne correspondent à aucune règle.
Action sur l'ensemble d'IP LDD

Bloquer

Valeur possible :

  • Autoriser
  • Bloquer
  • Nombre
 Non Spécifiez l'action pour les règles basées sur l'ensemble d'adresses IP.
Priorité de la règle Integer N/A Oui Spécifiez la priorité de la règle. Les priorités dans la LCA Web doivent être uniques.
Description Chaîne N/A Non Spécifiez la description de la LCA Web.
Tags CSV N/A Non Spécifiez les tags supplémentaires à ajouter à la LCA Web. Format : clé_1:valeur_1,clé_2:valeur_1.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
"Regional": "Web_Acl_name"
"Cloudfront": "Web_Acl_name"
}
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si les jeux d'adresses IP disponibles ont bien été listés(is_success = true) et que "Scope" == "Both" : "Successfully created Web ACL {0} in Regional and CloudFront scopes.".format(name)

Si les ensembles d'adresses IP disponibles ont bien été listés(is_success = true) et que "Scope" == "Regional" : "Successfully created Web ACL {0} in Regional.".format(name)

Si les ensembles d'adresses IP disponibles ont bien été listés(is_success = true) et que "Scope" == "Cloudfront" : "Successfully created Web ACL {0} in Cloudfront scope.".format(name)

Si la LCA Web existe :

Affichez "The Web ACL {} already exists in {} scope.".format(web ACL name, scope).

Si l'ensemble d'adresses IP ou le groupe de règles est introuvable : "Action wasn't able to create Web ACL. Reason: {0} {1} wasn't found in AWS WAF".format("IP Set/Rule Group", Rule Source Name)

L'action doit échouer et arrêter l'exécution d'un playbook :

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Create Web ACL". Reason: {0}''.format(error.Stacktrace)

Ajouter une règle à la LCA Web

Ajoutez une règle basée sur des ensembles d'adresses IP ou des groupes de règles à une LCA Web dans AWS WAF. La LCA Web peut contenir au maximum 1 500 règles.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Noms des LCA Web CSV N/A Oui

Spécifiez la liste des noms de LCA Web, séparés par une virgule. Exemple : nom_1,nom_2
Type de source de la règle LDD

Ensemble d'IP

Valeurs possibles :

  • Ensemble d'IP
  • Groupe de règles
 Oui Spécifiez le type de règle à utiliser.
Nom de la source de la règle Chaîne N/A Oui Spécifiez le nom de la source à utiliser pour la LCA Web. Si le "Type de source de la règle" est "Ensemble d'adresses IP", l'action recherchera les ensembles d'adresses IP portant ce nom. Si le "Type de source de la règle" est "Groupe de règles", l'action recherchera les groupes de règles portant ce nom.
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Spécifiez le champ d'application des nouvelles règles. Si l'option "Les deux" est sélectionnée, l'action ajoutera une règle à une LCA Web dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Priorité de la règle Integer N/A Oui Spécifiez la priorité de la règle. Les priorités dans la LCA Web doivent être uniques.
Action sur l'ensemble d'IP LDD

Bloquer

Valeur possible :

  • Autoriser
  • Bloquer
  • Nombre
 Non Spécifiez l'action pour les règles basées sur l'ensemble d'adresses IP.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

En cas de réussite et si au moins une règle a été ajoutée à une LCA Web(is_success = true) : "Successfully added a rule to the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of name)

Si l'une des LCA Web est introuvable(is_success = true) : "Action wasn't able to find the following '{0}' Web ACLs in the AWS WAF:\n {1}".format("Regional"/Cloudfront", list of Web ACLs that were not found in that scope)

Si une règle portant ce nom existe déjà pour chaque LCA Web dans le champ d'application (is_success=true) : "L'action n'a pas pu ajouter {0} règles à la LCA Web dans AWS WAF. Motif : {0} avec le nom "{1}" existe déjà dans les LCA Web suivantes :\n{2}".format( rule source type, rule source name, list Web ACL with scope - structure {0} - {1}.format(scope, web acl name))

L'action doit échouer et arrêter l'exécution d'un playbook :

If fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Add Rule To Web ACL". Reason: {0}''.format(error.Stacktrace)

 Général

Créer un groupe de règles

Créez un groupe de règles dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Name Chaîne N/A Oui Spécifiez le nom du groupe de règles. Remarque : Le nom doit comporter entre 1 et 128 caractères. Caractères valides : A-Z, a-z, 0-9, - (trait d'union) et _ (trait de soulignement).
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Spécifiez le champ d'application pour la création du groupe de règles. Si l'option "Les deux" est sélectionnée, l'action crée un groupe de règles dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Capacité Integer 100 Oui Spécifiez la capacité du groupe de règles. Remarque : Vous ne pouvez pas modifier la capacité une fois le groupe créé. La valeur maximale est de 1 500.
Activer les requêtes échantillonnées Case à cocher Décochée Oui Si cette option est activée, AWS WAF stockera un échantillon des requêtes Web qui correspondent aux règles.
Activer les métriques CloudWatch Case à cocher Décochée Oui Si cette option est activée, la ressource associée envoie des métriques à CloudWatch.
Nom de la métrique CloudWatch Case à cocher Décochée Oui Spécifiez le nom de la métrique CloudWatch. Remarque : Le nom doit comporter entre 1 et 128 caractères. Caractères valides : A-Z, a-z, 0-9, - (trait d'union) et _ (trait de soulignement).
Description Chaîne N/A Non Spécifiez la description du groupe de règles.
Tags CSV N/A Non Spécifiez les tags supplémentaires à ajouter au groupe de règles. Format : key_1:value_1,key_2:value_1.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si les jeux d'adresses IP disponibles ont bien été listés(is_success = true) et que "Scope" == "Both" : "Successfully created Rule Group {0} in Regional and CloudFront scopes.".format(name)

>Si les jeux d'adresses IP disponibles ont bien été listés(is_success = true) et que "Scope" == "Regional" : "The Rule Group {} already exists in {} scope.".format(web ACL name, scope).

Si les ensembles d'adresses IP disponibles ont bien été listés(is_success = true) et que "Scope" == "Cloudfront" : "Successfully created Rule Group {0} in Cloudfront scope.".format(name)

Si le groupe de règles existe : "Successfully created Rule Group {0} in Cloudfront scope.".format(name)

Si la création du groupe de règles échoue : "Action was not able to create Rule Group {} in {} scope".format(web ACL name, scope).

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'erreur fatale, d'erreur du SDK (par exemple, identifiants incorrects, absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Créer un groupe de règles". Reason: {0}''.format(error.Stacktrace)

 Général

Ajouter une entité à l'ensemble de modèles d'expression régulière

Ajoutez des modèles de chaîne basés sur des entités à l'ensemble de modèles d'expressions régulières dans AWS WAF.

L'ensemble de modèles d'expression régulière ne peut contenir que 10 modèles.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Noms des ensembles de modèles d'expression régulière CSV N/A Oui Spécifiez la liste des noms d'ensembles de modèles d'expression régulière, séparés par une virgule, par exemple name_1,name_2.
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Champ d'application de l'ensemble de modèles d'expression régulière. Si l'option "Both" (Les deux) est sélectionnée, l'action ajoute des modèles basés sur des entités aux ensembles de modèles d'expressions régulières dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Modèle de domaine Case à cocher Cochée Non Si cette option est activée, l'action récupère la partie domaine des URL et crée un modèle d'expression régulière basé sur celles-ci. Par exemple, http://test.com/folder est converti en ^(http|https)(:\/\/)(\Qtest.com\E).*".format(entity).
Format d'adresse IP Case à cocher Cochée

Non

 Si cette option est activée, l'action crée un modèle d'expression régulière approprié à partir de l'adresse IP au lieu d'utiliser une valeur brute, par exemple 10.0.0.1 est converti en ^(http|https)(:\/\/)(\Q10.0.1\E).*".format(entity).

Exécuter sur

Cette action s'exécute sur les entités suivantes :

  • Adresse IP
  • URL

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit et qu'au moins une entité a été ajoutée à un ensemble de modèles d'expressions régulières(is_success = true) : "Successfully added the following entity patterns to the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", name, list of entity patterns)

Si plus de 10 entités sont utilisées pour créer un ensemble de modèles d'expression régulière : "Impossible d'ajouter des modèles à l'ensemble de modèles d'expression régulière {0} {1} en fonction de toutes les entités fournies, car la limite est dépassée. Les entités suivantes ont été ignorées : {2}".forma("Regional"/"Cloudfront", name, entity.identifier)

Si l'un des ensembles est introuvable (is_success = true) : "Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope)

Si tous les ensembles fournis ne sont pas trouvés dans le ou les champs d'application sélectionnés (is_success=false) : "L'action n'a pas trouvé les ensembles de modèles d'expression régulière fournis."

L'action doit échouer et arrêter l'exécution d'un playbook :

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Add Entity To Regex Pattern Set". Reason: {0}''.format(error.Stacktrace)

 Général

Ajouter un format à l'ensemble de formats d'expression régulière

Ajoutez des modèles de chaîne à l'ensemble de modèles d'expression régulière dans AWS WAF.

L'ensemble de modèles d'expression régulière ne peut contenir que 10 modèles par ensemble.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Noms des ensembles de modèles d'expression régulière CSV N/A Oui Spécifiez la liste des noms d'ensembles de modèles d'expression régulière, séparés par une virgule, par exemple name_1,name_2.
Patterns CSV N/A Oui Spécifiez la liste de formats séparés par une virgule à ajouter à l'ensemble de formats d'expression régulière, par exemple pattern_1,pattern_2.
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Champ d'application de l'ensemble de modèles d'expression régulière. Si l'option "Both" (Les deux) est sélectionnée, l'action ajoute des modèles basés sur des entités aux ensembles de modèles d'expressions régulières dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit et qu'au moins un modèle a été ajouté à un ensemble de modèles d'expression régulière(is_success = true) : "Successfully added the following patterns to the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", name, list of patterns)

Si l'un des ensembles est introuvable (is_success = true) : "Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope).

Si tous les ensembles fournis ne sont pas trouvés dans le ou les champs d'application sélectionnés (is_success=false) : "L'action n'a pas trouvé les ensembles de modèles d'expression régulière fournis."

L'action doit échouer et arrêter l'exécution d'un playbook :

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Add Pattern To Regex Pattern Set". Reason: {0}''.format(error.Stacktrace)

 Général

Supprimer la règle de la LCA Web

Supprimez une règle de la LCA Web dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Noms des LCA Web CSV Oui

Spécifiez la liste des noms de LCA Web, séparés par une virgule. Exemple : nom_1,nom_2
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Spécifiez le champ d'application pour la suppression de la LCA Web. Si l'option "Les deux" est sélectionnée, l'action supprimera une LCA Web dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Nom de la règle Chaîne

N/A

 Oui Spécifiez le nom de la règle à supprimer.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit et qu'au moins une règle a été supprimée d'un groupe de règles : affichez "Successfully removed a rule from the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names)

En cas d'échec pour un groupe de règles : afficher "Action wasn't able to remove a rule from the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names)

Si l'opération échoue pour une LCA Web, car la règle n'a pas été trouvée dans une LCA : affichez "Action wasn't able to find the specified rule in the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names Web ACL)

Si un groupe de règles est introuvable : affichez "Action wasn't able to find the following '{0}' Web ACLs in the AWS WAF:\n {1}".format("Regional"/Cloudfront", liste des groupes de règles introuvables dans ce champ d'application)

Si tous les ensembles fournis ne sont pas trouvés dans le ou les champs d'application souhaités : affichez "L'action n'a pas trouvé les LCA Web fournies".

L'action doit échouer et arrêter l'exécution d'un playbook :

if fatal error, SDK error, like wrong credentials, no connection to server, other: print "Error executing action "Remove Rule From Web ACL". Reason: {0}''.format(error.Stacktrace)

 Général

Lister les LCA Web

Répertoriez les LCA Web disponibles dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Spécifiez le champ d'application de la liste des LCA Web.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Nombre maximal de LCA Web à renvoyer Integer 50 Non Spécifiez le nombre de LCA Web à renvoyer. La valeur par défaut est 50. La valeur maximale est de 100.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat JSON
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
Mur des cas
Type de résultat Valeur/Description Type (Entité \ Général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si les jeux d'adresses IP disponibles ont bien été listés et que "Scope" == "Both" : "Successfully listed available Web ACLs in Regional and Cloudfront scopes."

Si les ensembles d'adresses IP disponibles ont bien été listés(is_success = true) et que "Scope" == "Regional" : "Successfully listed available Web ACLs in Regional scope."

Si les ensembles d'adresses IP disponibles ont bien été listés(is_success = true) et que "Scope" == "Cloudfront" : "Successfully listed available Web ACLs in Cloudfront scope."

Si aucune valeur n'est disponible(is_success = false) et que "Scope" == "Both" : "No available Web ACLs were found in Regional and Cloudfront scopes."

Si aucune valeur n'est disponible (is_success = false) et que "Scope" == "Regional" : "No available Web ACLs were found in Regional scope."

Si aucune valeur n'est disponible(is_success = false) et que "Scope" == "Cloudfront" : "No available Web ACLs were found in Cloudfront scope."

L'action doit échouer et arrêter l'exécution d'un playbook :

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "List Web ACLs". Reason: {0}''.format(error.Stacktrace)

 Général

Tableau du mur des cas

(si "Champ d'application" == "Régional" ou "Les deux")

Nom de la table : LCA des règles régionales

Colonnes du tableau :

  • Nom
  • ID
  • Description
  • Jeton de verrouillage
  • ARN
 Général

Tableau du mur des cas

(si "Champ d'application" == "CloudFront" ou "Les deux")

Nom de la table : LCA des règles CloudFront

Colonnes du tableau :

  • Nom
  • ID
  • Description
  • Jeton de verrouillage
  • ARN
 Général

Supprimer la règle du groupe de règles

Supprimez une règle du groupe de règles dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Noms des groupes de règles CSV Oui Spécifiez la liste des noms de groupes de règles, séparés par une virgule. Exemple : nom_1,nom_2
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Spécifiez le champ d'application de la suppression du groupe de règles. Si vous sélectionnez "Les deux", l'action supprimera un groupe de règles dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Nom de la règle Chaîne

N/A

 Oui Spécifiez le nom de la règle à supprimer.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit et qu'au moins une règle a été supprimée d'un groupe de règles : "Successfully removed a rule from the following {0} Rule Groups '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names)

Si l'action échoue pour un groupe de règles : "Action wasn't able to remove a rule from the following {0} Rule Groups '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names)

Si l'opération échoue pour un groupe de règles, car la règle n'a pas été trouvée dans un groupe de règles : "Action wasn't able to find the specified rule in the following {0} Rule Groups '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of rule group names)

Si l'un des groupes de règles est introuvable : "Action wasn't able to find the following '{0}' Rule Groups in the AWS WAF:\n {1}".format("Regional"/Cloudfront", list of Rule Group that were not found in that scope)

Si tous les ensembles fournis ne sont pas trouvés dans le ou les champs d'application souhaités : "L'action n'a pas trouvé les groupes de règles fournis."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale ou une erreur du SDK est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Remove Rule From Rule Group". Reason: {0}''.format(error.Stacktrace)

 Général

Lister les groupes de règles

Répertoriez les groupes de règles disponibles dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Spécifiez le champ d'application de la liste des groupes de règles.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Nombre maximal de groupes de règles à renvoyer Integer 50 Non Spécifiez le nombre de groupes de règles à renvoyer. La valeur par défaut est 50. La valeur maximale est de 100.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat JSON
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
Mur des cas
Type de résultat Valeur/Description Type (Entité \ Général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si les ensembles d'adresses IP disponibles ont bien été listés et que "Scope" == "Both" : "Successfully listed available Rule groups in Regional and Cloudfront scopes."

Si les ensembles d'adresses IP disponibles ont bien été listés et que "Scope" == "Regional" : "Successfully listed available Rule groups in Regional scope."

Si les ensembles d'adresses IP disponibles ont bien été listés et que "Scope" == "Cloudfront" : "Successfully listed available Rule groups in Cloudfront scope.">

Si aucune valeur n'est disponible et que "Scope" == "Both" : "Aucun groupe de règles disponible n'a été trouvé dans les champs d'application régional et Cloudfront."

Si aucune valeur n'est disponible et que "Champ d'application" == "Régional" : "Aucun groupe de règles disponible n'a été trouvé dans le champ d'application régional."

Si aucune valeur n'est disponible et que "Scope" == "Cloudfront" : "Aucun groupe de règles disponible n'a été trouvé dans le champ d'application Cloudfront."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale, une erreur de SDK (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) est signalée : "Error executing action "List Rule Groups". Reason: {0}''.format(error.Stacktrace)

 Général

Tableau des cas d'utilisation

(si "Champ d'application" == "Régional" ou "Les deux")

Nom du tableau : Groupes de règles régionaux

Colonnes du tableau :

  • Nom
  • ID
  • Description
  • Jeton de verrouillage
  • ARN
 Général

Tableau des cas d'utilisation

(si "Champ d'application" == "CloudFront" ou "Les deux")

Nom du tableau : Groupes de règles CloudFront

Colonnes du tableau :

  • Nom
  • ID
  • Description
  • Jeton de verrouillage
  • ARN
 Général

Lister les ensembles d'adresses IP

Répertoriez les ensembles d'adresses IP disponibles dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Spécifiez le champ d'application de la liste des ensembles d'adresses IP.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Nombre maximal d'ensembles d'adresses IP à renvoyer Integer 50 Non Spécifiez le nombre d'ensembles d'adresses IP à renvoyer. La valeur par défaut est 50. La valeur maximale est de 100.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat JSON
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
Mur des cas
Type de résultat Valeur/Description Type (Entité \ Général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si les ensembles d'adresses IP disponibles ont bien été listés et que "Scope" == "Both" : "Successfully listed available IP sets in Regional and Cloudfront scopes."

Si les jeux d'adresses IP disponibles ont bien été listés et que "Scope" == "Regional" : "Successfully listed available IP sets in Regional scope."

Si les jeux d'adresses IP disponibles ont bien été listés et que "Scope" == "Cloudfront" : "Les jeux d'adresses IP disponibles ont bien été listés dans le champ d'application Cloudfront."

Si aucune valeur n'est disponible et que "Scope" == "Both" : affichez "No available IP Sets were found in Regional and Cloudfront scopes."

Si aucune valeur n'est disponible et que "Champ d'application" == "Régional" : "Aucun jeu d'adresses IP disponible n'a été trouvé dans le champ d'application régional."

Si aucune valeur n'est disponible et que "Scope" == "Cloudfront" : "Aucun ensemble d'adresses IP disponible n'a été trouvé dans le champ d'application Cloudfront."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale, une erreur de SDK (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) est signalée : "Error executing action "List IP Sets". Reason: {0}''.format(error.Stacktrace)

 Général

Tableau des cas d'utilisation

(si "Champ d'application" == "Régional" ou "Les deux")

Nom du tableau : Groupes de règles régionaux

Colonnes du tableau :

  • Nom
  • ID
  • Description
  • Jeton de verrouillage
  • ARN
 Général

Tableau des cas d'utilisation

(si "Champ d'application" == "CloudFront" ou "Les deux")

Nom du tableau : Groupes de règles CloudFront

Colonnes du tableau :

  • Nom
  • ID
  • Description
  • Jeton de verrouillage
  • ARN
 Général

Supprimer un modèle de l'ensemble de modèles d'expression régulière

Supprimez des modèles de l'ensemble d'expressions régulières dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Noms des ensembles de modèles d'expression régulière CSV Oui Spécifiez la liste des noms d'ensembles d'expressions régulières, séparés par une virgule, par exemple name_1,name_2.
Patterns CSV Oui Spécifiez la liste des formats à supprimer de l'ensemble d'expressions régulières, séparés par une virgule, par exemple pattern_1,pattern_2.
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Champ d'application de l'ensemble. Si l'option "Les deux" est sélectionnée, l'action supprime les modèles des ensembles d'expressions régulières dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit et qu'au moins un ensemble de modèles a été supprimé d'un ensemble d'expressions régulières : "Successfully removed the following patterns from the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of entity patterns)

Si le modèle n'a jamais existé dans cet ensemble de modèles : "The following patterns were not found in the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of patterns)

Si la suppression de tous les modèles de tous les ensembles de modèles d'expressions régulières échoue : "Aucun modèle n'a été supprimé des ensembles de modèles d'expressions régulières fournis."

Si l'un des ensembles de motifs est introuvable : "Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of sets that were not found in that scope)

Si l'action ne parvient pas à trouver tous les ensembles de modèles d'expression régulière fournis dans le ou les champs d'application souhaités : "L'action n'a pas trouvé les ensembles de modèles d'expression régulière fournis."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale ou une erreur du SDK est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Remove Pattern From Regex Pattern Set". Reason: {0}''.format(error.Stacktrace)

 Général

Supprimer l'adresse IP de l'ensemble d'adresses IP

Supprimez les adresses IP de l'ensemble d'adresses IP dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Noms des ensembles d'IP CSV Oui Spécifiez la liste des noms d'ensembles d'adresses IP, séparés par une virgule. Exemple : nom_1,nom_2
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Spécifiez le champ d'application de l'ensemble d'adresses IP. Si l'option "Les deux" est sélectionnée, l'action supprimera les adresses IP des ensembles d'adresses IP dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.

Exécuter sur

Cette action s'exécute sur les entités d'adresse IP.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit et qu'au moins une adresse IP a été supprimée d'un ensemble d'adresses IP : "Successfully removed the following IPs from the {0} IP Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, entity.identifier list)

Si les adresses IP n'ont jamais existé dans cet ensemble d'adresses IP : "The following IPs were not a part of the {0} IP Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, entity.identifier list)

Si la suppression de toutes les entités de tous les ensembles d'adresses IP échoue : "Aucune adresse IP n'a été supprimée des ensembles d'adresses IP fournis."

Si l'un des ensembles d'adresses IP est introuvable : "Action wasn't able to find the following '{0}' IP Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

Si l'action ne trouve pas tous les ensembles d'adresses IP fournis dans le ou les champs d'application souhaités : "L'action n'a pas trouvé les ensembles d'adresses IP fournis."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale ou une erreur de SDK (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) est signalée : "Error executing action "Remove IP From IP Set". Reason: {0}''.format(error.Stacktrace)

 Général

Lister les ensembles de modèles d'expression régulière

Répertoriez les ensembles d'expressions régulières disponibles dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Spécifiez le champ d'application de la liste des ensembles d'adresses IP.
Nombre maximal d'ensembles de modèles d'expression régulière à renvoyer Integer 5 Non Spécifiez le nombre d'ensembles d'expressions régulières à renvoyer. La valeur par défaut est 5. La valeur maximale est de 10.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat JSON
[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
Mur des cas
Type de résultat Valeur/Description Type (Entité \ Général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si les ensembles d'expressions régulières disponibles ont bien été listés et que "Scope" == "Both" : "Successfully listed available Regex Pattern sets in Regional and Cloudfront scopes."

Si les jeux d'adresses IP disponibles ont bien été listés et que "Scope" == "Regional" : "Successfully listed available Regex Pattern sets in Regional scope."

Si les jeux d'adresses IP disponibles ont bien été listés et que "Scope" == "Cloudfront" : "Successfully listed available Regex Pattern sets in Cloudfront scope."

Si aucune valeur n'est disponible et que "Champ d'application" == "Les deux" : "Aucun ensemble de modèles d'expression régulière disponible n'a été trouvé dans les champs d'application régional et Cloudfront."

Si aucune valeur n'est disponible et que "Champ d'application" == "Régional" : "Aucun ensemble de modèles d'expression régulière disponible n'a été trouvé dans le champ d'application régional."

Si aucune valeur n'est disponible et que "Champ d'application" == "Cloudfront" : "Aucun ensemble de modèles d'expression régulière disponible n'a été trouvé dans le champ d'application Cloudfront."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale ou une erreur du SDK est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "List Regex Pattern Sets". Reason: {0}''.format(error.Stacktrace)

 Général

Tableau des cas d'utilisation

(si "Champ d'application" == "Régional" ou "Les deux")

Nom du tableau : Groupes de règles régionaux

Colonnes du tableau :

  • Nom
  • ID
  • Description
  • Jeton de verrouillage
  • ARN
 Général

Tableau des cas d'utilisation

(si "Champ d'application" == "CloudFront" ou "Les deux")

Nom du tableau : Groupes de règles CloudFront

Colonnes du tableau :

  • Nom
  • ID
  • Description
  • Jeton de verrouillage
  • ARN
 Général

Supprimer l'entité de l'ensemble de modèles d'expression régulière

Supprimez les modèles de chaîne basés sur des entités de l'ensemble d'expressions régulières dans AWS WAF.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Noms des ensembles de modèles d'expression régulière CSV Oui Spécifiez la liste des noms d'ensembles d'expressions régulières, séparés par une virgule, par exemple name_1,name_2.
Champ d'application LDD

CloudFront

Valeurs possibles :

  • CloudFront
  • Régional
  • Les deux
 Oui Champ d'application de l'ensemble. Si l'option "Les deux" est sélectionnée, l'action supprime les modèles basés sur des entités des ensembles d'expressions régulières dans les champs d'application Regional et CloudFront.

CloudFront est un champ d'application global pour les ressources utilisées avec Amazon CloudFront. Regional fait référence à la région AWS spécifique configurée dans le paramètre d'intégration AWS Default Region.
Modèle de domaine Case à cocher Vrai Non

Si cette option est activée, l'action récupère la partie domaine des URL et recherche une expression régulière basée sur celles-ci dans l'ensemble d'expressions régulières, par exemple http://test.com/folder devient ^(http|https)(:\/\/)(\Qtest.com\E).*.
Format d'adresse IP Case à cocher Vrai Non Si cette option est activée, l'action recherche une expression régulière à partir de l'adresse IP au lieu de la valeur brute, par exemple 10.0.0.1 devient ^(http|https)(:\/\/)(\Q10.0.1\E).*.

Exécuter sur

Cette action s'exécute sur les entités suivantes :

  • Adresse IP
  • URL

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type (Entité \ Général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit et qu'au moins une entité a été supprimée d'un ensemble d'adresses IP : "Successfully removed the following entity patterns from the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of entity patterns)

Si l'entité n'a jamais existé dans cet ensemble de modèles d'expression régulière : "The following patterns were not found in the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of entity patterns)

Si la suppression de toutes les entités de tous les ensembles d'adresses IP échoue : "Aucun modèle n'a été supprimé des ensembles de modèles d'expressions régulières fournis."

Si l'un des jeux d'adresses IP est introuvable : "Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

Si l'action ne parvient pas à trouver tous les ensembles de modèles d'expression régulière fournis dans le ou les champs d'application souhaités : "L'action n'a pas trouvé les ensembles de modèles d'expression régulière fournis."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale ou une erreur du SDK est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Remove Entity From Regex Pattern Set". Reason: {0}''.format(error.Stacktrace)

 Général

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.