Connessione a Microsoft SharePoint

Modifica online

Microsoft SharePoint è una potente piattaforma di collaborazione e gestione dei documenti che consente ai team di archiviare, organizzare, condividere e accedere alle informazioni in modo sicuro da qualsiasi dispositivo. L'integrazione di SharePoint con IBM watsonx Orchestrate consente di automatizzare i flussi di lavoro relativi ai documenti, sincronizzare i contenuti e ottimizzare la collaborazione aziendale.

Per integrare Microsoft SharePoint con IBM watsonx Orchestrate, è necessario stabilire una connessione sicura che consenta a entrambi i sistemi di comunicare senza interruzioni. Per indicazioni generali sulla gestione delle integrazioni, consultare la sezione "Collegamento delle app per gli agenti predefiniti ".

Importante:

Per impostazione predefinita, il Single Sign-On (SSO) è disattivato per la tua app. Per abilitarlo, consultare la sezione "Configurazione del Single Sign-On per le applicazioni".

Passaggi per la connessione

Per collegare Microsoft SharePoint a watsonx Orchestrate, procedere come segue:

Vai su Gestisci > Connessioni e cerca l 'ID connessione Microsoft SharePoint corrispondente.
Fare clic su modifica accanto all'ID di connessione corrispondente.
Seleziona il metodo di autenticazione utilizzato dalla tua organizzazione ( autenticazione a più fattori OAuth, autenticazione a più fattori 2.0, autenticazione multipla o coppia chiave-valore ).
Inserisci i dati nei campi specifici di Microsoft SharePoint. Per informazioni sul flusso di lavoro generale relativo alla connessione, consultare la pagina "Connessione delle app per agenti predefiniti".
Completa i passaggi relativi alla bozza e alla configurazione live.
Salva e verifica la connessione per confermare che sia stata stabilita correttamente.

Metodi di autenticazione supportati

Microsoft SharePoint supporta i seguenti tipi di autenticazione in watsonx Orchestrate :

OAuth2 Codice di autorizzazione : consigliato per connessioni di produzione
Multi Auth : supporta sia il codice di autorizzazione OAuth2 che le credenziali client OAuth2
Coppia chiave-valore : supportata per scenari basati su chiave API e legacy

Nota:

Per gli agenti creati dopo settembre 2025, l'autenticazione tramite OAuth 2.0 è l'unica supportata per Microsoft SharePoint.

ID connessione

Utilizza i seguenti ID di connessione quando individui la tua connessione Microsoft SharePoint nella pagina delle impostazioni delle connessioni. Per capire come cercare un ID connessione e aprire una connessione per la modifica, consulta Collegamento di app per agenti predefiniti.


Tipo di autenticazione	ID connessione
OAuth2 Codice di autorizzazione	`microsoft_oauth2_auth_code_ibm_184bdbd3`
Multi Auth (codice di autorizzazione OAuth2 e credenziali client OAuth2 )	`microsoft_ibm_184bdbd3`
Coppia chiave-valore	`microsoft_key_value_ibm_184bdbd3` (obsoleto)

OAuth 2.0 dettagli di connessione

Se la tua organizzazione utilizza l'autenticazione basata su OAuth, imposta il tipo di autenticazione su Codice di autorizzazion OAuth2 e inserisci i seguenti campi:


