Condividi tramite

Connettore Microsoft Graph di Confluence Cloud

  • Articolo

Il connettore Microsoft Graph di Confluence Cloud consente all'organizzazione di indicizzare il contenuto di Confluence. Dopo aver configurato i dati del connettore e dell'indice dal sito di Confluence, gli utenti finali possono cercare tali contenuti in Microsoft Search e Microsoft 365 Copilot.

Questo articolo è destinato agli amministratori di Microsoft 365 responsabili della configurazione, dell'esecuzione e del monitoraggio del connettore Microsoft Graph di Confluence Cloud. Integra le istruzioni generali fornite nella configurazione dei connettori di Microsoft Graph nel interfaccia di amministrazione di Microsoft 365.

Vantaggi

  • Funzionalità di ricerca avanzate: gli utenti possono porre domande in linguaggio naturale sul contenuto wiki in Copilot, ad esempio:
    • Riepilogare il documento sull'architettura
    • Come ottenere l'accesso a un portale
  • Supporto per la ricerca semantica: gli utenti possono eseguire query in linguaggio naturale per ottenere risposte accurate.

Prerequisiti

  1. È necessario essere l'amministratore per il tenant microsoft 365 dell'organizzazione e l'amministratore per il sito Confluence dell'organizzazione.
  2. Autenticazione: assicurarsi di disporre delle credenziali di autenticazione con l'accesso corretto.

Limitazioni

  • Non indicizzare i file o i commenti degli allegati.

Importante

  • Atlassian sta deprecato un set di API cloud confluence (versione V1) e rilascia nuove API (versione V2). È possibile leggere i loro annunci qui o qui. Alcune di queste API deprecate v1 vengono usate dal connettore solo per le connessioni OAuth . Di conseguenza, pubblicare questa modifica le connessioni confluence esistenti potrebbero smettere di funzionare. Questa modifica è pianificata per il 24 gennaio.
  • La modifica alla migrazione alle nuove API v2 è stata rilasciata a tutti i clienti a dicembre 2023. Dopo questa versione, è necessario riautenticare le connessioni esistenti. Le nuove API v2 richiedono anche altri ambiti (rispetto alle API v1 precedenti) che devono essere forniti durante la nuova autenticazione. Nuovo set di ambiti necessari (elenco completo): read:group:confluence, , read:content-details:confluenceread:user:confluence, Read:space:confluence, Read:permission:confluence, read:audit-log:confluenceread:content.metadata:confluence e read:page:confluence.

Per iniziare

Questo video offre una guida dettagliata all'aggiunta del connettore Microsoft Graph di Confluence Cloud.

1. Nome visualizzato

Un nome visualizzato viene usato per identificare ogni riferimento in Copilot, consentendo agli utenti di riconoscere facilmente il file o l'elemento associato. Il nome visualizzato indica anche contenuto attendibile. Il nome visualizzato viene usato anche come filtro dell'origine di contenuto. Per questo campo è presente un valore predefinito, ma è possibile personalizzarlo in base a un nome riconosciuto agli utenti dell'organizzazione.

2. URL del cloud di confluenza

Per connettersi al sito di Confluence, usare l'URL del sito. Un URL del sito cloud di Confluence è in genere simile a https://< organization_name.atlassian.net/>.

3. Tipo di autenticazione

Per autenticare e sincronizzare il contenuto da Confluence On-prem, scegliere uno dei due metodi supportati:

Consiglio

Assicurarsi che l'account del servizio disponga dell'accesso di visualizzazione al contenuto di Confluence da indicizzare.

a. Autenticazione di base
Per eseguire l'autenticazione usando l'autenticazione di base, immettere il nome utente (in genere il messaggio di posta elettronica) e il token API. Per informazioni sulla generazione di un token API, vedere la guida di Atlassian.

b. OAuth 2.0 (scelta consigliata)
Registrare un'app in Confluence Cloud in modo che l'app Microsoft Search e Microsoft 365 Copilot possano accedere all'istanza. Per altre informazioni, vedere la documentazione del supporto di Atlassian su come abilitare OAuth 2.0.

