Referencia de la propiedad del host virtual

Especifica el nombre del host virtual. Usarás ese nombre para hacer referencia al host virtual cuando configures un proxy de API.

Los caracteres que puedes utilizar en el atributo de nombre están restringidos a: A-Z0-9._\-$%.

Especifica el número de puerto que usa el host virtual. Asegúrate de que el puerto esté abierto en el router de borde.

Si especificas un puerto en un elemento hostalias, el número de puerto especificadas por <Port> debe coincidir.

Para Cloud: Debes especificar el puerto 443 cuando crees un host virtual. Si se omite, el puerto se establece en 443 de forma predeterminada. Si tienes un host virtual existente que usa un puerto que no es el 443, no puedes cambiarlo.

Para las versiones 4.16.01 a 4.17.05 de Private Cloud: Cuando creas un host virtual, debes especificar el puerto del router que usa el host virtual. Por ejemplo, el puerto 9,001. De forma predeterminada, el router se ejecuta como el usuario "apigee", que no tiene acceso a los puertos con privilegios, por lo general, los puertos 1024 y anteriores. Si deseas crear un host virtual que vincule el router a un puerto protegido, debes configurar el router para que se ejecute como un usuario con acceso a esos puertos. Consulta Configurar un host virtual para más.

Para versiones de nube privada anteriores a 4.16.01: un router puede escuchar solo una conexión HTTPS por host virtual, en un puerto específico, con el certificado especificado. Por lo tanto, varios hosts virtuales no pueden usar el mismo número de puerto si la terminación de TLS en el router en el puerto especificado.

