Creare un connettore personalizzato e una connessione

Questa pagina descrive come creare una specifica OpenAPI per un servizio web e quindi creare un connettore personalizzato e una connessione per questo connettore.

Prima di creare un connettore personalizzato, devi creare una specifica OpenAPI per il servizio web.

Crea una specifica OpenAPI per il servizio web

I connettori personalizzati supportano OpenAPI 3.0. Puoi anche creare manualmente la specifica. Per informazioni sulle specifiche OpenAPI, consulta le specifiche OpenAPI.

Puoi anche generare automaticamente la specifica OpenAPI 2.0 utilizzando il middleware gin swagger. Per informazioni, consulta Gin Swagger. Devi convertire la specifica OpenAPI 2.0 nella specifica OpenAPI 3.0 utilizzando Swagger Converter.

Specifica OpenAPI di esempio.

{
  "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"
          }
        }
      }
    }
  }
}

Crea un connettore personalizzato e convalida il servizio

Devi creare un connettore personalizzato e convalidare il servizio web utilizzandolo in una connessione in Application Integration.

Prima di iniziare

Configura Private Service Connect (PSC) per questa macchina virtuale e poi crea un collegamento di endpoint.

Creare un connettore personalizzato

  1. Nella console, vai alla pagina Connettori di integrazione > Connettori personalizzati, quindi seleziona o crea un progetto Google Cloud .

    Vai alla pagina Connettori personalizzati

  2. Fai clic su Crea nuovo per aprire la pagina Crea connettore personalizzato.
  3. Nella sezione Dettagli del connettore, specifica i campi obbligatori, ad esempio Nome connettore e Nome visualizzato.Inoltre, inserisci i casi d'uso per il connettore nel campo Descrizione.
  4. Configura la destinazione del connettore per l'accesso al backend: abilita questa opzione. Vengono visualizzate le sezioni di configurazione aggiuntive nella pagina.
  5. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
  6. Logo: carica un'immagine in un bucket Cloud Storage per utilizzarla come logo del connettore.
  7. Nella sezione Connector Specification (Specifiche del connettore), inserisci l'URL pubblico della specifica dell'API Open o carica il file della specifica in un bucket Cloud Storage.
  8. Nella sezione Destinazione del connettore, aggiungi l'indirizzo IP dell'attacco dell'endpoint e la porta su cui è in esecuzione il servizio.
  9. Nella sezione Autenticazione del connettore, seleziona Nessuna autenticazione. I tipi di autenticazione non sono supportati per i connettori del marketplace.
  10. Nella sezione Variabili di backend, aggiungi le variabili che vuoi utilizzare come input durante la creazione della connessione. Queste variabili vengono visualizzate nella pagina di creazione della connessione e inviate a ogni chiamata API effettuata al servizio. I valori che non cambieranno con le API, come le credenziali di backend di terze parti, devono essere aggiunti in questa sezione.
  11. Crea il connettore personalizzato. Assicurati di aver specificato un logo e descritto i casi d'uso per il connettore personalizzato.

Crea una connessione

Dopo aver creato il connettore personalizzato, crea la connessione per questo connettore.

  1. Nella console Cloud, vai alla pagina Connettori di integrazione > Connessioni, quindi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su Crea nuovo per aprire la pagina Crea connessione.
  3. Seleziona il connettore personalizzato che hai creato.
  4. Aggiungi i valori per i campi di connessione che hai definito.
  5. Crea la connessione.

Convalida il servizio

Per convalidare il servizio, crea una nuova integrazione.

  1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni e crea un'integrazione.
  2. Aggiungi l'attività del connettore e l'attivatore API.
  3. Configura l'attività del connettore in modo che utilizzi la connessione creata nel passaggio precedente. Aggiungi Data Mapper, se necessario.
  4. Configura il parametro connectorInputPayload per il connettore in base allo schema.
  5. Esegui l'integrazione per verificare che la connessione funzioni.

Se l'integrazione viene eseguita correttamente e restituisce la risposta prevista, il servizio web viene convalidato.

Passaggi successivi