Compartir vía


Tutorial: Configuración del motor de reglas

En este tutorial se indica cómo crear una configuración del motor de reglas y la primera regla en Azure Portal y la CLI.

En este tutorial, aprenderá a:

  • Configurar el motor de reglas mediante el portal.
  • Configure el motor de reglas mediante la CLI de Azure.

Requisitos previos

Configuración del motor de reglas en Azure Portal

  1. En el recurso de Azure Front Door (clásico), seleccione Configuración del motor de reglas en Configuración en el panel de menús del lado izquierdo. Seleccione + Agregar, asigne un nombre a la configuración y empiece a crear la primera configuración del motor de reglas.

    Recorte de pantalla de la configuración del motor de reglas de la página de información general de Azure Front Door.

  2. Escriba un nombre para la primera regla. Luego, seleccione + Agregar condición o + Agregar acción para definir la regla.

    Nota:

    • Para eliminar una condición o una acción de una regla, use el icono de papelera en el lado derecho de la condición o acción específicas.
    • Para crear una regla que se aplique a todo el tráfico entrante, no especifique ninguna condición.
    • Para detener la evaluación de reglas una vez que se cumpla la primera condición de coincidencia, marque Detener la evaluación de las reglas restantes. Si se ha activado esta opción y se cumplen todas las condiciones de coincidencia de una regla en particular, el resto de reglas de la configuración no se ejecutará.
    • Todas las rutas de acceso de la configuración del motor de reglas distinguen entre mayúsculas y minúsculas.
    • Los nombres de encabezado deben cumplir RFC 7230.

    Captura de pantalla de la página de configuración del motor de regla con una única regla.

  3. Para determinar la prioridad de las reglas de configuración, use los botones Mover hacia arriba, Mover hacia abajo y Mover a la parte superior. La prioridad está en orden ascendente, lo que significa que la regla que aparece en primer lugar es la regla más importante.

    Sugerencia

    Si desea comprobar cuándo se propagan los cambios a Azure Front Door (clásico), puede crear un encabezado de respuesta personalizado en la regla mediante el ejemplo siguiente. Puede agregar un encabezado de respuesta _X-<RuleName>-Version_ y cambiar el valor cada vez que se actualice la regla de tiempo.

    Captura de pantalla de la regla de encabezado de versión personalizado. Una vez actualizados los cambios, puede ir a la dirección URL para confirmar la versión de la regla que se va a invocar: Captura de pantalla de la salida de la versión del encabezado.

  4. Una vez creadas una o varias reglas, seleccione Guardar. Esta acción crea la configuración del motor de reglas.

  5. Una vez creada una configuración del motor de reglas, puede asociar la configuración a una regla de enrutamiento. Una única configuración se puede aplicar a varias reglas de enrutamiento, pero una regla de enrutamiento solo puede tener una configuración del motor de reglas. Para asociar la configuración, vaya al Diseñador de Azure Front Door (clásico) y seleccione una Ruta. A continuación, seleccione la Configuración del motor de reglas que se va a asociar a la regla de enrutamiento.

    Captura de pantalla de la asociación de la configuración del motor de reglas de la página de regla de enrutamiento.

Configuración del motor de reglas en la CLI de Azure

  1. Instale la CLI de Azure y agregue la extensión "front-door":

    az extension add --name front-door
    

    Inicie sesión y cambie a su suscripción:

    az account set --subscription <name_or_Id>
    
  2. Cree un motor de reglas con una regla, incluida una acción basada en encabezados y una condición de coincidencia:

    az network front-door rules-engine rule create -f {front_door} -g {resource_group} --rules-engine-name {rules_engine} --name {rule1} --priority 1 --action-type RequestHeader --header-action Overwrite --header-name Rewrite --header-value True --match-variable RequestFilenameExtension --operator Contains --match-values jpg png --transforms Lowercase
    
  3. Enumere todas las reglas:

    az network front-door rules-engine rule list -f {front_door} -g {rg} --name {rules_engine}
    
  4. Agregue una acción de invalidación del enrutamiento de reenvío:

    az network front-door rules-engine rule action add -f {front_door} -g {rg} --rules-engine-name {rules_engine} --name {rule1} --action-type ForwardRouteOverride --backend-pool {backend_pool_name} --caching Disabled
    
  5. Enumere todas las acciones de una regla:

    az network front-door rules-engine rule action list -f {front_door} -g {rg} -r {rules_engine} --name {rule1}
    
  6. Vincule una configuración del motor de reglas a una regla de enrutamiento:

    az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --rules-engine {rules_engine}
    
  7. Desvincule el motor de reglas:

    az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --remove rulesEngine
    

Para obtener más información, consulte la lista completa de comandos del motor de reglas de Azure Front Door (clásico).

Limpieza de recursos

Para quitar la configuración del motor de reglas de Front Door (clásico):

  1. Desasocie las reglas de enrutamiento de la configuración del motor de reglas seleccionando los tres puntos junto al nombre del motor de reglas y seleccionando Asociar regla de enrutamiento:

    Captura de pantalla de la asociación de las reglas de enrutamiento a partir del menú.

  2. Desactive todas las reglas de enrutamiento asociadas a esta configuración del motor de reglas y seleccione Guardar:

    Asociación de la regla de enrutamiento

  3. Elimine la configuración del motor de reglas de Front Door:

    Eliminación de la configuración del motor de reglas

Pasos siguientes

En este tutorial, ha aprendido a:

  • Crear una configuración del motor de reglas
  • Asocie una configuración a una regla de enrutamiento.

Para obtener información sobre cómo agregar encabezados de seguridad con el motor de reglas, continúe con el siguiente tutorial.