Personalizar un dominio

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

Consulta la documentación de Apigee Edge.

Cuando creas un portal de desarrollo, se te proporciona de forma predeterminada un nombre de dominio de ejemplo de Apigee para acceder a tu portal activo con 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 a minúsculas y con los espacios y guiones eliminados.

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

https://developers.example.com

Para consultar las consideraciones sobre el uso de un dominio personalizado con un proveedor de identidades SAML, consulta Usar un dominio personalizado con el proveedor de identidades SAML.

Pasos para personalizar tu dominio

Para personalizar tu nombre de dominio, sigue estos pasos:

  1. Registra tu nombre de dominio.
  2. Crea un certificado TLS para tu dominio personalizado. Necesitarás el certificado al crear el balanceador de carga.
  3. Determina el nombre de host predeterminado de tu portal.
  4. Crea un grupo de puntos finales de red (NEG) de Internet para definir el endpoint de backend de tu portal integrado para el balanceador de carga.
  5. Crea un balanceador de carga que apunte al NEG de Internet y reserva la IP para las solicitudes de clientes entrantes.
  6. Configura el dominio personalizado en tu portal.
  7. Actualiza tu DNS para crear un registro para el host del dominio personalizado.

Paso 1: Registra tu nombre de dominio

Si necesitas registrar un dominio nuevo, hay muchos sitios populares para registrar dominios, como Google Domains. Puedes elegir el sitio de registro de dominios que quieras.

Cuando elijas el nombre de dominio, ten en cuenta que las URLs fáciles de usar y de leer son un componente clave para mejorar la optimización en buscadores, tal como se describe en el artículo Implementar la optimización en buscadores (SEO).

Paso 2: Crea un certificado TLS para tu dominio personalizado

Crea un certificado TLS para tu dominio personalizado con la herramienta que prefieras, como Let's Encrypt. Para obtener más información, consulta estos artículos:

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

Para determinar el nombre de host predeterminado de tu portal, haz lo siguiente:

  1. Muestra la lista de portales:

    Interfaz de usuario de Cloud Console

    En la consola de Apigee en Cloud, ve a la página Distribución > Portales.

    Ir a Portales

    Interfaz clásica

    En la interfaz de usuario de Apigee, selecciona Publicar > Portales en la barra de navegación lateral. Se muestra la lista de portales.

  2. Copie el contenido del campo Ubicación del portal para el que quiera crear un dominio personalizado. Por ejemplo, apigee-gcp-prod1-helloworld.apigee.io.

    Necesitarás este valor en el siguiente paso.

Paso 4: Crea un NEG de Internet

En este paso, creará un grupo de endpoints de red (NEG) de Internet para definir el endpoint de backend de su portal integrado para el balanceador de carga. Para obtener más información, consulta el artículo Introducción a los grupos de puntos finales de red de Internet.

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

    Ir a la página Panel de control

  2. En el navegador, selecciona Compute Engine > Grupos de endpoints de red.

  3. Haz clic en Crear grupo de endpoints de red.

  4. Configure los siguientes campos:

    Campo Valor
    Nombre Introduce un nombre para el NEG de Internet.
    Tipo de grupo de puntos finales de red Selecciona Grupo de puntos finales de red (Internet).
    Nuevo punto final de red
  5. Puedes dejar el resto de los campos con sus valores predeterminados.

  6. Haz clic en Crear.

Se crea la NEG de Internet.

Paso 5: Crea un balanceador de carga

Crea un balanceador de carga que apunte al NEG de Internet y reserva la IP para las solicitudes de clientes entrantes.

Selecciona el tipo de balanceador de carga

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

    Ir a Balanceo de carga

  2. Haga clic en Crear balanceador de carga.
  3. En Tipo de balanceador de carga, selecciona Balanceador de carga de aplicación (HTTP/HTTPS) y haz clic en Siguiente.
  4. En Público o interno, selecciona Público (externo) y haz clic en Siguiente.
  5. En Implementación global o en una sola región, selecciona La mejor opción para cargas de trabajo globales y haz clic en Siguiente.
  6. En Generación del balanceador de carga, selecciona Balanceador de carga de aplicación externo global y haz clic en Siguiente.
  7. Haz clic en Configurar.

