Configurar la inserción de encabezados HTTP para patrones de dirección URL específicos

Esta directiva permite definir reglas que insertan encabezados HTTP personalizados en solicitudes web que coinciden con patrones de dirección URL específicos. Los encabezados insertados por esta directiva tienen prioridad sobre los encabezados que ya están presentes en la solicitud y sobre las modificaciones realizadas por usuarios o extensiones.

Un caso de uso común de esta directiva es aplicar controles de acceso de inquilino mediante la inserción de encabezados personalizados (por ejemplo, X-Tenant-ID).

La directiva acepta una lista de reglas. Cada regla contiene:

* patterns: una lista de patrones de dirección URL que se usarán para buscar coincidencias. Para obtener información sobre el formato de los patrones de dirección URL, consulte https://go.microsoft.com/fwlink/?linkid=2095322.

* headers: una lista de objetos de encabezado que se van a insertar. Cada objeto contiene:

* name: el nombre del encabezado que se va a insertar.

* value: el valor del encabezado que se va a insertar.

Si varias reglas coinciden con una solicitud, se aplican los encabezados de todas las reglas coincidentes. Si varias reglas coincidentes especifican el mismo nombre de encabezado, se aplica el encabezado del patrón de dirección URL más específico. Si varios patrones coincidentes son igual de específicos, se aplica el encabezado de la regla que aparece en último lugar en la lista.

Los nombres de encabezado deben cumplir la RFC 2616 (https://www.rfc-editor.org/rfc/rfc2616). Los valores de encabezado no deben contener los caracteres NUL, CR ni LF. Los encabezados individuales no pueden superar los 8 KB. Se omiten los encabezados y patrones de dirección URL no válidos.

Esta directiva admite un máximo de 500 patrones de dirección URL entre todas las reglas. Cada regla puede contener hasta 20 encabezados. Se omiten los patrones de dirección URL y los encabezados que superan estos límites.

Valor de ejemplo:

[
{
"patterns": [
"example.com",
".example.org"
],
"headers": [
{
"name": "X-Tenant-ID",
"value": "123456"
},
{
"name": "X-Custom-Header",
"value": "CustomValue"
}
]
}
]