Campo	Descrizione
`Server URL`	Base URL del server Microsoft. Ad esempio, `https://graph.microsoft.com`
`Token URL`	Endpoint per scambiare il codice di autorizzazione con un token di accesso. Ad esempio, `https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/token`
`Scope`	Specificare offline_access. Definisce il livello di accesso richiesto. È possibile includere altri elementi dell'ambito, separati da spazi. Ad esempio, `https://graph.microsoft.com/.default`
`Authorization URL`	URL dove gli utenti vengono reindirizzati per effettuare il login e autorizzare l'accesso. Ad esempio, `https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/authorize`
`Client ID`	ID univoco per la tua applicazione (disponibile nell'interfaccia utente Microsoft)
`Client Secret`	Una chiave segreta utilizzata per autenticare la tua app con Microsoft

Per ottenere questi valori, consultare la documentazione delle API Microsoft.

Dettagli della connessione Multi Auth

Imposta il tipo di autenticazione su "Codice di autorizzazion OAuth2 " o "Credenziali client OAuth2 " e inserisci i seguenti campi:

OAuth2 Codice di autorizzazione


Campo	Descrizione
`server_url`	Base URL dell'API Microsoft Graphs. Ad esempio, `https://graph.microsoft.com`
`token_url`	Endpoint per scambiare il codice di autorizzazione con un token di accesso. Sostituisci TENANT_ID con il tuo ID directory (tenant). Ad esempio, `https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/token`
`scope`	Specificare offline_access e altri ambiti secondo necessità, separati da spazi. L'ambito definisce il livello di accesso richiesto. Ad esempio, `https://graph.microsoft.com/`
`authorization_url`	URL dove gli utenti vengono reindirizzati per effettuare il login e autorizzare l'accesso. Sostituisci TENANT_ID con il tuo ID directory (tenant). Ad esempio, `https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/authorize`
`client_id`	Un identificatore univoco per la tua applicazione (disponibile nel portale Microsoft)
`client_secret`	La chiave segreta utilizzata per autenticare la tua app con Microsoft
`Token request field`	Viene utilizzato per includere parametri aggiuntivi necessari al server di autorizzazione durante lo scambio di un codice o delle credenziali per un token di accesso. Sono necessari per implementazioni personalizzate in cui il server richiede dettagli aggiuntivi, come un codice di verifica o un ID risorsa.
`Auth request field`	Viene utilizzato per fornire informazioni aggiuntive durante la fase di accesso all'endpoint di autorizzazione OAuth. Aiutano il server a identificare il tenant o il provider di identità corretto e sono essenziali per le configurazioni che richiedono parametri personalizzati come `idp` o `tenant_id`

OAuth2 Credenziali del cliente


Campo	Descrizione
`Server URL`	Si riferisce alla base URL del server che ospita le risorse protette
`Send Credentials Via`	Specificare come vengono inviate le credenziali (intestazione o corpo)
`Token URL`	Specificare il valore del token URL relativo al server URL. Il token di accesso ( URL ) viene solitamente fornito dal server di autorizzazione durante la registrazione dell'applicazione
`Client ID`	Un identificatore univoco per l'applicazione client. Ottieni l'ID cliente dall'interfaccia utente del tuo account
`Client Secret`	Una chiave segreta conosciuta solo dal cliente e dal server di autorizzazione
`Grant Type`	Il tipo di concessione è sempre "client_credentials". Indica il server di autorizzazione a cui il client richiede un token di accesso utilizzando il flusso delle credenziali client
`Scope`	Lo scope è un modo per limitare l'accesso. Definisce le autorizzazioni o le risorse specifiche a cui è consentito l'accesso. Ad esempio, profilo di lettura/scrittura
`Token request field`	Viene utilizzato per includere parametri aggiuntivi necessari al server di autorizzazione durante lo scambio di un codice o delle credenziali per un token di accesso. Sono necessari per implementazioni personalizzate in cui il server richiede ulteriori dettagli, come un codice di verifica o un ID risorsa

Dettagli di connessione della coppia chiave-valore

Se la tua organizzazione utilizza l'autenticazione basata su OAuth, imposta Tipo di autenticazione su Coppia chiave-valore e aggiungi ciascuno dei seguenti campi utilizzando Aggiungi nuovo campo :


Chiave	Descrizione
`client_id`	L'ID client dell'applicazione Microsoft registrata
`client_secret`	Il segreto del client associato all'applicazione Microsoft
`username`	Il nome utente dell'account SharePoint (in genere l'indirizzo e-mail)
`password`	La password per l'account SharePoint o la password specifica dell'applicazione
`authority`	L'autorità URL per l'autenticazione, ad esempio, `https://login.microsoftonline.com`
`base_url`	La base URL per Microsoft, ad esempio, `https://login.microsoftonline.com`

Per ottenere questi valori, consultare la documentazione delle API Microsoft.

Cosa fare successivamente

Ora che la connessione della tua app è attiva, puoi iniziare a utilizzarla su watsonx Orchestrate.

Esegui un agente in Orchestrate Chat per completare le attività utilizzando il linguaggio naturale.
Utilizza gli strumenti appropriati per eseguire operazioni specifiche dell'app.