D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples
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.
AWS WAF Classic Regional exemples utilisant AWS CLI
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.
Rubriques
Actions
L'exemple de code suivant montre comment utiliserassociate-web-acl.
- AWS CLI
-
Pour associer une ACL Web à une ressource
La
associate-web-aclcommande 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-ida123fae4-b567-8e90-1234-5ab67ac8ca90\ --resource-arn12cs345-67cd-890b-1cd2-c3a4567d89f1Pour 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.
-
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 affiche la configuration de journalisation pour WAF ALB/APIGateway dans Region.us-east-1aws waf-regional put-logging-configuration \ --logging-configurationResourceArn=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=[]\ --regionus-east-1Sortie :
{ "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.
-
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-setcommande suivante supprime unByteMatchTupleobjet (filtre) dans unByteMatchSet. Comme laupdatesvaleur comporte des guillemets doubles, vous devez l'entourer de guillemets simples.aws waf-regional update-byte-match-set \ --byte-match-set-ida123fae4-b567-8e90-1234-5ab67ac8ca90\ --change-token12cs345-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.
-
L'exemple de code suivant montre comment utiliserupdate-ip-set.
- AWS CLI
-
Pour mettre à jour un ensemble d'adresses IP
La
update-ip-setcommande suivante met à jour une IPSet IPv4 adresse et la supprime. IPv6 Obtenez la valeur pourchange-tokenen exécutant laget-change-tokencommande. Comme 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-ida123fae4-b567-8e90-1234-5ab67ac8ca90\ --change-token12cs345-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-ida123fae4-b567-8e90-1234-5ab67ac8ca90\ --change-token12cs345-67cd-890b-1cd2-c3a4567d89f1\ --updatesfile://change.jsonContenu 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.
-
L'exemple de code suivant montre comment utiliserupdate-rule.
- AWS CLI
-
Pour mettre à jour une règle
La
update-rulecommande suivante supprime unPredicateobjet dans une règle. Comme laupdatesvaleur comporte des guillemets doubles, vous devez entourer la valeur entière de guillemets simples.aws waf-regional update-rule \ --rule-ida123fae4-b567-8e90-1234-5ab67ac8ca90\ --change-token12cs345-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.
-
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-setcommande suivante supprime un objet SizeConstraint `(filtres) dans un ensemble de contraintes de taille. Comme laupdatesvaleur 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-ida123fae4-b567-8e90-1234-5ab67ac8ca90\ --change-token12cs345-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.
-
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-setcommande suivante supprime unSqlInjectionMatchTupleobjet (filtres) dans un jeu de correspondances par injection SQL. Comme laupdatesvaleur contient des guillemets doubles incorporé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.
-
L'exemple de code suivant montre comment utiliserupdate-web-acl.
- AWS CLI
-
Pour mettre à jour une ACL Web
La
update-web-aclcommande suivante supprime unActivatedRuleobjet dans un WebACL. Comme laupdatesvaleur contient des guillemets doubles incorporés, vous devez entourer la valeur entière de guillemets simples.aws waf-regional update-web-acl \ --web-acl-ida123fae4-b567-8e90-1234-5ab67ac8ca90\ --change-token12cs345-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.
-
L'exemple de code suivant montre comment utiliserupdate-xss-match-set.
- AWS CLI
-
Pour mettre à jour un XSSMatch ensemble
La
update-xss-match-setcommande suivante supprime unXssMatchTupleobjet (filtres) dans unXssMatchSet. Comme laupdatesvaleur 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-ida123fae4-b567-8e90-1234-5ab67ac8ca90\ --change-token12cs345-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.
-