La procedura seguente fornisce indicazioni su come registrare l'app:

  1. Accedere alla console di atlassian developer con l'account amministratore di Atlassian Confluence.

  2. Fare clic su Crea e selezionare OAuth 2.0 integration.

  3. Specificare un nome appropriato per l'applicazione e creare la nuova app.

  4. Passare a Permissions dal riquadro di spostamento a sinistra. Fare clic su Aggiungi per Confluence API. Dopo l'aggiunta, fare clic su Configura e Modifica ambiti e selezionare gli ambiti seguenti.

    Nome ambito Codice Descrizione
    Visualizzare i dettagli del contenuto read:content-details:confluence Eseguire la ricerca per indicizzazione del contenuto soddisfacendo i criteri.
    Visualizzare i gruppi read:group:confluence Per accedere alle autorizzazioni di gruppo del contenuto.
    Visualizzare i dettagli utente read:user:confluence Per accedere ai dettagli dei singoli utenti per supportare le autorizzazioni.

  5. Fare clic su Salva.

  6. Passare a Authorization dal riquadro di spostamento a sinistra. Aggiungere l'URL di callback, per Microsoft 365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, per Microsoft 365 Per enti pubblici e https://gcsgcc.office.com/v1.0/admin/oauth/callback salvare le modifiche.

  7. Passare a Impostazioni dal riquadro di spostamento a sinistra. È possibile ottenere l'ID client e il segreto da questa pagina.

    Completare il passaggio delle impostazioni di connessione usando l'ID client e il segreto.

6. Implementazione a un pubblico limitato

Distribuire questa connessione in una base di utenti limitata se si vuole convalidarla in Copilot e in altre aree di ricerca prima di espandere l'implementazione a un pubblico più ampio. Per altre informazioni sull'implementazione limitata, fare clic qui.

A questo punto, si è pronti per creare la connessione per ServiceNow Knowledge. È possibile fare clic sul pulsante "Crea" e il connettore Microsoft Graph di Confluence Cloud avvia l'indicizzazione dall'account Confluence.

Per altre impostazioni, ad esempio autorizzazioni di accesso, regole di inclusione dei dati, schema, frequenza di ricerca per indicizzazione e così via, vengono impostate le impostazioni predefinite in base a ciò che funziona meglio con i dati di Confluence. I valori predefiniti sono i seguenti:

Utenti  
Autorizzazioni di accesso Solo gli utenti con accesso al contenuto nell'origine dati.
Identità mappa Identità dell'origine dati mappate tramite ID Microsoft Entra.
Contenuto  
Includi/Escludi spazio Tutto
Gestisci proprietà Per controllare le proprietà predefinite e il relativo schema, fare clic qui
Sincronizzazione  
Ricerca per indicizzazione incrementale Frequenza: ogni 15 minuti
Ricerca per indicizzazione completa Frequenza: ogni giorno

Se si desidera modificare uno di questi valori, è necessario scegliere l'opzione Custom Setup .

Configurazione personalizzata

L'installazione personalizzata è destinata agli amministratori che vogliono modificare i valori predefiniti per le impostazioni elencate nella tabella predefinita. Dopo aver fatto clic sull'opzione Custom Setup , vengono visualizzate altre tre schede: Utenti, Contenuto e Sincronizzazione.

Utenti

Autorizzazioni di accesso

Il connettore Microsoft Graph di Confluence Cloud supporta le autorizzazioni di ricerca visibili a tutti o solo agli utenti con accesso a questa origine dati. Se si sceglie Tutti, i dati indicizzati vengono visualizzati nei risultati della ricerca per tutti gli utenti. Se si sceglie Solo gli utenti con accesso a questa origine dati, i dati indicizzati vengono visualizzati nei risultati della ricerca per gli utenti che hanno accesso a tale origine. In Confluence Cloud le autorizzazioni di sicurezza per utenti e gruppi vengono definite usando le autorizzazioni di spazio e le restrizioni delle pagine. Le restrizioni a livello di pagina, se presenti, hanno la precedenza sulle autorizzazioni di spazio.

Se non sono presenti restrizioni di pagina, il connettore verifica la presenza di autorizzazioni a livello di spazio -

  • Nel caso in cui lo spazio disponga dell'accesso "utenti anonimi" abilitato, il contenuto è visibile a tutti gli utenti all'interno del tenant.
  • Se l'accesso anonimo non è abilitato, le autorizzazioni a livello di spazio non vengono rispettate.
  • Nel caso in cui le autorizzazioni a livello di spazio non siano definite, il contenuto non è visibile ad alcun utente nel tenant.

