Personaliza tu dominio

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Cuando creas un portal para desarrolladores, se te proporciona de forma predeterminada un nombre de dominio de muestra de Apigee a fin de acceder al portal en vivo en el siguiente formato:

https://orgname-portalname.apigee.io

Donde orgname es el nombre de la organización y portalname se define con el nombre del portal convertido en minúsculas y los espacios y guiones quitados.

Antes de lanzar un portal para desarrolladores, te recomendamos que proporciones tu propio nombre de dominio personalizado. Por ejemplo, esta es una alternativa popular:

https://developers.example.com

Nota: Los nombres de dominio se pueden personalizar únicamente para las cuentas de pago.

Para conocer las consideraciones sobre el uso de un dominio personalizado con un proveedor de identidad de SAML, consulta la sección sobre cómo usar un dominio personalizado con el proveedor de identidad de SAML.

Pasos para personalizar el dominio

Siga estos pasos para personalizar el nombre de tu dominio:

1. Registra tu nombre de dominio.
2. Crea un certificado TLS para tu dominio personalizado. Necesitarás el certificado cuando crees el balanceador de cargas.
3. Determina el nombre de host predeterminado para el portal.
4. Crea un grupo de extremos de red de Internet (NEG) a fin de definir el extremo del backend de tu portal integrado para el balanceador de cargas.
5. Crea un balanceador de cargas que apunte al NEG de Internet y reserva la IP para tus solicitudes de cliente entrantes.
6. Configura el dominio personalizado en tu portal.
7. Actualiza tu DNS a fin de crear un registro nuevo para el host del dominio personalizado.

Paso 1: Registra tu nombre de dominio

Si necesitas registrar un dominio nuevo, existen muchos sitios populares de registro de dominios disponibles, como Google Domains. El sitio de registro de dominio que elijas depende de ti.

Cuando decidas el nombre de tu dominio, considera que las URL legibles son un componente clave para mejorar la optimización por motores de búsqueda, como se describe en Cómo implementar la optimización por motores de búsqueda (SEO).

Notas:

• No uses la string “apigee” en tu nombre de dominio personalizado.
• Considera redireccionarlos a otras alternativas de nombres de dominio similares.

Paso 2: Crea un certificado TLS para tu dominio personalizado

Crea un certificado TLS para el dominio personalizado con la herramienta que prefieras, como Let's Encrypt. Para obtener más información, consulte:

• Descripción general de los certificados SSL
• Usa certificados SSL autoadministrados

Paso 3: Determina el nombre de host predeterminado de tu portal

Para determinar el nombre de host predeterminado de tu portal, sigue estos pasos:

1. En la IU de Apigee, selecciona Publish > Portals en la barra de navegación lateral. Se muestra la lista de portales.

2. Copia el contenido del campo Ubicación para el portal para el que deseas crear un dominio personalizado.

   Necesitarás este valor en el paso siguiente.

Paso 4: Crea un NEG de Internet

En este paso, crearás un grupo de extremos de red de Internet (NEG) a fin de definir el extremo del backend de tu portal integrado para el balanceador de cargas. Para obtener más información, consulta la descripción general de los grupos de extremos de red de Internet.

1. En la consola de Google Cloud, ve a la página Panel y selecciona o crea un proyecto de Google Cloud.

   Ir a la página Panel

2. Selecciona Compute Engine > Grupos de extremos de red en el navegador.

3. Haz clic en Crear un grupo de extremos de red.

4. Configura los siguientes campos:

   Campo	Valor
   Nombre	Ingresa un nombre para el NEG de Internet.
   Tipo de grupo de extremos de red	Selecciona Grupo de extremos de red (Internet).
   Nuevo extremo de red	Agregar a través de: Selecciona Nombre y puerto de dominio completamente calificados. Nombre de dominio completamente calificado: Ingresa el nombre de dominio predeterminado que copiaste en el Paso 3: Determina el nombre de host predeterminado de tu portal.

