AWS WAF Classic Regional exemples utilisant AWS CLI

PDF

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS WAF Classic Regional.

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 façon de configurer et d'exécuter le code en contexte.

Actions

associate-web-acl

L'exemple de code suivant montre comment utiliserassociate-web-acl.

AWS CLI

Pour associer une ACL Web à une ressource

La associate-web-acl commande suivante associe une ACL Web, spécifiée par le web-acl-id, à une ressource spécifiée par le resource-arn. L'ARN de la ressource peut faire référence à un équilibreur de charge d'application ou à une API Gateway :

aws waf-regional associate-web-acl \
    --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \
    --resource-arn 12cs345-67cd-890b-1cd2-c3a4567d89f1

Pour plus d'informations, consultez la section Travailler avec le Web ACLs dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous AssociateWebAclà la section Référence des AWS CLI commandes.

associate-web-acl

L'exemple de code suivant montre comment utiliserassociate-web-acl.

AWS CLI

Pour associer une ACL Web à une ressource

La associate-web-acl commande suivante associe une ACL Web, spécifiée par le web-acl-id, à une ressource spécifiée par le resource-arn. L'ARN de la ressource peut faire référence à un équilibreur de charge d'application ou à une API Gateway :

aws waf-regional associate-web-acl \
    --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \
    --resource-arn 12cs345-67cd-890b-1cd2-c3a4567d89f1

Pour plus d'informations, consultez la section Travailler avec le Web ACLs dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous AssociateWebAclà la section Référence des AWS CLI commandes.

put-logging-configuration

L'exemple de code suivant montre comment utiliserput-logging-configuration.

AWS CLI

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

L'put-logging-configurationexemple suivant montre la configuration de journalisation pour WAF avec ALB/ APIGateway dans Region. us-east-1

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

Sortie :