Configurar el balanceador de carga

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

    Categoría Pasos
    Configuración de frontend

    Reserva la dirección IP para las solicitudes de clientes entrantes y sube el certificado TLS creado en el paso 2: Crea un certificado TLS:

    1. En la sección Crear balanceador de carga de aplicación externo global, coloca el cursor sobre Configuración de frontend y haz clic en la flecha.
    2. En el campo Nombre, da un nombre al frontend.
    3. Selecciona HTTPS en el 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 dirección IP estática nueva.
    5. Escribe un nombre para la dirección IP estática en el campo Nombre.
    6. Si quieres, puedes añadir una descripción.
    7. Haz clic en Reservar.
    8. Almacena la dirección IP que se ha reservado para usarla al configurar el registro DNS.
    9. Selecciona Crear un certificado en el menú desplegable Certificado.
      Se abrirá la ventana Crear un certificado.
    10. Escribe un nombre para el nuevo certificado en el campo Nombre.
    11. En Modo de creación, selecciona Subir mi certificado.
    12. Sube los detalles de tu certificado TLS, incluidos la clave pública, la cadena de certificados y la clave privada.
    13. Haz clic en Crear.
    14. Haga clic en Hecho para crear la nueva IP y el puerto de frontend.
    Configuración de backend

    Configura el backend para dirigir el tráfico entrante al NEG de Internet creado en el paso 4: Crea un grupo de endpoints de red (NEG) de Internet:

    1. En la sección Crear balanceador de carga de aplicación externo global, coloca el cursor sobre Configuración de backend y haz clic en la flecha.
    2. En la sección Servicios y segmentos de backend, selecciona Servicios de backend > Crear un servicio de backend en el menú desplegable.
      Se abrirá la ventana Crear servicio de backend.
    3. Escribe un nombre en el campo Nombre.
    4. Selecciona Grupo de puntos de conexión de red de Internet en el desplegable Tipo de backend.
    5. Selecciona HTTPS como protocolo.
    6. En la sección Nuevo backend, selecciona el NEG de Internet que has creado en el paso 4: Crea un grupo de endpoints de red de Internet del menú desplegable Grupo de endpoints de red de Internet y haz clic en Hecho.
    7. Desmarque la casilla Habilitar Cloud CDN.
    8. Puedes dejar el resto de los valores con sus valores predeterminados.
    9. Haz clic en Crear.
    Reglas de host y ruta

    Configura las reglas de host y ruta para determinar cómo se dirigirá el tráfico:

    1. En la sección Create global external Application Load Balancer (Crear balanceador de carga de aplicación externo global), coloca el cursor sobre Host and path rules (Reglas de host y de ruta) y haz clic en la flecha.
    2. En Modo, haz clic en Regla de host y ruta avanzada (redirección de URL, reescritura de URL).
    3. En la sección Nueva regla de host y ruta, haga lo siguiente:
      1. En el menú desplegable Acción, seleccione Dirigir tráfico hacia un solo backend.
      2. Expande Acción complementaria (reescritura de URL).
      3. En el campo Reescritura del host, introduce el nombre de dominio predeterminado que has copiado en el paso 3: Determina el nombre de host predeterminado de tu portal.
      4. Selecciona el servicio de backend que has configurado en el menú desplegable Backend.
      5. Haz clic en Listo.
  2. En la página Crear balanceador de carga de aplicación externo global, haz clic en Crear.

Paso 6: Configura el dominio personalizado en tu portal

Para configurar el dominio personalizado en tu portal, sigue estos pasos:

  1. Muestra la lista de portales:

    Interfaz de usuario de Cloud Console

    En la consola de Apigee en Cloud, ve a la página Distribución > Portales.

    Ir a Portales

    Interfaz clásica

    En la interfaz de usuario de Apigee, selecciona Publicar > Portales en la barra de navegación lateral. Se muestra la lista de portales.

  2. Selecciona tu portal en la lista.

  3. Selecciona Configuración.

  4. Haz clic en la pestaña Domains (Dominios).

  5. Introduce el nombre de tu dominio personalizado en el campo Dominio.

  6. Haz clic en Enable (Habilitar).

Comprueba que, cuando accedas al dominio personalizado en un navegador, se te dirija a tu portal integrado.

Consulta también los artículos Editar un dominio personalizado y Inhabilitar un dominio personalizado.

Paso 7: Actualiza tu DNS

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

Para crear una zona de Cloud DNS, sigue los pasos que se describen en Gestionar zonas. Asegúrate de configurar los siguientes campos:

Campo Descripción
Tipo de zona Selecciona Public (Públicas).
Nombre de zona Introduce un nombre descriptivo para la zona. Por ejemplo: mycompany-zone
Nombre de DNS Introduce el sufijo de la zona con un nombre de dominio que te pertenezca. Por ejemplo: mycompany.com

Después de crear una zona, en la página Detalles de zona, haz clic en Añadir conjunto de registros y sigue los pasos que se describen en Gestionar registros. Asegúrate de configurar los siguientes campos:

Campo Descripción
Nombre de DNS Especifica el prefijo del nombre de DNS. También se muestra el sufijo que has definido para la zona de Cloud DNS, pero no se puede editar. Por ejemplo: developers.mycompany.com
Tipo de registro del recurso Selecciona A (opción predeterminada).
TTL Asigna el valor que quieras o deja el valor predeterminado 5.
Unidad TTL Asigna el valor que quieras o deja el valor predeterminado minutos.
Dirección IPv4 Introduce la dirección IP externa que has reservado al crear el balanceador de carga.

Editar un dominio personalizado en tu portal

Para editar un dominio personalizado en tu portal, sigue estos pasos:

  1. Muestra la lista de portales:

    Interfaz de usuario de Cloud Console

    En la consola de Apigee en Cloud, ve a la página Distribución > Portales.

    Ir a Portales

    Interfaz clásica

    En la interfaz de usuario de Apigee, selecciona Publicar > Portales en la barra de navegación lateral. Se muestra la lista de portales.

  2. Selecciona tu portal en la lista.

  3. Selecciona Configuración.

  4. Haz clic en la pestaña Domains (Dominios).

  5. Edita la información del dominio personalizado.

  6. Haz clic en Guardar.

Inhabilitar un dominio personalizado en tu portal

Para inhabilitar un nombre de dominio personalizado en tu portal, sigue estos pasos:

  1. Muestra la lista de portales:

    Interfaz de usuario de Cloud Console

    En la consola de Apigee en Cloud, ve a la página Distribución > Portales.

    Ir a Portales

    Interfaz clásica

    En la interfaz de usuario de Apigee, selecciona Publicar > Portales en la barra de navegación lateral. Se muestra la lista de portales.

  2. Selecciona tu portal en la lista.

  3. Selecciona Configuración.

  4. Haz clic en la pestaña Domains (Dominios).

  5. Haz clic en Inhabilitar.

  6. Haz clic en Inhabilitar en la ventana emergente para confirmar la operación.

El dominio personalizado se inhabilita y los campos se borran.