Come configurare un connettore

Capire i dettagli della configurazione di un connettore in Tulip.

In questo articolo imparerete* Come configurare un connettore* Cosa significa ogni input nella maschera di configurazione

Panoramica

I connettori consentono l'integrazione tra sistemi e database esterni. In questo articolo discuteremo due tipi di connettori: HTTP e SQL.

Consultate l'articolo "Che cosa sono i connettori?", per sapere esattamente quali concetti e dettagli comprende un connettore.

Come configurare un nuovo connettore

La configurazione di un nuovo connettore non richiede una conoscenza approfondita delle API o dei database, ma è utile avere familiarità con i tipi di connessione.

Per creare un connettore, andare alla pagina Connettori sotto App. Fare clic su + Crea connettore nell'angolo in alto a destra. Assegnare un nome e una descrizione al connettore, quindi scegliere se si tratta di una connessione HTTP o SQL. Ricordate: un connettore HTTP si integra con un server API, mentre un connettore SQL si collega a un database esterno.

Dopo aver fatto clic sul pulsante Crea nella maschera Crea connettore, si accede alla homepage del connettore in questione.

Qui si noterà una notifica rossa che indica che il connettore è attualmente offline.

Affinché il connettore sia online, è necessario fare clic sul pulsante Produzione e test e sviluppo per specificare il server a cui ci si vuole connettere.

Cosa sapere prima

Prima di iniziare, è importante notare che sia i connettori HTTP che quelli SQL hanno parametri di autenticazione per garantire che chiunque faccia una richiesta a un endpoint o a un database abbia il permesso di farlo. Queste misure sono state adottate per proteggere i dati e garantire un accesso sicuro.

Le sezioni seguenti illustrano come configurare i connettori HTTP e SQL.

HTTP

Un connettore HTTP parla con i server API. I connettori HTTP di Tulip si interfacciano con la maggior parte dei tipi di API, tra cui REST e SOAP.

Configurazione

Per configurare un connettore, è necessario avere a portata di mano un paio di informazioni sul server a cui si sta cercando di connettersi. Queste includono:

• L'URL dell'host
• Se il server utilizza o meno un TLS
• Qualsiasi intestazione o Cert necessaria per l'autenticazione.

Queste informazioni si possono trovare nella documentazione API del server a cui ci si sta connettendo. In genere è necessario cercare "[nome del server] documentazione API".

Vediamo come procedere alla configurazione:

Modalità di configurazione

Running On - Effettua le richieste per l'host del connettore. L'host del Cloud Connector è fornito da Tulip e fa richieste tramite Tulip Cloud. Apparirà anche qualsiasi host del connettore on-premise che avete registrato nel vostro account.Host - L'indirizzo di rete, cioè un nome di host o un indirizzo IP, a cui Tulip si connette.Porta - Il vostro server ascolta le richieste su una porta di rete specifica, fornita dal vostro fornitore di server. Quella predefinita va quasi sempre bene.TLS (Transport Layer Security) - Tulip utilizza un TLS per criptare il traffico durante la connessione al server. Se l'url inizia con https, si tratta di TLS.

Autenticazione

{Fornisce l'autenticazione dell'origine dei dati, l'integrità dei dati e la protezione da replay.**Certificati ({****{glossary.**Certificate}}) - Un certificato del server viene inviato dal server al client all'inizio di una sessione e viene utilizzato dal client per autenticare il server.

Per i connettori HTTP sono disponibili i seguenti tipi di autenticazione:

No Auth - Non è necessaria alcuna autenticazione o l'autenticazione è contenuta in altre intestazioni della richiesta, come x-auth-token.Basic Auth - Autenticazione di base, condivide il nome utente e la password.OAuth 2 (Bearer token) - I bearer token sono il tipo di token di accesso predominante, consistono in una stringa opaca, che non è destinata ad avere un significato per i client che la utilizzano.OAuth 2 (Operator) - Tipicamente utilizzato per i client che richiedono l'accesso a un insieme limitato di risorse per conto di un utente. Ad esempio, un'applicazione mobile che richiede l'accesso ai contatti o agli eventi del calendario di un utente. Questo ruolo garantisce al client l'accesso solo a un sottoinsieme specifico di risorse e l'utente deve concedere esplicitamente il permesso di accedere a tali risorse.OAuth 2 (Admin) - Utilizzato per i client che richiedono l'accesso a una gamma più ampia di risorse o di funzioni amministrative. Questo ruolo garantisce al client un accesso esteso all'account e alle risorse dell'utente. Ad esempio, un client con accesso OAuth 2 (Admin) può essere in grado di gestire le impostazioni dell'account di un utente, creare o eliminare risorse o eseguire altre attività amministrative.OAuth 1.0 - Versione precedente di OAuth che gestisce principalmente i flussi di lavoro web.

:::(Info) (NOTA) È possibile configurare le intestazioni e i certificati in un secondo momento. Le intestazioni possono essere configurate anche nella funzione connettore:

Per saperne di più sui connettori HTTP, consultare una panoramica dei connettori HTTP.

SQL

Un connettore SQL parla con database esterni. L'impostazione del connettore è abbastanza semplice, ma è necessario avere a portata di mano alcune informazioni per rendere l'operazione rapida e senza intoppi.

Configurazione

Per configurare un connettore SQL, sono necessarie le seguenti informazioni:
* Il tipo di database SQL * L'URL del server * Se il server utilizza o meno un TLS * Il nome utente e la password per l'autenticazione

Vediamo come procedere alla configurazione:

Modalità di configurazione

Running On - Effettua le richieste per l'host del connettore. L'host del Cloud Connector è fornito da Tulip e fa richieste tramite Tulip Cloud. Apparirà anche qualsiasi host del connettore on-premise registrato nel vostro account.Tipo - Il tipo di database SQL a cui volete connettervi. Scegliete tra Microsoft SQL Server, MySQL, PostgreSQL o OracleDB.Server - L'indirizzo di rete, un nome di host o un indirizzo IP, a cui Tulip si connette.Porta - Il vostro server ascolta le richieste su una porta di rete specifica, fornita dal vostro fornitore di server.SSL (Secure Sockets Layer) - Utilizzato per crittografare le connessioni tra le vostre applicazioni client e le istanze che eseguono il serverDatabase - Il nome del vostro databaseUtente - Nome utente per il databasePassword - Password per il database

Autenticazione

Il processo di autenticazione per SQL richiede le credenziali di accesso del nome utente e della password del database a cui ci si vuole connettere.

Per ulteriori informazioni sui connettori SQL, consultare [Panoramica sui connettori SQL].

Messa in linea del connettore

Una volta inseriti correttamente tutti i campi, fare clic sul pulsante Test in basso a destra della finestra di configurazione. Il connettore impiega alcuni secondi per testare e certificare la connessione al server. Se le informazioni immesse durante la configurazione sono corrette, lo stato cambierà in Online.

Se il connettore appare ancora offline, rivedere le informazioni inserite e verificare che siano corrette.

Per ulteriori informazioni, consultare la guida Risoluzione dei problemi dei connettori.

Ulteriori letture

• Introduzione agli host del connettore Tulip

Avete trovato quello che cercavate?

Potete anche andare su community.tulip.co per porre la vostra domanda o vedere se altri hanno affrontato una domanda simile!