5. Puedes dejar los campos restantes con sus valores predeterminados.

6. Haga clic en Crear.

Se crea el NEG de Internet.

Paso 5: Crea un balanceador de cargas

Crea un balanceador de cargas que apunte al NEG de Internet y reserva la IP para tus solicitudes de cliente entrantes.

Inicia la configuración

1. En la consola de Google Cloud, ve a la página Balanceo de cargas.

   Ir a Balanceo de cargas

2. Haz clic en Crear balanceador de cargas.
3. En Tipo de balanceador de cargas, selecciona Balanceador de cargas de aplicaciones (HTTP/HTTPS) y haz clic en Siguiente.
4. En Orientado al público o interno, selecciona Orientado al público (externo) y haz clic en Siguiente.
5. En Implementación global o de una sola región, selecciona Mejor para cargas de trabajo globales y haz clic en Siguiente.
6. En Generación de balanceadores de cargas, selecciona Balanceador de cargas de aplicaciones externo global y haz clic en Siguiente.
7. Haz clic en Configurar.

Configura el balanceador de cargas

1. Haz clic en cada categoría y configura el balanceador de cargas como se describe en la siguiente tabla.

   Categoría	Pasos
   Configuración de frontend	Reserva la dirección IP para tus solicitudes de cliente entrantes y sube el certificado TLS creado en el Paso 2: Crea un certificado TLS: En la sección Crear un balanceador de cargas de aplicaciones externo global, coloca el cursor sobre Configuración de frontend y haz clic en la flecha. Ingresa un nombre para el frondend en el campo Nombre. Selecciona HTTPS del menú desplegable Protocolo. En el menú desplegable Dirección IP, selecciona Crear dirección IP . Se mostrará el cuadro de diálogo Reservar una nueva dirección IP estática. Ingresa un nombre para la dirección IP estática en el campo Nombre. De manera opcional, ingresa una Descripción. Haga clic en Reservar. Almacena la dirección IP que se reservó para usar cuando se configura el registro DNS. Selecciona Crear un certificado nuevo en el menú desplegable Certificado. Se abrirá la ventana Crear un nuevo certificado. Ingresa un nombre para el certificado nuevo en el campo Nombre. Selecciona Subir certificado en Crear modo. Sube los detalles del certificado TLS, incluidas la clave pública, la cadena de certificados y la clave privada. Haga clic en Crear. Haz clic en Listo para crear la IP y el puerto de frontend nuevos.
   Configuración de backend	Establece la configuración del backend para dirigir el tráfico entrante al NEG de Internet creado en el Paso 4: Crea un grupo de extremos de red de Internet (NEG): En la sección Crear un balanceador de cargas de aplicaciones externo global, coloca el cursor sobre Configuración de backend y haz clic en la flecha. En la sección Servicios y buckets de backend, selecciona Servicios de backend > Crear un servicio de backend en el menú desplegable. Se abrirán las diapositivas de la ventana Crear servicio de backend. Ingresa un nombre en el campo Nombre. Selecciona Grupo de extremos de red de Internet en el menú desplegable Tipo de backend. Selecciona HTTPS como el protocolo. En la sección Nuevo backend, selecciona el NEG de Internet que creaste en el Paso 4: Crea un grupo de extremos de red de Internet (NEG) en el menú desplegable Grupo de extremos de red de Internet y haz clic Listo. Desmarca la casilla de verificación para Habilitar Cloud CDN. Puedes dejar todos los demás valores con su configuración predeterminada. Haz clic en Crear. Nota: Cloud CDN no es compatible con el portal de Apigee.
   Reglas del host y de la ruta de acceso	Configura las reglas de host y ruta de acceso para determinar cómo se dirigirá el tráfico: En la sección Crear un balanceador de cargas de aplicaciones externo global, coloca el cursor sobre Reglas de host y ruta y haz clic en la flecha. Haz clic en Regla avanzada de host y de ruta de acceso (redireccionamiento y reescritura de URL) en Modo. En la sección Nueva regla de host y ruta de acceso, haz lo siguiente: Selecciona Enrutar el tráfico a un solo backend en el menú desplegable Acción. Expande Acción de complemento (reescritura de URL). Ingresa el nombre de dominio predeterminado que copiaste en el Paso 3: Determina el nombre de host predeterminado para tu portal en el campo Reescritura del host. Selecciona el servicio de backend que configuraste en el menú desplegable Backend. Haz clic en Listo.

