Exemples d’utilisation de l’AWS CLI avec AWS WAF Classic - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec AWS WAF Classic

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec AWS WAF Classic.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser put-logging-configuration.

AWS CLI

Pour créer une configuration de journalisation pour l’ARN ACL Web avec l’ARN du flux Firehose de Kinesis spécifié

L’exemple put-logging-configuration suivant montre la configuration de journalisation pour WAF avec CloudFront.

aws waf put-logging-configuration \
    --logging-configuration ResourceArn=arn:aws:waf::123456789012:webacl/3bffd3ed-fa2e-445e-869f-a6a7cf153fd3,LogDestinationConfigs=arn:aws:firehose:us-east-1:123456789012:deliverystream/aws-waf-logs-firehose-stream,RedactedFields=[]

Sortie :

{
    "LoggingConfiguration": {
        "ResourceArn": "arn:aws:waf::123456789012:webacl/3bffd3ed-fa2e-445e-869f-a6a7cf153fd3",
        "LogDestinationConfigs": [
            "arn:aws:firehose:us-east-1:123456789012:deliverystream/aws-waf-logs-firehose-stream"
        ]
    }
}

  • Pour plus de détails sur l’API, consultez PutLoggingConfiguration dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-byte-match-set.

AWS CLI

Pour mettre à jour un jeu de correspondance d’octets

La commande update-byte-match-set suivante supprime un objet ByteMatchTuple (filtre) dans un ByteMatchSet :

aws waf update-byte-match-set --byte-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",ByteMatchTuple={FieldToMatch={Type="HEADER",Data="referer"},TargetString="badrefer1",TextTransformation="NONE",PositionalConstraint="CONTAINS"}

Pour plus d’informations, consultez Utilisation des conditions de correspondance de chaîne dans le Manuel du développeur AWS WAF.

  • Pour plus de détails sur l’API, consultez UpdateByteMatchSet dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-ip-set.

AWS CLI

Pour mettre à jour un ensemble d’adresses IP

La commande update-ip-set suivante met à jour un IPSet avec une adresse IPv4 et supprime une adresse IPv6 :

aws waf update-ip-set --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="INSERT",IPSetDescriptor={Type="IPV4",Value="12.34.56.78/16"},Action="DELETE",IPSetDescriptor={Type="IPV6",Value="1111:0000:0000:0000:0000:0000:0000:0111/128"}

Vous pouvez également utiliser un fichier JSON pour spécifier l’entrée. Par exemple :

aws waf update-ip-set --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1  --updates file://change.json

Où le contenu du fichier JSON est :

[
{
"Action": "INSERT",
"IPSetDescriptor":
{
"Type": "IPV4",
"Value": "12.34.56.78/16"
}
},
{
"Action": "DELETE",
"IPSetDescriptor":
{
"Type": "IPV6",
"Value": "1111:0000:0000:0000:0000:0000:0000:0111/128"
}
}
]

Pour plus d’informations, consultez Utilisation des conditions de correspondance IP dans le Manuel du développeur AWS WAF.

  • Pour plus de détails sur l’API, consultez UpdateIpSet dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-rule.

AWS CLI

Pour mettre à jour une règle

La commande update-rule suivante supprime un objet Predicate dans une règle :

aws waf update-rule --rule-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",Predicate={Negated=false,Type="ByteMatch",DataId="MyByteMatchSetID"}

Pour plus d’informations, consultez Utilisation des règles dans le Manuel du développeur AWS WAF.

  • Pour plus de détails sur l’API, consultez UpdateRule dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-size-constraint-set.

AWS CLI

Pour mettre à jour un jeu de contraintes de taille

La commande update-size-constraint-set suivante supprime un objet SizeConstraint (filtres) dans un jeu de contraintes de taille :

aws waf update-size-constraint-set --size-constraint-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",SizeConstraint={FieldToMatch={Type="QUERY_STRING"},TextTransformation="NONE",ComparisonOperator="GT",Size=0}

Pour plus d’informations, consultez Utilisation des conditions de contrainte de taille dans le Manuel du développeur AWS WAF.

  • Pour plus de détails sur l’API, consultez UpdateSizeConstraintSet dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-sql-injection-match-set.

AWS CLI

Pour mettre à jour un jeu de correspondance d’injection SQL

La commande update-sql-injection-match-set suivante supprime un objet SqlInjectionMatchTuple (filtres) dans un jeu de correspondance d’injection SQL :

aws waf update-sql-injection-match-set --sql-injection-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",SqlInjectionMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"}

Pour plus d’informations, consultez Utilisation des conditions de correspondance d’injection SQL dans le Manuel du développeur AWS WAF.

L’exemple de code suivant montre comment utiliser update-web-acl.

AWS CLI

Pour mettre à jour une liste ACL web

La commande update-web-acl suivante supprime un objet ActivatedRule d’une liste ACL web.

aws waf update-web-acl --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",ActivatedRule=’{Priority=1,RuleId="WAFRule-1-Example",Action={Type="ALLOW"},Type="REGULAR"}’

Sortie :

{
    "ChangeToken": "12cs345-67cd-890b-1cd2-c3a4567d89f1"
}

Pour plus d’informations, consultez Utilisation des listes ACL web dans le Manuel du développeur AWS WAF, AWS Firewall Manager et AWS Shield Advanced.

  • Pour plus de détails sur l’API, consultez UpdateWebAcl dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-xss-match-set.

AWS CLI

Pour mettre à jour un XSSMatchSet

La commande update-xss-match-set suivante supprime un objet XssMatchTuple (filtres) dans un XssMatchSet :

aws waf update-xss-match-set --xss-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",XssMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"}

Pour plus d’informations, consultez Utilisation des conditions de correspondance de scripts inter-site dans le Manuel du développeur AWS WAF.

  • Pour plus de détails sur l’API, consultez UpdateXssMatchSet dans la Référence des commandes de l’AWS CLI.