Preguntas frecuentes sobre la configuración de hosts virtuales

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Los clientes de Edge Cloud ahora pueden crear, modificar y borrar hosts virtuales. Anteriormente, estas acciones debían ser realizadas por el equipo de asistencia de Apigee Edge.

¿Quién puede configurar un host virtual en Edge Cloud?

Solo un cliente de Cloud con una cuenta pagada puede crear, modificar y borrar un host virtual. El usuario que crea el host virtual debe tener el rol de administrador de la organización o en un rol personalizado con permisos para modificar un host virtual. Los usuarios con otros roles no tienen autorización para crear hosts virtuales.

El rol personalizado requiere permisos GET, PUT y DELETE en /environments/*/virtualhosts, o cualquiera de sus recursos superiores. Consulta Cómo crear roles con la API para obtener más información.

¿Qué sucede si tengo un host virtual existente creado por Apigee?

Los clientes existentes de Edge Cloud ya tienen hosts virtuales creados por Apigee. Ahora puedes modificar esos hosts virtuales.

Sin embargo, revisa los requisitos para modificar un host virtual en Configura hosts virtuales para la nube antes de realizar cualquier cambio. Por ejemplo, si tu host virtual existente está configurado para usar un puerto que no sea el 443, no puedes cambiar el número de puerto ni la configuración de TLS. Eso significa que no puedes cambiar la configuración de TLS de habilitada a inhabilitada, ni de inhabilitada a habilitada.

¿Qué puerto puedo usar en un host virtual en la nube?

Solo puedes usar el puerto 443 en un host virtual en la nube. No puedes usar el puerto 80 ni ningún otro puerto.

¿Por qué no puedo usar el puerto 80 en un host virtual en la nube?

Recomendamos a los clientes de Apigee que dejen de usar hosts virtuales del puerto 80 para el tráfico del entorno de ejecución de la API , ya que el puerto 80 no es seguro. En segundo lugar, debido a que no podemos validar la propiedad de los dominios, los hosts virtuales del puerto 80 no pueden ser de autoservicio para la nube. Los cambios en los hosts virtuales del puerto 80 se consideran no estándar y, como tal, el equipo de asistencia de Apigee Edge se reserva el derecho de rechazar dichos cambios.

¿Se requiere TLS en todos los hosts virtuales nuevos en la nube?

Para crear un host virtual, debes habilitar TLS en el host virtual. Eso significa que primero debes crear un almacén de claves con el certificado y la clave de TLS antes de crear el host virtual.

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.

Consulta Configura hosts virtuales para la nube para obtener más información.

¿Puedo fijar el certificado de prueba gratuita de Apigee?

Por motivos de seguridad, los certificados de prueba gratuita de Apigee vencen cada tres meses. Al final de esos tres meses, Apigee rota el certificado que vence con uno nuevo. Por lo tanto, Apigee no recomienda ni admite la fijación del certificado de prueba gratuita.

¿Puedo actualizar el certificado de TLS que usa un host virtual ?

Si tienes un host virtual con un certificado de TLS que vence, puedes actualizar el host virtual para usar un almacén de claves diferente que contenga un certificado válido.

¿Qué es una referencia?

Una referencia es una variable que contiene el nombre del almacén de claves. Para cambiar el almacén de claves que usa un host virtual, actualiza la variable de referencia, no el host virtual.

Es posible que los hosts virtuales más antiguos de Apigee Edge no estén configurados para usar referencias. En este caso, debes solicitar al equipo de asistencia de Apigee Edge que actualice el host virtual para usar una referencia. No actualices un host virtual por tu cuenta para cambiarlo y usar una referencia.

¿Cómo puedo determinar si mi host virtual usa una referencia?

Para ver información sobre un host virtual específico, usa la API de Get Virtual Host:

curl -X GET -H "accept:application/xml" \
  https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/virtualhosts/{vhost_name} \
  -u orgAdminEmail:pWord

donde vhost_name es el nombre de el host virtual. Por ejemplo, puedes especificar vhost_name como "secure" para ver la configuración del host virtual seguro predeterminado:

<VirtualHost name="secure">
    <HostAliases>
        <HostAlias>orgname-prod.apigee.net</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>443</Port>
    <Properties/>
    <SSLInfo>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <Enabled>true</Enabled>
        <KeyAlias>freetrial</KeyAlias>
        <KeyStore>ref://freetrial</KeyStore>
        <IgnoreValidationErrors>false</IgnoreValidationErrors>
    </SSLInfo>
</VirtualHost>

Ten en cuenta que, en este ejemplo, el valor del elemento <KeyStore> en la respuesta comienza con ref://. Ese prefijo indica que el almacén de claves usa una referencia.

Si el valor del elemento <KeyStore> es un literal de cadena, no usa una referencia. Por ejemplo:

<KeyStore>mykeystore</KeyStore>

No actualices un host virtual por tu cuenta para cambiarlo y usar una referencia. Debes solicitar al equipo de asistencia de Apigee Edge que actualice el host virtual para usar una referencia. Después de que Apigee actualice el host virtual para usar una referencia, puedes cambiar el almacén de claves actualizando la variable de referencia.

Consulta Configura hosts virtuales para la nube para obtener más información.

¿Cómo creo un host virtual?

Usa el siguiente procedimiento para crear el host virtual:

1. Crea una entrada de DNS y un registro CNAME para tu dominio público que apunte a [org]-[environment].apigee.net. Consulta "Acerca de los alias de host y los nombres de DNS" en Información acerca de los hosts virtuales para obtener más información.
2. Crea y configura un almacén de claves con el procedimiento que se describe en Crea almacenes de claves y de confianza con la IU de Edge.
3. Sube tu certificado y clave al almacén de claves.
4. Crea una referencia al almacén de claves como se describe en Configura hosts virtuales para la nube.
5. Crea el host virtual con la API de Create a Virtual Host como se describe en Configura hosts virtuales para la nube. Asegúrate de especificar la referencia correcta del almacén de claves.
6. Si tienes proxies de API existentes, agrega el host virtual al <HTTPConnection> elemento en el ProxyEndpoint. El host virtual se agrega automáticamente a todos los proxies de API nuevos. Consulta Configura un proxy de API para usar un host virtual.

¿Puedo solicitar a Apigee que bloquee los puertos TCP 80, 443 o 15999 en Apigee Edge Cloud?

Dado que nuestros clientes configuran hosts virtuales en el puerto TCP 443 y, a veces, en el puerto TCP 80 (aunque no se recomienda usar el puerto 80), no podemos bloquear estos puertos, ya que esto provocaría una falla en todo el tráfico del entorno de ejecución de la API.

El puerto TCP 15999 se usa de forma interna en la nube para determinar si los routers están en buen estado o no y, por lo tanto, tampoco se debe bloquear, ya que eso puede causar un impacto imprevisto en el entorno de ejecución de la API.