Importante

Le autorizzazioni vengono gestite solo a livello di spazio e pagina e le autorizzazioni della pagina padre non vengono prese in considerazione.

Se si sceglie Solo gli utenti con accesso a questa origine dati, è necessario scegliere ulteriormente se il sito di Confluence ha Microsoft Entra ID utenti con provisioning o utenti non AAD.

Per identificare l'opzione adatta all'organizzazione:

  1. Scegliere l'opzione Microsoft Entra ID se l'ID di posta elettronica degli utenti di Confluence è uguale all'UPN (UserPrincipalName) degli utenti in Microsoft Entra ID.
  2. Scegliere l'opzione non AAD se l'ID di posta elettronica degli utenti di Confluence è diverso da UserPrincipalName (UPN) degli utenti in Microsoft Entra ID.

Nota

  • Se si sceglie Microsoft Entra ID come tipo di origine identità, il connettore esegue il mapping degli ID di posta elettronica degli utenti ottenuti da Confluence direttamente alla proprietà UPN da Microsoft Entra ID.
  • Se si sceglie "Non-AAD" per il tipo di identità, vedere Eseguire il mapping delle identità non Azure AD per istruzioni sul mapping delle identità. È possibile usare questa opzione per fornire l'espressione regolare di mapping dall'ID di posta elettronica all'UPN.
  • Aggiornamenti agli utenti o ai gruppi che controllano le autorizzazioni di accesso vengono sincronizzati solo in ricerche per indicizzazione complete. Le ricerche per indicizzazione incrementali non supportano attualmente l'elaborazione degli aggiornamenti alle autorizzazioni.

Contenuto

Includere o escludere i dati da indicizzare

Con una stringa CQL (Confluence Query Language), è possibile specificare le condizioni per la sincronizzazione delle pagine. È come una clausola Where in un'istruzione SQL Select . Ad esempio, è possibile scegliere di indicizzare solo le pagine modificate negli ultimi due anni. Per informazioni sulla creazione di una stringa di query personalizzata, vedere Ricerca avanzata con CQL. Il connettore indicizza tutti i blog e le pagine per impostazione predefinita.

Consiglio

È possibile usare il filtro CQL per indicizzare il contenuto modificato dopo un determinato periodo di tempo usando lastModified >= "12/2018/31"

Usare il pulsante dei risultati dell'anteprima per verificare i valori di esempio delle proprietà selezionate e della stringa CQL.

Gestire le proprietà

In questo passaggio è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati Confluence. Alcune proprietà sono selezionate per impostazione predefinita. L'elenco delle proprietà selezionate qui può influire su come filtrare, cercare e visualizzare i risultati in Microsoft 365 Copilot.

Proprietà source Etichetta Descrizione
Autori authors Nome delle persone che hanno partecipato o collaborato all'elemento nell'origine dati.
CreatedByName createdBy Nome della persona che ha modificato l'elemento più di recente nell'origine dati.
CreatedOn createdDateTime Data e ora di creazione dell'elemento nell'origine dati.
IconUrl iconUrl URL dell'icona associato dell'elemento.
Titolo title Titolo dell'elemento che si vuole visualizzare nella ricerca e in altre esperienze.
UpdatedByName lastModifiedBy Nome della persona che ha modificato l'elemento più di recente nell'origine dati.
UpdatedOn lastModifiedDateTime Data e ora dell'ultima modifica dell'elemento nell'origine dati.
Url url URL di destinazione dell'elemento nell'origine dati.

Anteprima dei dati

Usare il pulsante dei risultati dell'anteprima per verificare le proprietà e i filtri selezionati.

Sincronizza

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore Microsoft Graph di Confluence Cloud. Esistono due tipi di intervalli di aggiornamento: ricerca per indicizzazione completa e ricerca per indicizzazione incrementale. Per altri dettagli, fare clic qui. È possibile modificare i valori predefiniti dell'intervallo di aggiornamento da qui, se si vuole.

Esaminare e testare la connessione

Per Ms Search, se è necessario personalizzare la pagina dei risultati della ricerca. Per informazioni sulla personalizzazione dei risultati della ricerca, vedere Personalizzare la pagina dei risultati della ricerca.

In caso di problemi o se si desidera fornire commenti e suggerimenti, contattare Microsoft Graph | Supporto.