Creazione e gestione delle connessioni

Modifica online

È possibile creare e gestire le connessioni in watsonx Orchestrate per definire le modalità di autenticazione degli strumenti con le applicazioni esterne. Dalle impostazioni di connessione è possibile configurare il metodo di autenticazione, assegnare il modello di credenziali appropriato e impostare i valori per l'ambiente di prova e quello di produzione, in modo che gli strumenti possano accedere ai sistemi di terze parti in modo sicuro e coerente. Una connessione include anche un proprio identificatore, i metadati e la configurazione delle credenziali; è inoltre possibile riutilizzare una connessione su più strumenti che interagiscono con la stessa applicazione.

Le operazioni riportate di seguito descrivono come accedere, creare, aggiornare e gestire le impostazioni di connessione e le credenziali.

Accedere alle impostazioni di connessione

Per gestire le connessioni e le credenziali della tua app:

  1. Dal menu principale, seleziona Gestisci > Connessioni.

  2. Viene visualizzato un elenco delle connessioni configurate.

  3. Si apre la pagina delle impostazioni di connessione, dove è possibile gestire sia le connessioni che le credenziali:

    1. Connessioni : è possibile aggiungere e configurare connessioni per integrarle con le proprie applicazioni.

    2. Credenziali : puoi visualizzare e gestire le credenziali salvate (personali o condivise) da utilizzare sia in ambiente di prova che in produzione.

Aggiungere una nuova connessione

È possibile creare connessioni sia in ambiente di prova che in ambiente di produzione. L'ambiente di prova è destinato ai test e alla fase di staging, mentre l'ambiente di produzione riflette le configurazioni pronte per la produzione. Questa configurazione duale ti consente di verificare le integrazioni in modo sicuro prima di implementarle in produzione.

Per aggiungere una nuova connessione:

  1. Nella pagina Impostazioni di connessione, fare clic su Aggiungi nuova connessione.

  2. Nella sezione " Definisci dettagli connessione ", inserisci un ID connessione e un nome visualizzato.

Utilizza una convenzione di denominazione chiara e descrittiva per l 'ID connessione, in modo che tu e il tuo team possiate identificarla facilmente in seguito.

Struttura consigliata per l'ID connessione :

  • Inizia con il nome della tua organizzazione (ad esempio, IBM ).

  • Inserisci il nome dell'applicazione (ad esempio, Salesforce, Box).

  • Inserire il tipo di autenticazione (ad esempio, OAuth2, Basic).

  • Se lo si desidera, è possibile aggiungere ulteriori informazioni, come il tipo di sovvenzione, l'ambiente o un identificatore interno.

Esempio :

Se la tua organizzazione si trova all'indirizzo IBM, stai effettuando l'integrazione con Salesforce utilizzando il codice di autorizzazione OAuth 2.0 e desideri contrassegnare la connessione per l'utilizzo da parte dei team, puoi assegnare il seguente nome all'ID connessione: ibm_salesforce_oauth2code_wxoconnectionteams

Puoi utilizzare lo stesso valore per il "Nome visualizzato " oppure scegliere un nome più breve e più intuitivo. Ad esempio, Salesforce OAuth2 (Teams)

  1. Fare clic su Avanti.

  2. Configura la connessione provvisoria :

  3. Configura la connessione in tempo reale :

    • Incolla la bozza di configurazione oppure definisci una nuova configurazione.

Suggerimento:

È possibile incollare la bozza di configurazione nell'ambiente di produzione solo per i seguenti tipi di autenticazione: chiave API, autenticazione di base, token Bearer e OAuth. Per OAuth, i tipi di autorizzazione supportati sono: codice di autorizzazione, credenziali del cliente, implicito, password e per conto di. Il tipo di credenziale "coppia chiave-valore" non è supportato per l'incollaggio da bozza a versione definitiva. È necessario inserire manualmente i valori nella configurazione in tempo reale.

  • Se necessario, clicca su "Reimposta" per cancellare tutti i campi

  1. Fai clic su "Aggiungi connessione".

  2. L'icona Connesso indica che la connessione è stata stabilita con successo.

