Referencia de la propiedad del host virtual

Especifica el nombre del host virtual. Usas ese nombre para hacer referencia al host virtual cuando configuras un proxy de API.

Los caracteres que puedes usar en el atributo name 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 perimetral.

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

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 distinto del 443, no puedes cambiar el puerto.

Para las versiones de Private Cloud de la 4.16.01 a la 4.17.05: Cuando creas un host virtual, especificas el puerto del Router que usa el host virtual. Por ejemplo, el puerto 9001. De forma predeterminada, el Router se ejecuta como el usuario "apigee", que no tiene acceso a puertos con privilegios, por lo general, los puertos 1024 y los inferiores. 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 Cómo configurar un host virtual para obtener más información.

Para las versiones de Private Cloud anteriores a la 4.16.01: Un router solo puede detectar 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 finalización de TLS se produce en el Router en el puerto especificado.

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

Un cliente de OCSP (Online Certificate Status Protocol) envía una solicitud de estado a un respondedor de 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á habilitada, la fijación de OCSP permite que Edge, que actúa como el servidor TLS para TLS unidireccional, consulte directamente al respondedor de OCSP y, luego, almacene en caché la respuesta. Luego, Edge devuelve esta respuesta al cliente de TLS o la adhiere como parte del protocolo de enlace de TLS. Consulta Cómo habilitar el OCSP Stapling en tu servidor para obtener más información.

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

Nombre de DNS visible públicamente del host virtual en el Router, que incluye de forma opcional el número de puerto. La combinación del nombre del alias de host y el número de puerto del host virtual debe ser única para todos los hosts virtuales en la instalación de Edge. Esto significa que varios hosts virtuales 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 el alias del host debe coincidir con la cadena 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 él.

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

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 combinar con otros caracteres. Por ejemplo: *.example.com. El certificado TLS del host virtual debe tener un comodín coincidente en el nombre 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 las llamadas dirigidas a varios subdominios, como alpha.example.com, beta.example.com o live.example.com. Usar 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 del 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 entradas de DNS, agrega un alias de host independiente para cada router, especificando la dirección IP de cada router y el puerto del host virtual.

Especifica las interfaces de red a las que deseas que se vincule 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, haz lo siguiente:

<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 el Message Processor deja de funcionar.

Puedes especificar varios valores con <RetryOption>. Los valores válidos incluyen los siguientes:

Si especificas varios valores, el Router usa un 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 modo de transferencia TCP para controlar las solicitudes a los Edge Routers, el Router trata la dirección IP del ELB como la IP del cliente en lugar de la IP del cliente real. Si el router requiere la IP real del cliente, habilita proxy_protocol en el ELB para que pase la IP del cliente en el paquete TCP. En el router, también debes establecer <ListenOption> en el host virtual como proxy_protocol. Dado que el ELB está en modo de paso de TCP, por lo general, finalizas 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 anular la configuración de <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 el certificado y la clave 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 CA autofirmada.

Para Cloud: Si tu host virtual existente está configurado para usar un puerto que no sea el 443, no puedes cambiar el parámetro de configuración de TLS. Esto significa que no puedes cambiar el parámetro de configuración de TLS de habilitado a inhabilitado, o viceversa.

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 cambiar el almacén de claves sin tener que reiniciar los routers. Consulta Opciones para configurar TLS para obtener más información.

Nombre del almacén de certificados 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 certificados de confianza, de modo que puedas cambiar el almacén de certificados de confianza sin tener que reiniciar los routers. Consulta Opciones para configurar TLS para obtener más información.

Si es verdadero, se 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, y cuando se configuran hosts virtuales que usan TLS bidireccionales.

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 algoritmos de cifrado que admite el host virtual. Si no se especifican algoritmos de cifrado, se permitirán todos los algoritmos de cifrado disponibles para la JVM.

Para restringir los algoritmos de cifrado, 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 para la nube privada, 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 de TLS, puedes crear un host virtual que use el certificado y la clave de prueba gratuitos de Apigee. Esto significa que puedes crear el host virtual sin antes crear 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 la captura de información de conexión TLS por parte de Edge. Luego, esta información está disponible como variables de flujo en un proxy de API. Consulta Acceder a la información de conexión TLS en un proxy de API para obtener más información.

Permite capturar los detalles del certificado de cliente que Edge captura en la TLS bidireccional. Luego, esta información está disponible como variables de flujo en un proxy de API. Consulta 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 Message Processors y el Router. El router descarta la conexión y devuelve una respuesta HTTP 504 si no recibe una respuesta del Message Processor antes de que venza este período.

El valor de proxy_read_timeout debe ser mayor que el valor de tiempo de espera objetivo que usa el Message Processor. Esto garantiza que el router no agote el tiempo de espera antes de que el Message Processor haya tenido tiempo para devolver una respuesta. El tiempo de espera predeterminado del destino para el Message Processor es de 55 segundos (55, 000 milisegundos), como se define en el token conf_http_HTTPTransport.io.timeout.millis para el Message Processor.

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 la conexión abierta hasta que vence el plazo.

El Router no cerrará la conexión si está esperando una respuesta del Message Processor. El tiempo de espera comienza solo después de que el enrutador devuelve 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 sobre 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 cifrado de OpenSSL, como AES128-SHA256, y no los nombres 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 de TLS admitidos por el host virtual, como una lista delimitada por espacios, y anula los protocolos predeterminados establecidos en el router.

Nota: Si dos hosts virtuales comparten el mismo puerto, deben establecer ssl_protocols en los mismos protocolos. Es decir, los hosts virtuales que comparten el mismo puerto deben admitir exactamente los mismos protocolos.

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

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

Habilita (activado) o inhabilita (desactivado) el almacenamiento en búfer del cuerpo de la solicitud. Cuando el almacenamiento en búfer está activado, el router almacena en búfer todo el cuerpo de la solicitud antes de enviarlo al Message Processor. Si hay un error, el Router puede volver a intentar con otro Message Processor.

Si está desactivada, se inhabilita el almacenamiento en búfer y el cuerpo de la solicitud se envía al Message Processor de inmediato cuando se recibe. Si hay un error, el Router no reintenta la solicitud a otro Message Processor.