El valor de BaseUrl debe incluir el protocolo (es decir, “http://” o “https://”).

Un cliente de OCSP (protocolo de estado de certificado en línea) envía un estado a una respuesta OCSP para determinar si el certificado TLS es válido. La respuesta indica si el certificado TLS es válido y no se revocó.

Cuando está habilitado, el engrapado OCSP permite Edge, ya que actúa como servidor TLS para TLS unidireccional. para consultar la respuesta de OCSP directamente y luego almacenar en caché la respuesta. Luego, Edge muestra esta respuesta al cliente de TLS o la fija como parte del protocolo de enlace de TLS. Consulta Cómo habilitar la inmovilización de OCSP en tu servidor. para obtener más información.

Se debe habilitar TLS para habilitar el agrupamiento de OCSP. Configúralo en on para habilitarlo. El valor predeterminado es off.

El nombre de DNS visible públicamente del host virtual en el router, que incluye el número de puerto. La combinación del nombre de alias de host y el número de puerto del host virtual debe ser única para todos los hosts virtuales de la instalación de Edge. Esto significa que múltiples entornos pueden usar el mismo número de puerto si tienen alias de host diferentes.

Debes crear una entrada DNS y un registro CNAME que coincidan con el alias del host y con el El alias debe coincidir con la string que el cliente pasa en el encabezado Host.

El número de puerto en HostAlias es opcional. Si especificas el puerto como parte del alias de host, también debes especificar el mismo puerto con el elemento <Port>. También puedes especificar dos elementos HostAlias. uno con el número de puerto y otro sin.

Puedes tener varias definiciones de HostAlias en la misma definición de host virtual, que corresponde a varias entradas de DNS para el pero no para varios puertos. Si deseas tener varios puertos, crea varias definiciones de host virtual con puertos diferentes.

Puedes incluir el carácter comodín “*” en el alias de host. El carácter comodín “*” solo puede estar al comienzo (antes del primer “.”) del alias de host y no se puede mezclar con otros caracteres. Por ejemplo: *.example.com. El certificado TLS del host virtual debe tener un comodín coincidente en el nombre del CN del certificado. Por ejemplo, *.example.com El uso de un comodín en un alias de host virtual permite que los proxies de API controlen llamadas dirigidas a varios subdominios, como alpha.example.com, beta.example.com o live.example.com. El uso de un alias de comodín también te ayuda a usar menos hosts virtuales por entorno para mantenerte dentro de los límites del producto, ya que un host virtual con un comodín cuenta como un solo host virtual.

Para Cloud: Si tienes un host virtual existente que usa un puerto distinto de 443, no puedes agregar ni quitar un alias de host.

Para Private Cloud: Si configuras el alias de host con las direcciones IP de tus routers y no con las entradas de DNS, agrega un alias de host independiente para cada router y especifica la dirección IP de cada router y el puerto del host virtual.

Especifica las interfaces de red a las que deseas vincular port. Si omites este elemento, el puerto se vinculará en todas las interfaces.

Por ejemplo, para especificar que se vincule el puerto solo a en0:

<Interfaces>
  <Interface>en0</Interface>
</Interfaces>

Ejecuta el comando "ifconfig -a" para determinar las interfaces disponibles en tu sistema.

Configura cómo reacciona el router para este host virtual cuando falla el procesador de mensajes.

Puedes especificar varios valores con <RetryOption>. Valores válidos incluyen:

Si especificas varios valores, el router usa un operador OR lógico para combinarlos.

Por ejemplo:

<RetryOptions>
  <RetryOption>http_599</RetryOption>
  <RetryOption>error</RetryOption>
  <RetryOption>timeout</RetryOption>
  <RetryOption>invalid_header</RetryOption>
</RetryOptions>

Si usas un ELB en el modo de transferencia de TCP para controlar las solicitudes a los routers perimetrales, el router trata la dirección IP del ELB como la IP del cliente, en lugar de la IP de cliente real. Si el router requiere la IP de cliente verdadera, habilitar proxy_protocol en ELB para que pase la IP del cliente en el paquete de TCP. En el router, también debes configurar <ListenOption> en el host virtual como proxy_protocol. Debido a que el ELB está en modo de transferencia de TCP, por lo general, se finaliza TLS en el router. Por lo tanto, por lo general, solo configuras el host virtual para que use proxy_protocol cuando también lo configuras para que use TLS.

El valor predeterminado de <ListenOption> es una cadena vacía.

Por ejemplo:

<ListenOptions>
  <ListenOption>proxy_protocol</ListenOption>
</ListenOptions>

Para restablecer <ListenOption> más adelante, actualiza el host virtual y omite la etiqueta <ListenOptions> de la actualización.

Habilita TLS/SSL unidireccional. Debes haber definido un almacén de claves que contenga las etiquetas de certificado y privada.

Para Cloud: Debes tener un certificado firmado por una entidad de confianza, como Symantec o VeriSign. No puedes usar un certificado autofirmado ni certificados de hoja firmados por una AC autofirmada.

En Cloud: Si tu host virtual existente está configurado para usar un puerto aparte de 443, no puedes cambiar la configuración de TLS. Eso significa que no puedes cambiar la configuración de TLS desde habilitado a inhabilitado o de inhabilitado a habilitado.

Es el nombre del almacén de claves en Edge.

Apigee recomienda que uses una referencia para especificar el nombre del almacén de claves, de modo que puedas cambiarlo sin tener que reiniciar los routers. Consulta Opciones para configurar TLS para obtener más información.

El nombre del almacén de confianza en Edge que contiene el certificado o la cadena de certificados que se usa para TLS bidireccional. Obligatorio si <ClientAuthEnabled> es verdadero.

Apigee recomienda que uses una referencia para especificar el nombre del almacén de confianza, de modo que puedas cambiarlo sin tener que reiniciar los routers. Consulta Opciones para configurar TLS para obtener más información.

Si es verdadero, especifica que se deben ignorar los errores del certificado TLS. Esto es similar a la opción "-k" de cURL.

Esta opción es válida cuando se configura TLS para servidores y extremos de destino. cuando configures hosts virtuales que usen TLS bidireccional.

Cuando se usa con un extremo o servidor de destino, si el sistema de backend usa SNI y muestra un certificado con un nombre distinguido (DN) de tema que no coincide con el nombre de host, no hay forma de ignorar el error y la conexión falla.

Solo para Edge para la nube privada versión 4.15.07 y anteriores.

Especifica los cifrados que admite el host virtual. Si no se especifican algoritmos de cifrado, se permitirán todos los cifrados disponibles para la JVM.

Para restringir los cifrados, agrega los siguientes elementos:

<Ciphers>
  <Cipher>TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA</Cipher>
  <Cipher>TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256</Cipher>
</Ciphers>

Solo para Edge for Private Cloud versión 4.15.07 y anteriores.

Especifica los protocolos que admite el host virtual. Si no se especifican protocolos, se permitirán todos los protocolos disponibles para la JVM.

Para restringir los protocolos, agrega los siguientes elementos:

<Protocols>
  <Protocol>TLSv1</Protocol>
  <Protocol>TLSv1.2</Protocol>
  <Protocol>SSLv2Hello</Protocol>
</Protocols>

Si tienes una cuenta paga de Edge para Cloud y aún no tienes un certificado y una clave TLS, puedes crear un host virtual que use el certificado y la clave de prueba gratuita de Apigee Eso significa que puedes crear en el host virtual sin crear primero un almacén de claves.

El certificado de prueba gratuita de Apigee se define para un dominio de *.apigee.net. Por lo tanto, el <HostAlias> del host virtual también debe tener el formato *.apigee.net.

Consulta Cómo definir un host virtual que use el certificado y la clave de prueba gratuita de Apigee.

Habilita que Edge capture información de conexión TLS. Esta información estará disponible como variables de flujo en un proxy de API. Consulta Cómo acceder a la información de conexión TLS en un proxy de API para obtener más información.

Habilita la captura de los detalles del certificado de cliente capturados por Edge en TLS bidireccional. Luego, esta información está disponible como variables de flujo en un proxy de API. Consulta Cómo acceder a la información de conexión TLS en un proxy de API para obtener más información.

Establece la duración del tiempo de espera, en segundos, entre los procesadores de mensajes y el router. El El router descarta la conexión y devuelve una respuesta HTTP 504 si no recibe una respuesta del procesador de mensajes antes de que este período venza.

El valor de proxy_read_timeout debe ser mayor que el valor de tiempo de espera objetivo que se usa. por el procesador de mensajes. Esto garantiza que el router no se agote antes de que el procesador de mensajes tenga tiempo para mostrar una respuesta. El tiempo de espera predeterminado del objetivo para el procesador de mensajes es de 55 segundos, 55,000 milisegundos, como lo define el token conf_http_HTTPTransport.io.timeout.millis para el procesador de mensajes.

Establece la duración del tiempo de espera, en segundos, entre el cliente y el router cuando el cliente realiza una solicitud que contiene el encabezado Keep-Alive. El router mantiene abierta la conexión hasta que venza la duración.

El router no cerrará la conexión si está esperando una respuesta del procesador de mensajes. El tiempo de espera comienza solo después de que el router devuelva la respuesta al cliente.

Establece los algoritmos de cifrado admitidos por el host virtual y anula los algoritmos de cifrado predeterminados establecidos en el router.

Especifica una lista de algoritmos de cifrado delimitados por dos puntos, de la siguiente manera:

<Property name="ssl_ciphers">HIGH:!aNULL:!MD5:!DH+3DES:!kEDH;</Property>

Para obtener información acerca de la sintaxis y los valores que permite este token, consulta https://www.openssl.org/docs/man1.0.2/man1/ciphers.html. Ten en cuenta que este token usa los nombres de algoritmos de cifrado de OpenSSL, como AES128-SHA256, y no los nombres de algoritmos de cifrado de Java/JSSE, como TLS_RSA_WITH_AES_128_CBC_SHA256.

!MD5:

!DH+3DES:

!kEDH

Solo está disponible para Edge para la nube privada.

Establece los protocolos TLS que admite el host virtual, como una lista delimitada por espacios. y anula los protocolos predeterminados configurados en el router.

Nota: Si dos hosts virtuales comparten el mismo puerto, se deben configurar ssl_protocols a los mismos protocolos. Es decir, los hosts virtuales que comparten el mismo puerto deben admiten exactamente los mismos protocolos.

Especifica una lista de protocolos TLS delimitados por espacios, en el siguiente formato:

<Property name="ssl_protocols">TLSv1 TLSv1.2</Property>

Habilita (activa) o inhabilita (desactiva) el almacenamiento en búfer del cuerpo de la solicitud. Cuando se activa el almacenamiento en búfer, El router almacena en búfer todo el cuerpo de la solicitud antes de enviarla al Message Processor. Si hay un error, el router puede volver a intentar con otro procesador de mensajes.

Si está desactivado, se inhabilita el almacenamiento en búfer y el cuerpo de la solicitud se envía al procesador de mensajes de inmediato cuando se recibe. Si hay un error, el router no vuelve a intentar la solicitud a otro Message Processor.