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

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).

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:

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.Elemento del portal con el campo ubicación destacado

    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
  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:

    1. 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.
    2. Ingresa un nombre para el frondend en el campo Nombre.
    3. Selecciona HTTPS del menú desplegable Protocolo.
    4. 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.
    5. Ingresa un nombre para la dirección IP estática en el campo Nombre.
    6. De manera opcional, ingresa una Descripción.
    7. Haga clic en Reservar.
    8. Almacena la dirección IP que se reservó para usar cuando se configura el registro DNS.
    9. Selecciona Crear un certificado nuevo en el menú desplegable Certificado.
      Se abrirá la ventana Crear un nuevo certificado.
    10. Ingresa un nombre para el certificado nuevo en el campo Nombre.
    11. Selecciona Subir certificado en Crear modo.
    12. Sube los detalles del certificado TLS, incluidas la clave pública, la cadena de certificados y la clave privada.
    13. Haga clic en Crear.
    14. 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):

    1. 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.
    2. 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.
    3. Ingresa un nombre en el campo Nombre.
    4. Selecciona Grupo de extremos de red de Internet en el menú desplegable Tipo de backend.
    5. Selecciona HTTPS como el protocolo.
    6. 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.
    7. Desmarca la casilla de verificación para Habilitar Cloud CDN.
    8. Puedes dejar todos los demás valores con su configuración predeterminada.
    9. Haz clic en Crear.
    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:

    1. 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.
    2. Haz clic en Regla avanzada de host y de ruta de acceso (redireccionamiento y reescritura de URL) en Modo.
    3. En la sección Nueva regla de host y ruta de acceso, haz lo siguiente:
      1. Selecciona Enrutar el tráfico a un solo backend en el menú desplegable Acción.
      2. Expande Acción de complemento (reescritura de URL).
      3. 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.
      4. Selecciona el servicio de backend que configuraste en el menú desplegable Backend.
      5. 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.