2. Haz clic en Crear en la página Crear balanceador de cargas de aplicaciones externo global.

Paso 6: Configura el dominio personalizado en tu portal

Para configurar el dominio personalizado en tu portal, haz lo siguiente:

1. En la IU de Apigee, selecciona Publish > Portals en la barra de navegación lateral.
   Se muestra la lista de portales.
2. Selecciona tu portal en la lista.
3. Selecciona Configuración en la página de destino o en el menú desplegable de la barra de navegación superior.
4. Haz clic en la pestaña Dominios.
5. Ingresa tu nombre de dominio personalizado en el campo Dominio.
6. Haga clic en Habilitar.

Prueba que, cuando accedas al dominio personalizado en un navegador, se te direccionará a tu portal integrado.

Consulta también Edita un dominio personalizado e Inhabilita un dominio personalizado.

Paso 7: Actualiza tu DNS

En tu sistema de DNS, crea un registro nuevo para el host del dominio personalizado.

Para crear una zona de Cloud DNS, sigue los pasos que se describen en Administra zonas. Asegúrate de configurar los siguientes campos como se describe a continuación:

Campo	Descripción
Tipo de zona	Selecciona Público.
Nombre de la zona	Ingresa un nombre significativo para la zona. Por ejemplo: mycompany-zone
Nombre de DNS	Ingresa el sufijo de la zona con un nombre de dominio de tu propiedad. Por ejemplo: mycompany.com

Después de crear una zona, en la página Detalles de la zona, haz clic en Agregar conjunto de registros y sigue los pasos descritos en Administra registros. Asegúrate de configurar los siguientes campos como se describe a continuación:

Campo	Descripción
Nombre del DNS	Especifica el prefijo de tu nombre de DNS. También se muestra el sufijo que definiste para la zona de Cloud DNS, pero no se puede editar. Por ejemplo: developers.mycompany.com
Tipo de registro del recurso	Selecciona A (el valor predeterminado).
TTL	Configúralo como el valor deseado o deja el valor en 5 (predeterminado).
Unidad TTL	Configurado como el valor deseado o deja el valor en minutos (predeterminado).
Dirección IPv4	Ingresa la dirección IP externa que reservaste cuando creaste el balanceador de cargas.

Edita un dominio personalizado en tu portal

Para editar un dominio personalizado en tu portal, haz lo siguiente:

1. En la IU de Apigee, selecciona Publish > Portals en la barra de navegación lateral.
   Se muestra la lista de portales.
2. Selecciona tu portal en la lista.
3. En el menú desplegable de la barra de navegación superior o en la página de destino, selecciona Configuración.
4. Haz clic en la pestaña Dominios.
5. Edita la información del dominio personalizado.
6. Haz clic en Guardar.

Inhabilita un dominio personalizado en tu portal

Para inhabilitar un nombre de dominio personalizado en tu portal, haz lo siguiente:

1. En la IU de Apigee, selecciona Publish > Portals en la barra de navegación lateral. Se muestra la lista de portales.
2. Selecciona tu portal en la lista.
3. En el menú desplegable de la barra de navegación superior o en la página de destino, selecciona Configuración.
4. Haz clic en la pestaña Dominios.
5. Haz clic en Inhabilitar.
6. Haz clic en Inhabilitar en el mensaje para confirmar la operación.

El dominio personalizado está inhabilitado y se borran los campos.