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.

Questo articolo è destinato agli amministratori di Microsoft 365 o a tutti coloro che configurano, eseguono e monitorano un connettore Confluence Cloud. Integra le istruzioni generali fornite nell'articolo Configurare i connettori di Microsoft Graph nell'articolo interfaccia di amministrazione di Microsoft 365. Se non è già stato fatto, leggere l'intero articolo per comprendere il processo di configurazione generale.

Ogni passaggio del processo di installazione è elencato di seguito insieme a una nota che indica che è necessario seguire le istruzioni generali di configurazione o altre istruzioni che si applicano solo al connettore Confluence Cloud, incluse le informazioni sulla risoluzione dei problemi e sulle limitazioni.

Nozioni preliminari

È necessario essere l'amministratore per il tenant microsoft 365 dell'organizzazione e l'amministratore per il sito Confluence dell'organizzazione.

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, dopo questa modifica, le connessioni confluence esistenti potrebbero smettere di funzionare. Questa modifica è pianificata per il 24 gennaio.
  • La modifica per la migrazione alle nuove API v2 verrà rilasciata a tutti i clienti a dicembre 2023. Dopo questa versione, le connessioni esistenti dovranno essere riautenticate. Le nuove API v2 richiedono anche altri ambiti (rispetto alle API v1 precedenti) che dovranno 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.

Passaggio 1: Aggiungere un connettore nel interfaccia di amministrazione di Microsoft 365

Aggiungere il connettore cloud Confluence

Seguire le istruzioni di configurazione generali.

Passaggio 2: Assegnare un nome alla connessione

Seguire le istruzioni di configurazione generali.

Passaggio 3: Configurare le impostazioni di connessione

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/>. È possibile scegliere Autenticazione di base o OAuth 2.0 (scelta consigliata) per eseguire l'autenticazione nel sito di Confluence.

Consiglio

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

Autenticazione di base

Immettere il nome utente dell'account (in genere l'ID di posta elettronica) e il token API per l'autenticazione usando l'autenticazione di base. Per altre informazioni sulla generazione di un token API, vedere la documentazione di Atlassian su come gestire i token API per l'account Atlassian.

Registrare un'app in Confluence Cloud in modo che l'app Microsoft Search possa 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, Modifica ambiti e selezionare gli ambiti seguenti.
Nom de l'étendue Codice Descrizione
Visualizzare i dettagli del contenuto read:content-details:confluence Criteri di soddisfazione del contenuto della ricerca per indicizzazione
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
  1. Fare clic su Salva.
  2. Passare a Authorization dal riquadro di spostamento a sinistra. Aggiungere l'URL di callback per M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, per M365 Governmenthttps://gcsgcc.office.com/v1.0/admin/oauth/callback e salvare le modifiche.
  3. Passare a Settings dal riquadro di spostamento a sinistra. Si otterrà e Client IDSecret da questa pagina.

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

Passaggio 4: Selezionare le proprietà e filtrare i dati

In questo passaggio è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati Confluence. Microsoft 365 ha selezionato alcune proprietà per impostazione predefinita.

L'elenco delle proprietà selezionate può influire su come filtrare, cercare e visualizzare i risultati in Copilot per Microsoft 365.

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 da 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.

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. Tutti i blog e le pagine verranno indicizzati dal connettore 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.

Passaggio 5: Gestire le autorizzazioni di ricerca

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 verranno visualizzati nei risultati della ricerca per tutti gli utenti. Se si sceglie Solo le persone con accesso a questa origine dati, i dati indicizzati verranno visualizzati nei risultati della ricerca per gli utenti che hanno accesso a tali origini.

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, avranno la precedenza sulle autorizzazioni per lo spazio.

Se non sono presenti restrizioni di pagina, il connettore verificherà la presenza di autorizzazioni a livello di spazio:

  • Nel caso in cui lo spazio abbia l'accesso "utenti anonimi" abilitato, il contenuto sarà visibile a tutti gli utenti all'interno del tenant.
  • Nel caso in cui l'accesso anonimo non sia abilitato, le autorizzazioni a livello di spazio verranno rispettate.
  • Nel caso in cui le autorizzazioni a livello di spazio non siano definite, il contenuto non sarà 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 verranno prese in considerazione.

Se si sceglie Solo le persone 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 Email 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 Email 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.

Passaggio 6: Assegnare etichette di proprietà

Seguire le istruzioni di configurazione generali.

Passaggio 7: Gestire lo schema

Seguire le istruzioni di configurazione generali.

Passaggio 8: Scegliere le impostazioni di aggiornamento

Seguire le istruzioni di configurazione generali.

Nota

Per gli aggiornamenti delle autorizzazioni di accesso, verrà applicata solo la ricerca per indicizzazione completa pianificata.

Passaggio 9: Esaminare la connessione

Seguire le istruzioni di configurazione generali.

Dopo aver pubblicato la connessione, è necessario personalizzare la pagina dei risultati della ricerca. Per informazioni sulla personalizzazione dei risultati della ricerca, vedere Personalizzare la pagina dei risultati della ricerca.

Passaggio 10: Configurare la pagina dei risultati della ricerca

Dopo aver pubblicato la connessione, è necessario personalizzare la pagina dei risultati della ricerca con tipi di risultati e verticali. Per informazioni sulla personalizzazione dei risultati della ricerca, vedere come gestire i tipi di risultati e verticali. È anche possibile usare il layout dei risultati di esempio per il connettore cloud Confluence. Copiare e incollare il codice JSON del layout dei risultati per iniziare.

Limitazioni

Il connettore Confluence Cloud presenta le limitazioni note seguenti nella versione più recente:

  • Confluence Cloud Connector non indicizzare i file e i commenti degli allegati.
  • Le distribuzioni di server di indicizzazione e data center verranno rilasciate come connettore separato.

Risoluzione dei problemi

Dopo aver pubblicato la connessione, è possibile esaminare lo stato nella scheda Origini datinell'interfaccia di amministrazione. Per informazioni su come eseguire aggiornamenti ed eliminazioni, vedere Gestire il connettore. È possibile trovare i passaggi per la risoluzione dei problemi più comuni qui.

In caso di altri problemi o se si vuole fornire commenti e suggerimenti, contattare Microsoft Graph | Appoggiare