Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Hub de APIs de Apigee

El conector Apigee API Hub te permite gestionar, descubrir y controlar las APIs de la cartera de tu organización.

Versiones compatibles

Este conector es compatible con la versión v1 del hub de APIs de Apigee.

Antes de empezar

• En tu proyecto de Google Cloud, haz lo siguiente:

  • Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
  • Concede el rol de gestión de identidades y accesos roles/connectors.admin al usuario que configure el conector.
  • Habilita los siguientes servicios:
    • secretmanager.googleapis.com (API Secret Manager)
    • connectors.googleapis.com (API Connectors)

    Para saber cómo habilitar servicios, consulta Habilitar servicios. Si estos servicios o permisos no se han habilitado en tu proyecto anteriormente, se te pedirá que los habilites cuando configures el conector.

• Si utilizas la autenticación de cuenta de servicio en lugar de la autenticación de OAuth 2.0, asegúrate de que se hayan concedido los permisos adecuados a la cuenta de servicio. Para obtener más información, consulta el artículo sobre roles de IAM predefinidos.

Crear una conexión al centro de APIs de Apigee

Una conexión es específica de una fuente de datos. Esto significa que, si tiene muchas fuentes de datos, debe crear una conexión independiente para cada una de ellas. Para crear una conexión, sigue estos pasos:

1. En la consola de Cloud, ve a la página Integration Connectors > Connections (Integration Connectors > Conexiones) y, a continuación, selecciona o crea un proyecto de Google Cloud.

   Ve a la página Conexiones.

2. Haga clic en + Crear para abrir la página Crear conexión.
3. En la sección Ubicación, selecciona una ubicación de la lista Región y, a continuación, haz clic en Siguiente.

   Para ver la lista de todas las regiones admitidas, consulta Ubicaciones.

4. En la sección Detalles de la conexión, haz lo siguiente:
   1. Selecciona Apigee API hub (Centro de APIs de Apigee) en la lista Connector (Conector).
   2. Seleccione una versión del conector en la lista Versión del conector.
   3. En el campo Nombre de conexión, introduce un nombre para la instancia de conexión. El nombre de la conexión puede contener letras minúsculas, números o guiones. El nombre debe empezar por una letra y terminar con una letra o un número, y no puede superar los 49 caracteres.
   4. Si quiere, puede introducir una Descripción para la instancia de conexión.
   5. También puedes habilitar Registro en la nube y, a continuación, seleccionar un nivel de registro. De forma predeterminada, el nivel de registro es Error.
   6. Cuenta de servicio: selecciona una cuenta de servicio que tenga los roles necesarios.
   7. (Opcional) Configura los ajustes del nodo de conexión.
   • Número mínimo de nodos: introduce el número mínimo de nodos de conexión.
   • Número máximo de nodos: introduce el número máximo de nodos de conexión.

   Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se necesitan más nodos para procesar más transacciones de una conexión y, a la inversa, se necesitan menos nodos para procesar menos transacciones. Para saber cómo afectan los nodos a los precios de los conectores, consulta la sección Precios de los nodos de conexión. Si no introduces ningún valor, de forma predeterminada, el número mínimo de nodos es 2 (para mejorar la disponibilidad) y el máximo es 50.

   Nota: Solo puedes personalizar los valores de los nodos de conexión si tienes una cuenta de pago por uso.
   8. Haz clic en Siguiente.
5. En la sección Destinations (Destinos), introduce los detalles del host remoto (sistema backend) al que quieras conectarte.
   1. En el campo Tipo de destino, selecciona un destino.
   2. En el campo Dirección del host, especifica el nombre de host o la dirección IP del destino.

   3. Si quiere introducir más destinos, haga clic en +AÑADIR DESTINO.

   4. Haz clic en Siguiente.
6. En la sección Autenticación, introduce los detalles de autenticación.
   1. Seleccione un Tipo de autenticación e introduzca los detalles pertinentes.

      La conexión del hub de APIs de Apigee admite los siguientes tipos de autenticación:

      • OAuth 2.0: código de autorización
      • Autenticación con cuenta de servicio

   Para saber cómo configurar estos tipos de autenticación, consulta Configurar la autenticación.

   2. Haz clic en Siguiente.
7. Revise los detalles de la conexión y la autenticación y, a continuación, haga clic en Crear.

Configurar la autenticación

Introduce los detalles en función de la autenticación que quieras usar.