Importante:

Una volta configurato l'ambiente Live, il tipo di autenticazione diventa fisso e non può essere modificato tramite l'interfaccia utente. Questa restrizione si applica sia all'ambiente di prova che a quello di produzione. Per modificare il tipo di autenticazione dopo aver configurato l'ambiente Live, è necessario utilizzare l 'Agent Development Kit (ADK). Non è possibile apportare modifiche tramite l'interfaccia utente.

Indicatori dello stato della connessione

Dopo aver creato una connessione, nella pagina delle impostazioni "Connessioni" viene visualizzata un'icona di stato per ogni ambiente, sia in fase di bozza che in produzione. Queste icone indicano la configurazione attuale e lo stato di autenticazione della connessione.

  • L'icona Connesso indica che l'ambiente è connesso.

La configurazione e le credenziali per quell'ambiente sono complete e la connessione viene autenticata correttamente.

  • L'icona Connessione in attesa indica che l'ambiente si trova in uno stato di connessione in sospeso.

L'ambiente è configurato, ma la connessione non è stata autenticata. Questa situazione è dovuta a metadati non validi, credenziali errate o autorizzazione mancante.

  • L'icona Configurazione in sospeso indica che l'ambiente è in attesa di configurazione

L'ambiente è incompleto o non è stato convalidato. Mancano ancora alcuni campi obbligatori o credenziali.

Questi indicatori vengono visualizzati direttamente nell'elenco delle connessioni, consentendo di vedere a colpo d'occhio lo stato di ciascun ambiente per ogni connessione.

Filtraggio delle connessioni

I collegamenti sono suddivisi in tre categorie: Personalizzati, Conoscenze e Predefiniti. È possibile passare da una categoria all'altra cliccando sulla scheda corrispondente nella parte superiore dell'elenco delle connessioni.

Per filtrare le connessioni all'interno di una categoria:

  1. Nella pagina Impostazioni di connessione, clicca Filtro sull'icona.

  2. Scegli una o più categorie di filtri :

    • Stato della connessione alla bozza : filtra le connessioni in base al fatto che l'ambiente della bozza sia configurato o meno.

    • Stato della connessione Live : filtra le connessioni in base al fatto che l'ambiente Live sia configurato o meno.

    • Tipo di autenticazione Draft : filtra le connessioni in base al metodo di autenticazione utilizzato nell'ambiente Draft.

    • Tipo di autenticazione Live : filtra le connessioni in base al metodo di autenticazione utilizzato nell'ambiente Live.

    Per i collegamenti tra entità, sono disponibili solo i filtri relativi allo stato "Bozza" e al tipo di autenticazione "Bozza", con una serie limitata di tipi di autenticazione. I filtri relativi allo stato in tempo reale e al tipo di autenticazione in tempo reale non sono applicabili alle connessioni di conoscenza.

  3. Clicca su "Applica filtro" per aggiornare i risultati.

  4. Fai clic su "Cancella filtro" per rimuovere tutti i filtri applicati.

Puoi anche utilizzare il campo di ricerca per trovare una connessione digitando parte del suo ID connessione o del nome visualizzato. La ricerca funziona indipendentemente dai filtri ed è possibile utilizzarla prima o dopo aver applicato i criteri di filtro.

Modifica di una connessione

È possibile aggiornare una connessione esistente in qualsiasi momento per riflettere le modifiche apportate alla configurazione o alle credenziali.

  1. Nella pagina delle impostazioni di connessione, clicca sull'icona di modifica accanto all'app.

  2. Fare clic su Modifica.

  3. Aggiorna le schede "Bozza" e "Pubblicata".

  4. Fai clic su «Salva modifiche» e applica gli aggiornamenti.

Una volta creata, non è possibile rinominare una connessione né modificarne il tipo di autenticazione.