En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con AWS WAF Classic.
Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar put-logging-configuration.
- AWS CLI
-
Para crear una configuración de registro para el ARN de ACL web con el ARN de flujo de Kinesis Firehose especificado
En el siguiente ejemplo de
put-logging-configuration, se muestra la configuración de registro para WAF con CloudFront.aws waf put-logging-configuration \ --logging-configurationResourceArn=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=[]Salida:
{ "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" ] } }-
Para obtener información sobre la API, consulte PutLoggingConfiguration
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-byte-match-set.
- AWS CLI
-
Para actualizar un conjunto de coincidencias de bytes
El siguiente comando
update-byte-match-setelimina un objeto ByteMatchTuple (filtro) de un ByteMatchSet:aws waf 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"}Para obtener más información, consulte Trabajar con condiciones de coincidencia de cadena en la Guía para desarrolladores de AWS WAF.
-
Para obtener información acerca de la API, consulte UpdateByteMatchSet
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-ip-set.
- AWS CLI
-
Para actualizar un conjunto de IP
El siguiente comando
update-ip-setactualiza un IPSet con una dirección IPv4 y elimina una dirección IPv6: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"}Como alternativa, puede utilizar un archivo JSON para especificar la entrada. Por ejemplo:
aws waf update-ip-set --ip-set-ida123fae4-b567-8e90-1234-5ab67ac8ca90--change-token12cs345-67cd-890b-1cd2-c3a4567d89f1--updatesfile://change.jsonEste es el contenido del archivo 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" } } ]Para obtener más información, consulte Trabajar con condiciones de coincidencia de IP en la Guía para desarrolladores de AWS WAF.
-
Para obtener información sobre la API, consulte UpdateIpSet
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-rule.
- AWS CLI
-
Para actualizar una regla
El siguiente comando
update-ruleelimina un objeto Predicate de una regla:aws waf update-rule --rule-ida123fae4-b567-8e90-1234-5ab67ac8ca90--change-token12cs345-67cd-890b-1cd2-c3a4567d89f1--updates Action="DELETE",Predicate={Negated=false,Type="ByteMatch",DataId="MyByteMatchSetID"}Para obtener más información, consulte Trabajar con reglas en la Guía para desarrolladores de AWS WAF.
-
Para obtener información sobre la API, consulte UpdateRule
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-size-constraint-set.
- AWS CLI
-
Para actualizar un conjunto de restricciones de tamaño
El siguiente comando
update-size-constraint-setelimina un objeto SizeConstraint (filtros) de un conjunto de restricciones de tamaño:aws waf 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}Para obtener más información, consulte Trabajar con condiciones de restricción de tamaño en la Guía para desarrolladores de AWS WAF.
-
Para obtener información sobre la API, consulte UpdateSizeConstraintSet
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-sql-injection-match-set.
- AWS CLI
-
Para actualizar un conjunto de coincidencias de inyección de código SQL
El siguiente comando
update-sql-injection-match-setelimina un objeto SqlInjectionMatchTuple (filtros) de un conjunto de coincidencias de inyección de código SQL:aws waf update-sql-injection-match-set --sql-injection-match-set-ida123fae4-b567-8e90-1234-5ab67ac8ca90--change-token12cs345-67cd-890b-1cd2-c3a4567d89f1--updates Action="DELETE",SqlInjectionMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"}Para obtener más información, consulte Trabajar con condiciones de coincidencia de inyección de código SQL en la Guía para desarrolladores de AWS WAF.
-
Para obtener información sobre la API, consulte UpdateSqlInjectionMatchSet
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-web-acl.
- AWS CLI
-
Para actualizar una ACL web
El siguiente comando
update-web-aclelimina un objetoActivatedRulede una WebACL.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"}'
Salida:
{ "ChangeToken": "12cs345-67cd-890b-1cd2-c3a4567d89f1" }Para obtener más información, consulte Trabajar con ACL web en la Guía para desarrolladores de AWS WAF, AWS Firewall Manager y AWS Shield Avanzado.
-
Para obtener información sobre la API, consulte UpdateWebAcl
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-xss-match-set.
- AWS CLI
-
Para actualizar un XSSMatchSet
El siguiente comando
update-xss-match-setelimina un objeto XssMatchTuple (filtros) de un XssMatchSet:aws waf 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"}Para obtener más información, consulte Trabajar con condiciones de coincidencia de scripting entre sitios en la Guía para desarrolladores de AWS WAF.
-
Para obtener información sobre la API, consulte UpdateXssMatchSet
en la Referencia de comandos de la AWS CLI.
-
