Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
SE APLICA A: todos los niveles de API Management
En este artículo se muestra cómo configurar directivas en la instancia de API Management mediante la edición de definiciones de directiva en Azure Portal. Cada definición de directiva es un documento XML que describe una secuencia de instrucciones entrantes y salientes que se ejecutan secuencialmente en una solicitud y respuesta de API.
El editor de directivas del portal proporciona formularios guiados para que los editores de API agreguen y editen directivas en las definiciones de directiva. También puede editar el XML directamente en el editor de código de directiva.
Más información sobre las directivas:
- Información general de políticas
- Referencia de políticas para una lista completa de declaraciones de políticas y sus configuraciones
- Repositorio de fragmentos de código de directiva
- Conjunto de políticas de Azure API Management
- Creación de directivas mediante Microsoft Copilot en Azure
Requisitos previos
Si aún no tiene una instancia de API Management y una API de back-end, consulte:
Vaya a la instancia de API Management.
En Azure Portal, busque y seleccione Servicios de API Management:
En la página Servicios de API Management , seleccione la instancia de API Management:
Configuración de la directiva en el portal
En el ejemplo siguiente se muestra cómo configurar una directiva con dos opciones en el editor de directivas del portal:
- Un editor guiado basado en formularios para simplificar la configuración de muchas directivas.
- Un editor de código donde puede agregar o editar XML directamente.
En este ejemplo, la directiva filtra las solicitudes de determinadas direcciones IP entrantes. Se limita a una API seleccionada.
Nota
Puede configurar directivas en otros ámbitos; por ejemplo, para todas las API, para un producto o para una sola operación de API. Consulte Configuración del ámbito, más adelante en este artículo, para obtener otros ejemplos.
Para configurar una directiva:
En el panel de navegación izquierdo de la instancia de API Management, seleccione API.
Seleccione una API que haya importado anteriormente.
Seleccione la pestaña Diseño.
Para aplicar la directiva a todas las operaciones, seleccione Todas las operaciones.
En la sección Procesamiento de entrada, seleccione + Agregar directiva.
En Agregar directiva de entrada, seleccione la directiva que quiere agregar. Por ejemplo, seleccione Filtrar direcciones IP.
Sugerencia
- Las directivas que se muestran se limitan a la sección de directivas que está configurando; en este caso, el procesamiento de entrada.
- Si no ve la directiva que quiere usar, seleccione el icono Otras directivas. Se abrirá el editor de código XML y se mostrará una lista completa de directivas para esa sección y ámbito.
Seleccione Ip permitidas>+ Agregar filtro de IP y agregue las primeras y últimas direcciones IP de un intervalo de direcciones entrantes que pueden realizar solicitudes de API. Agregue otros intervalos de direcciones IP, si es necesario.
Seleccione Guardar para propagar los cambios a la puerta de enlace de API Management inmediatamente.
La directiva de ip-filter aparece ahora en la sección Procesamiento de entrada.
Configura las directivas en diferentes ámbitos
API Management ofrece flexibilidad para configurar definiciones de directiva en varios ámbitos, en cada una de las secciones de directiva.
Importante
No todas las directivas se pueden aplicar en cada ámbito o sección de directivas. Si la directiva que desea agregar no está habilitada, asegúrese de que se encuentra en una sección y un ámbito compatibles y adecuados para esa directiva. Para revisar las secciones y los ámbitos de una directiva, compruebe la sección Uso en los temas de referencia de directivas.
Nota
La sección Directiva de back-end solo puede contener un elemento de directiva. De forma predeterminada, API Management configura la directiva forward-request
en la sección Back-end en el ámbito global y el elemento base
en otros ámbitos.
Ámbito global
El ámbito global se configura para Todas las API de la instancia de API Management.
En el panel de navegación izquierdo de la instancia de API Management, seleccione API>Todas las API.
Seleccione la pestaña Diseño.
En una sección de la directiva, seleccione + Agregar directiva para usar un editor de directivas basado en formularios o seleccione el icono </> (editor de código) para agregar y editar XML directamente.
Seleccione Guardar para propagar los cambios a la puerta de enlace de API Management inmediatamente.
Ámbito del producto
El ámbito del producto está configurado para el producto seleccionado.
En el menú de la izquierda, seleccione Productos y, a continuación, seleccione un producto al que quiera aplicar directivas.
En la ventana del producto, seleccione Directivas.
En una sección de la directiva, seleccione + Agregar directiva para usar un editor de directivas basado en formularios o seleccione el icono </> (editor de código) para agregar y editar XML directamente.
Seleccione Guardar para propagar los cambios a la puerta de enlace de API Management inmediatamente.
Ámbito de la API
El ámbito de la API está configurado para todas las operaciones de la API seleccionada.
En el panel de navegación izquierdo de la instancia de API Management, seleccione API y, a continuación, seleccione la API a la que quiera aplicar directivas.
Seleccione la pestaña Diseño.
Seleccione Todas las operaciones.
En una sección de la directiva, seleccione + Agregar directiva para usar un editor de directivas basado en formularios o seleccione el icono </> (editor de código) para agregar y editar XML directamente.
Seleccione Guardar para propagar los cambios a la puerta de enlace de API Management inmediatamente.
Ámbito de la operación
El ámbito de la operación está configurado para la operación de API seleccionada.
En el panel de navegación izquierdo de la instancia de API Management, seleccione API.
Seleccione la pestaña Diseño.
Seleccione la operación en la que quiere aplicar directivas.
En una sección de la directiva, seleccione + Agregar directiva para usar un editor de directivas basado en formularios o seleccione el icono </> (editor de código) para agregar y editar XML directamente.
Seleccione Guardar para propagar los cambios a la puerta de enlace de API Management inmediatamente.
Reutilización de configuraciones de directivas
Puede crear fragmentos de directiva reutilizables en la instancia de API Management. Los fragmentos de directiva son elementos XML que contienen las configuraciones de una o varias directivas. Fragmentos de directivas ayudan a configurar las políticas de forma coherente y a mantener las definiciones de directiva sin necesidad de repetir o volver a escribir código XML.
Use la directiva include-fragment
para insertar un fragmento de directiva en una definición de directiva.
Uso del elemento base
para establecer el orden de evaluación de directivas
Si configura definiciones de directiva en más de un ámbito, se pueden aplicar varias directivas a una solicitud o respuesta de API. Dependiendo del orden en que se apliquen las directivas de los distintos ámbitos, la transformación de la solicitud o respuesta podría ser diferente.
En API Management, determine el orden de evaluación de directivas colocando el elemento base
en cada sección de la definición de directiva en cada ámbito. El elemento base
hereda las directivas configuradas en esa sección en el siguiente ámbito más amplio (primario). El elemento base
se incluye de forma predeterminada en cada sección de directiva.
Nota
Para ver las políticas efectivas en el ámbito actual, seleccione Calcular política efectiva en el editor de políticas.
Para modificar el orden de evaluación de directivas mediante el editor de directivas:
Comience con la definición en el ámbito más estrecho que configuró, y que API Management aplicará primero.
Por ejemplo, al usar definiciones de directiva configuradas en el ámbito global y el ámbito de la API, comience con la configuración en el ámbito de la API.
Coloque el elemento
base
dentro de una sección para determinar dónde se heredarán todas las directivas de la sección correspondiente en el ámbito primario.Por ejemplo, en una sección
inbound
configurada en el ámbito de la API, coloque un elementobase
para controlar dónde heredar las directivas configuradas en la seccióninbound
en el ámbito global. En el ejemplo siguiente, las directivas heredadas del ámbito global se aplican antes de la directivaip-filter
.<policies> <inbound> <base /> <ip-filter action="allow"> <address>10.100.7.1</address> </ip-filter> </inbound> [...] </policies>
Nota
- Puede colocar el elemento
base
antes o después de cualquier elemento de directiva en una sección. - Si quiere evitar la herencia de directivas del ámbito primario, quite el elemento
base
. En la mayoría de los casos, esto no se recomienda. Sin embargo, puede ser útil en ciertas situaciones, como cuando desea aplicar directivas diferentes a una operación específica en lugar de las configuradas para el ámbito de la API (todas las operaciones).
- Puede colocar el elemento
Siga configurando el elemento
base
en las definiciones de políticas en los ámbitos que sean sucesivamente más amplios.Una directiva de ámbito global no tiene un ámbito principal y el uso del elemento
base
no tiene ningún efecto.
Obtener ayuda de Copilot
Puede obtener ayuda de inteligencia artificial de Copilot para crear y editar las definiciones de directivas de API Management. Puede usar Copilot para crear y actualizar directivas que coincidan con sus requisitos específicos sin necesidad de conocer la sintaxis XML. También puede obtener explicaciones de las directivas existentes. Y Copilot puede ayudarle a traducir las directivas que podría haber configurado en otras soluciones de API Management.
- Microsoft Copilot en Azure proporciona ayuda para la creación de directivas con avisos de lenguaje natural en Azure Portal. Puede crear directivas en el editor de directivas de API Management y pedir a Copilot que explique las secciones de directivas.
- GitHub Copilot para Azure en Visual Studio Code proporciona asistencia para la creación de directivas en Visual Studio Code y puede usar la extensión de Azure API Management para Visual Studio Code para acelerar la configuración de directivas. Puede utilizar Copilot Chat o Copilot Edits con lenguaje natural para crear y refinar directamente las definiciones de directivas.
Mensaje de ejemplo:
Generate a policy that adds an Authorization header to the request with a Bearer token.
Copilot se basa en la inteligencia artificial, por lo que son posibles sorpresas y errores. Para obtener más información, consulte Preguntas más frecuentes sobre el uso general de Copilot.
Contenido relacionado
Para obtener más información sobre el trabajo con directivas, vea:
- Tutorial: Transformación y protección de una API
- Referencia de políticas para una lista completa de declaraciones de políticas y sus configuraciones
- Expresiones de política
- Establecimiento o edición de directivas
- Reutilización de configuraciones de directivas
- Repositorio de fragmentos de código de directiva
- Repositorio de área de juegos de directivas
- Conjunto de políticas de Azure API Management
- Obtener ayuda de Copilot para crear, explicar y solucionar problemas de directivas