• OAuth 2.0 - Código de autorización: selecciona esta opción para autenticarte mediante un flujo de inicio de sesión de usuario basado en la Web. Especifica los siguientes detalles:
• ID de cliente: el ID de cliente necesario para conectarse a su servicio de backend del centro de APIs de Apigee.
• Scopes: lista separada por comas de los permisos deseados. Para ver todos los permisos de OAuth 2.0 admitidos para el servicio de Google que necesites, consulta la sección correspondiente de la página Permisos de OAuth 2.0 para las APIs de Google.
• Secreto de cliente: selecciona el secreto de Secret Manager. Debes haber creado el secreto de Secret Manager antes de configurar esta autorización.
• Versión del secreto: versión del secreto de Secret Manager para el secreto de cliente.

En el caso del tipo de autenticación Authorization code, después de crear la conexión, debes autorizarla.

• Autenticación de cuenta de servicio: selecciona esta opción para autenticarte con la cuenta de servicio que has proporcionado en los pasos anteriores al configurar esta conexión. Asegúrate de que has proporcionado a la cuenta de servicio los roles y permisos de gestión de identidades y accesos pertinentes necesarios para la autenticación.
  • Ámbitos: selecciona los ámbitos de OAuth 2.0 necesarios en el menú desplegable. Para obtener más información, consulta Ámbitos de acceso.

Autorizar la conexión

Si usas el código de autorización de OAuth 2.0 para autenticar la conexión, completa las siguientes tareas después de crearla.

1. En la página Conexiones, busca la conexión que acabas de crear.

   Verás que el estado del nuevo conector será Autorización obligatoria.

2. Haz clic en Se requiere autorización.

   Se mostrará el panel Editar autorización.

3. Copia el valor de URI de redirección en tu aplicación externa.
4. Verifica los detalles de la autorización.
5. Haz clic en Autorizar.

   Si la autorización se realiza correctamente, el estado de la conexión será Activa en la página Conexiones.

Reautorización del código de autorización

Si usas el tipo de autenticación Authorization code y has hecho algún cambio en la configuración del hub de APIs de Apigee, debes volver a autorizar la conexión del hub de APIs de Apigee. Para volver a autorizar una conexión, sigue estos pasos:

1. En la página Conexiones, haga clic en la conexión que quiera.

   Se abrirá la página de detalles de la conexión.

2. Haz clic en Editar para modificar los detalles de la conexión.
3. Verifica los detalles de OAuth 2.0 - Código de autorización en la sección Autenticación.

   Si es necesario, haz los cambios pertinentes.

4. Haz clic en Guardar. Se te dirigirá a la página de detalles de la conexión.
5. En la sección Autenticación, haga clic en Editar autorización. Se muestra el panel Autorizar.
6. Haz clic en Autorizar.

   Si la autorización se realiza correctamente, el estado de la conexión será Activa en la página Conexiones.

Limitaciones del sistema

El conector del centro de APIs de Apigee puede procesar un máximo de 20 transacciones por segundo y nodo, y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para mejorar la disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Nota: El número de nodos de Integration Connectors se ajustará automáticamente de forma dinámica en función de tu uso. Sin embargo, si quieres reservar capacidad para grandes volúmenes sin esperar al autoescalado, puedes ajustar el valor mínimo de nodos de una conexión. Se necesitan más nodos para procesar más transacciones de una conexión. Por el contrario, se necesitan menos nodos si una conexión procesa menos transacciones. Para configurar los valores del nodo, haz lo siguiente:

• Si eres cliente de pago por uso, configura el valor mínimo y máximo del nodo en la página de edición de la conexión.
• Si tienes una suscripción, ponte en contacto con el equipo de Asistencia.

El número máximo de transacciones que puede gestionar un nodo depende de varios factores. Por lo tanto, antes de ajustar el número mínimo de nodos para mejorar el rendimiento, le recomendamos que compruebe si sus sistemas backend están configurados de forma óptima para gestionar el tráfico necesario.

Usar la conexión del centro de APIs de Apigee en una integración

Una vez que hayas creado la conexión, estará disponible en Application Integration. Puedes usar la conexión en una integración a través de la tarea Conectores.

Acciones

Este conector proporciona una capa de abstracción para los objetos del servicio de backend conectado. Solo puedes acceder a los objetos del backend a través de esta abstracción. La abstracción se te muestra como acciones. Un Action es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Problemas conocidos

El conector del hub de APIs de Apigee tiene límites de configuración. Los recursos en los que se pueden realizar búsquedas tienen un límite de 2,5 MB y los archivos de especificación de API, de 10 MB. Para obtener más información, consulta Límites del hub de APIs de Apigee.

Obtener ayuda de la comunidad de Google Cloud

Puedes publicar tus preguntas y hablar sobre este conector en la comunidad de Google Cloud, en los foros de Cloud.

Siguientes pasos

• Consulta cómo suspender y reactivar una conexión.
• Consulta cómo monitorizar el uso de los conectores.
• Consulta cómo ver los registros de conectores.