Crear un conector personalizado y una conexión

En esta página se describe cómo crear una especificación de OpenAPI para un servicio web y, a continuación, crear un conector personalizado y una conexión para ese conector.

Antes de crear un conector personalizado, debes crear una especificación OpenAPI para el servicio web.

Crear una especificación de OpenAPI para el servicio web

Los conectores personalizados admiten OpenAPI 3.0. También puedes crear la especificación manualmente. Para obtener información sobre las especificaciones de OpenAPI, consulta Especificaciones de OpenAPI.

También puedes generar automáticamente la especificación de OpenAPI 2.0 con el middleware de Swagger de Gin. Para obtener información, consulta Gin Swagger. Debes convertir la especificación de OpenAPI 2.0 a la especificación de OpenAPI 3.0 mediante Swagger Converter.

Especificación de OpenAPI de ejemplo.

{
  "openapi": "3.0.0",
  "info": {
    "title": "Go HTTPbin Proxy Service",
    "description": "A simple Go service that proxies requests to httpbin.org, adding custom headers.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "http://localhost:8080"
    }
  ],
  "paths": {
    "/getData": {
      "get": {
        "summary": "Fetch data from httpbin.org/get",
        "description": "Sends a GET request to httpbin.org/get, including any custom headers.",
        "responses": {
          "200": {
            "description": "Successful response from httpbin.org",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/postData/{id}": {
      "post": {
        "summary": "Post data to httpbin.org/post",
        "description": "Sends a POST request to httpbin.org/post with data, including any custom headers.",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"   

                  },
                  "address": {
                    "type": "string"
                  },
                  "gender": {
                    "type": "string"   
                  }
                },
                "required": [
                  "name",
                  "address",
                  "gender"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response from httpbin.org",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid request body"
          }
        }
      }
    }
  }
}

Crear un conector personalizado y validar el servicio

Debes crear un conector personalizado y, a continuación, validar el servicio web usándolo en una conexión de Application Integration.

Antes de empezar

Configura Private Service Connect (PSC) en esta máquina virtual y, a continuación, crea una vinculación de endpoint.

Crear un conector personalizado

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

    Ir a la página Conectores personalizados

  2. Haz clic en Crear para abrir la página Crear conector personalizado.
  3. En la sección Detalles del conector, especifica los campos obligatorios, como Nombre del conector y Nombre visible.Además, indica los casos prácticos del conector en el campo Descripción.
  4. Configurar el destino del conector para el acceso al backend: habilita esta opción. Se mostrarán las secciones de configuración adicionales de la página.
  5. Cuenta de servicio: selecciona una cuenta de servicio que tenga los roles necesarios.
  6. Logotipo: suba una imagen a un segmento de Cloud Storage para usarla como logotipo del conector.
  7. En la sección Connector Specification (Especificación del conector), introduce la URL pública de tu especificación de API abierta o sube el archivo de especificación a un bucket de Cloud Storage.
  8. En la sección Connector Destination (Destino del conector), añade la dirección IP del adjunto del endpoint y el puerto en el que se ejecuta el servicio.
  9. En la sección Connector Authentication (Autenticación del conector), selecciona No Authentication (Sin autenticación). Los tipos de autenticación no se admiten en los conectores de Marketplace.
  10. En la sección Variables de backend, añade las variables que quieras usar como entrada al crear la conexión. Estas variables aparecen en la página de creación de la conexión y se envían en cada llamada a la API que se hace al servicio. En esta sección se deben añadir los valores que no cambien con las APIs, como las credenciales de backend de terceros.
  11. Crea el conector personalizado. Asegúrate de haber especificado un logotipo y descrito los casos prácticos del conector personalizado.

Crear una conexión

Después de crear el conector personalizado, crea la conexión para este conector.

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

    Ve a la página Conexiones.

  2. Haz clic en Crear para abrir la página Crear conexión.
  3. Selecciona el conector personalizado que has creado.
  4. Añada valores para los campos de conexión que haya definido.
  5. Crea la conexión.

Validar el servicio

Para validar el servicio, crea una integración.

  1. En la Google Cloudconsola, ve a la página Integración de aplicaciones y, a continuación, crea una integración.
  2. Añade un activador de API y la tarea del conector.
  3. Configura la tarea del conector para que use la conexión que has creado en el paso anterior. Añada Data Mapper si es necesario.
  4. Configura el connectorInputPayload del conector según el esquema.
  5. Ejecuta la integración para verificar que la conexión funciona.

Si la integración se ejecuta correctamente y devuelve la respuesta esperada, el servicio web se valida.

Siguientes pasos