{
    "LoggingConfiguration": {
        "ResourceArn": "arn:aws:waf-regional:us-east-1: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, reportez-vous PutLoggingConfigurationà la section Référence des AWS CLI commandes.

put-logging-configuration

L'exemple de code suivant montre comment utiliserput-logging-configuration.

AWS CLI

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

L'put-logging-configurationexemple suivant montre la configuration de journalisation pour WAF avec ALB/ APIGateway dans Region. us-east-1

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

Sortie :

{
    "LoggingConfiguration": {
        "ResourceArn": "arn:aws:waf-regional:us-east-1: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, reportez-vous PutLoggingConfigurationà la section Référence des AWS CLI commandes.

update-byte-match-set

L'exemple de code suivant montre comment utiliserupdate-byte-match-set.

AWS CLI

Pour mettre à jour un jeu de correspondances d'octets

La update-byte-match-set commande suivante supprime un ByteMatchTuple objet (filtre) dans unByteMatchSet. Comme la updates valeur comporte des guillemets doubles, vous devez l'entourer de guillemets simples.

aws waf-regional 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 la section Travailler avec des conditions de correspondance de chaînes dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateByteMatchSetà la section Référence des AWS CLI commandes.

update-byte-match-set

L'exemple de code suivant montre comment utiliserupdate-byte-match-set.

AWS CLI

Pour mettre à jour un jeu de correspondances d'octets

La update-byte-match-set commande suivante supprime un ByteMatchTuple objet (filtre) dans unByteMatchSet. Comme la updates valeur comporte des guillemets doubles, vous devez l'entourer de guillemets simples.

aws waf-regional 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 la section Travailler avec des conditions de correspondance de chaînes dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateByteMatchSetà la section Référence des AWS CLI commandes.

update-ip-set

L'exemple de code suivant montre comment utiliserupdate-ip-set.

AWS CLI

Pour mettre à jour un ensemble d'adresses IP

La update-ip-set commande suivante met à jour une IPSet IPv4 adresse et la supprime. IPv6 Obtenez la valeur pour change-token en exécutant la get-change-token commande. Étant donné que la valeur des mises à jour inclut des guillemets doubles intégrés, vous devez l'entourer de guillemets simples.

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-regional update-ip-set \
    --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \
    --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1  \
    --updates file://change.json

Contenu du change.json

[
    {
        "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 la section Travailler avec les conditions de correspondance IP dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateIpSetà la section Référence des AWS CLI commandes.

update-ip-set

L'exemple de code suivant montre comment utiliserupdate-ip-set.

AWS CLI

Pour mettre à jour un ensemble d'adresses IP

La update-ip-set commande suivante met à jour une IPSet IPv4 adresse et la supprime. IPv6 Obtenez la valeur pour change-token en exécutant la get-change-token commande. Étant donné que la valeur des mises à jour inclut des guillemets doubles intégrés, vous devez l'entourer de guillemets simples.

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-regional update-ip-set \
    --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \
    --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1  \
    --updates file://change.json

Contenu du change.json

[
    {
        "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 la section Travailler avec les conditions de correspondance IP dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateIpSetà la section Référence des AWS CLI commandes.

update-rule

L'exemple de code suivant montre comment utiliserupdate-rule.

AWS CLI

Pour mettre à jour une règle

La update-rule commande suivante supprime un Predicate objet dans une règle. Comme la updates valeur comporte des guillemets doubles, vous devez entourer la valeur entière de guillemets simples.

aws waf-regional 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 la section Travailler avec des règles dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateRuleà la section Référence des AWS CLI commandes.

update-rule

L'exemple de code suivant montre comment utiliserupdate-rule.

AWS CLI

Pour mettre à jour une règle

La update-rule commande suivante supprime un Predicate objet dans une règle. Comme la updates valeur comporte des guillemets doubles, vous devez entourer la valeur entière de guillemets simples.

aws waf-regional 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 la section Travailler avec des règles dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateRuleà la section Référence des AWS CLI commandes.

update-size-constraint-set

L'exemple de code suivant montre comment utiliserupdate-size-constraint-set.

AWS CLI

Pour mettre à jour un ensemble de contraintes de taille

La update-size-constraint-set commande suivante supprime un objet SizeConstraint `(filtres) dans un ensemble de contraintes de taille. Comme la updates valeur contient des guillemets doubles intégrés, vous devez entourer la valeur entière de guillemets simples.

aws waf-regional 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 la section Travailler avec des conditions de contrainte de taille dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateSizeConstraintSetà la section Référence des AWS CLI commandes.

update-size-constraint-set

L'exemple de code suivant montre comment utiliserupdate-size-constraint-set.

AWS CLI

Pour mettre à jour un ensemble de contraintes de taille

La update-size-constraint-set commande suivante supprime un objet SizeConstraint `(filtres) dans un ensemble de contraintes de taille. Comme la updates valeur contient des guillemets doubles intégrés, vous devez entourer la valeur entière de guillemets simples.

aws waf-regional 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 la section Travailler avec des conditions de contrainte de taille dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateSizeConstraintSetà la section Référence des AWS CLI commandes.

update-sql-injection-match-set

L'exemple de code suivant montre comment utiliserupdate-sql-injection-match-set.

AWS CLI

Pour mettre à jour un ensemble de correspondances par injection SQL

La update-sql-injection-match-set commande suivante supprime un SqlInjectionMatchTuple objet (filtres) dans un jeu de correspondances par injection SQL. Comme la updates valeur contient des guillemets doubles intégrés, vous devez entourer la valeur entière de guillemets simples. :

aws waf-regional 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 », = {= {type="query_string "}, ="URL_DECODE"} 'SqlInjectionMatchTupleFieldToMatchTextTransformation

Pour plus d'informations, consultez la section Travailler avec des conditions de correspondance par injection SQL dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateSqlInjectionMatchSetà la section Référence des AWS CLI commandes.

update-sql-injection-match-set

L'exemple de code suivant montre comment utiliserupdate-sql-injection-match-set.

AWS CLI

Pour mettre à jour un ensemble de correspondances par injection SQL

La update-sql-injection-match-set commande suivante supprime un SqlInjectionMatchTuple objet (filtres) dans un jeu de correspondances par injection SQL. Comme la updates valeur contient des guillemets doubles intégrés, vous devez entourer la valeur entière de guillemets simples. :

aws waf-regional 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 », = {= {type="query_string "}, ="URL_DECODE"} 'SqlInjectionMatchTupleFieldToMatchTextTransformation

Pour plus d'informations, consultez la section Travailler avec des conditions de correspondance par injection SQL dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateSqlInjectionMatchSetà la section Référence des AWS CLI commandes.

update-web-acl

L'exemple de code suivant montre comment utiliserupdate-web-acl.

AWS CLI

Pour mettre à jour une ACL Web

La update-web-acl commande suivante supprime un ActivatedRule objet dans un WebACL. Comme la updates valeur contient des guillemets doubles intégrés, vous devez entourer la valeur entière de guillemets simples.

aws waf-regional 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="ALLOW"}'

Pour plus d'informations, consultez la section Travailler avec le Web ACLs dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateWebAclà la section Référence des AWS CLI commandes.

update-web-acl

L'exemple de code suivant montre comment utiliserupdate-web-acl.

AWS CLI

Pour mettre à jour une ACL Web

La update-web-acl commande suivante supprime un ActivatedRule objet dans un WebACL. Comme la updates valeur contient des guillemets doubles intégrés, vous devez entourer la valeur entière de guillemets simples.

aws waf-regional 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="ALLOW"}'

Pour plus d'informations, consultez la section Travailler avec le Web ACLs dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateWebAclà la section Référence des AWS CLI commandes.

update-xss-match-set

L'exemple de code suivant montre comment utiliserupdate-xss-match-set.

AWS CLI

Pour mettre à jour un XSSMatch ensemble

La update-xss-match-set commande suivante supprime un XssMatchTuple objet (filtres) dans unXssMatchSet. Comme la updates valeur contient des guillemets doubles intégrés, vous devez entourer la valeur entière de guillemets simples.

aws waf-regional 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 la section Travailler avec les conditions de correspondance des scripts intersites dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateXssMatchSetà la section Référence des AWS CLI commandes.

update-xss-match-set

L'exemple de code suivant montre comment utiliserupdate-xss-match-set.

AWS CLI

Pour mettre à jour un XSSMatch ensemble

La update-xss-match-set commande suivante supprime un XssMatchTuple objet (filtres) dans unXssMatchSet. Comme la updates valeur contient des guillemets doubles intégrés, vous devez entourer la valeur entière de guillemets simples.

aws waf-regional 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 la section Travailler avec les conditions de correspondance des scripts intersites dans le guide du développeur AWS WAF.

• Pour plus de détails sur l'API, reportez-vous UpdateXssMatchSetà la section Référence des AWS CLI commandes.