Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il connettore Confluence Cloud Microsoft 365 Copilot integra il contenuto di Confluence in Microsoft 365, consentendo a Copilot, Copilot Search e Microsoft Search di visualizzare pagine wiki, blog e allegati pertinenti direttamente all'interno di app come Teams, Outlook e SharePoint.
Questo articolo fornisce informazioni sui passaggi di configurazione che gli amministratori di Confluence devono completare per configurare Confluence Cloud per l'organizzazione, inclusa la configurazione dell'ambiente e la configurazione dei prerequisiti per il connettore Confluence Cloud.
Per informazioni su come distribuire il connettore, vedere Distribuire il connettore Confluence Cloud.
Impostare l'elenco di controllo:
Gli elenchi di controllo seguenti elencano il passaggio necessario per configurare l'ambiente e configurare i prerequisiti del connettore.
Configurare l'ambiente
| Attività | Ruolo |
|---|---|
| Identificare l'URL dell'istanza | Amministratore della confluenza |
| Esaminare la configurazione di spazi e pagine | Amministratore della confluenza |
| Definire il mapping degli attributi | Amministratore della confluenza |
| Configurare le autorizzazioni di accesso utente | Amministratore della confluenza |
| Aggiungere descrizioni a spazi e pagine | Amministratore della confluenza |
| Configurare la sincronizzazione di Entra ID in Crowd | Amministratore della confluenza |
Configurare i prerequisiti
| Attività | Ruolo |
|---|---|
| Creare un account del servizio | Amministratore della confluenza |
| Identificare il numero di elementi per l'inserimento | Amministratore della confluenza |
| Configurare CQL per la ricerca avanzata | Amministratore della confluenza |
| Effettuare il provisioning di un endpoint OAuth | Amministratore della confluenza |
| Aggiungere l'indirizzo IP per consentire l'elenco | Amministratore della confluenza/amministratore di rete |
| Convalidare l'indicizzazione di Copilot | Amministratore della confluenza |
Configurare l'ambiente Confluence
Le sezioni seguenti descrivono le attività di amministrazione per configurare l'ambiente Confluence per abilitare e ottimizzare la connessione.
Identificare l'URL dell'istanza di Confluence
L'URL dell'istanza di Confluence Cloud ha in genere il formato seguente:
https://<organization_name>.atlassian.net/wiki
Per identificare l'URL dell'istanza per Confluence Cloud:
- Accedere all'account Confluence .
- Scegliere URL di prodotto.
- In URL predefiniti individuare il nome del sito e il prodotto.
È anche possibile visualizzare l'URL nel browser quando si usa Confluence Cloud.
Esaminare la configurazione di spazi e pagine di Confluence
Per ottimizzare l'indicizzazione e i risultati della ricerca, esaminare la configurazione di spazi e pagine sia in Confluence Cloud che in Confluence Data Center. Ciò consente di garantire che i risultati della ricerca in Microsoft 365 siano completi, sicuri e allineati alle aspettative degli utenti.
In Confluence Cloud assicurarsi che gli spazi seguano convenzioni di denominazione chiare, usino le etichette in modo coerente e applichino le autorizzazioni che corrispondono alla visibilità desiderata per Copilot, Ricerca Copilot e Microsoft Search. Organizzare le pagine in una gerarchia logica e usare titoli e metadati significativi per migliorare l'accuratezza della ricerca.
Definire il mapping degli attributi di Confluence
Il metodo predefinito per il mapping delle identità dell'origine dati a Microsoft Entra ID consiste nel determinare se l'indirizzo di posta elettronica di ogni utente di Confluence corrisponde al nome dell'entità utente (UPN) o all'indirizzo di posta elettronica in Microsoft Entra ID. Se questo mapping predefinito non soddisfa le esigenze dell'organizzazione, è possibile definire una formula di mapping personalizzata.
Per altre informazioni sul mapping di identità non presenti in Microsoft Entra ID, vedere Eseguire il mapping delle identità di Active Directory non Azure.
Configurare le autorizzazioni di accesso utente
Gli amministratori di Confluence possono integrare directory LDAP, ad esempio Microsoft Entra ID, per gestire centralmente l'accesso e le autorizzazioni degli utenti. Sincronizzando i gruppi LDAP in Confluence, gli amministratori possono assegnare tali gruppi a spazi e pagine per controllare la visualizzazione e modificare l'accesso per allinearsi alla governance delle identità a livello aziendale.
È possibile usare gruppi annidati sincronizzati per gestire gli elenchi di controllo di accesso (ACL), a condizione che i membri del gruppo annidato fanno parte di un gruppo di utenti di Confluence.
La tabella seguente fornisce un confronto tra i gruppi LDAP e i gruppi nativi di Confluence per le autorizzazioni di accesso utente di Confluence.
| Funzionalità | Gruppi LDAP | Gruppi nativi di confluenza |
|---|---|---|
| Origine | Gestito in una directory esterna | Gestito all'interno di Confluence |
| Sincronizza | Sincronizzazione periodica tramite la configurazione della directory utente | Creato e gestito manualmente dagli amministratori di Confluence |
| Scalabilità | Altamente scalabile per l'uso aziendale | Adatto per piccoli team o configurazioni solo confluence |
| Controllo di accesso | Riflette automaticamente le modifiche alla directory | Richiede aggiornamenti manuali |
| Controllo e conformità | Allineati ai criteri IT e ai framework di conformità | Controllo decentralizzato |
Aggiungere descrizioni per spazi e pagine
Copilot usa le descrizioni e le descrizioni brevi in Confluence per associare semanticamente spazi e pagine con le richieste degli utenti. Se mancano descrizioni, la rilevanza delle risposte copilot viene ridotta. Assicurarsi di aggiungere descrizioni e descrizioni brevi per spazi e pagine nell'istanza di Confluence.
Configurare la sincronizzazione di Entra ID in Crowd
È possibile configurare Microsoft Entra ID come directory in Crowd. Quando si configura Microsoft Entra ID, tutte le modifiche apportate a utenti, gruppi e appartenenze vengono sincronizzate periodicamente tra Microsoft Entra ID e Crowd o ogni volta che lo si richiede. È possibile visualizzare le informazioni sugli utenti direttamente in Crowd usando il browser utente e il browser gruppo.
Per altre informazioni, vedere Configurazione di Microsoft Entra ID.
Configurare i prerequisiti del connettore
Le sezioni seguenti descrivono i passaggi prerequisiti da completare prima di distribuire il connettore Confluence.
Creare un account del servizio
Per consentire al connettore Confluence di aggiornare regolarmente gli elementi, configurare un account del servizio con accesso in lettura a tabelle delle conoscenze specifiche di Confluence.
Assicurarsi che l'account del servizio disponga delle autorizzazioni di lettura per le tabelle necessarie seguenti:
- Spazi
Concedere autorizzazioni di lettura per tutte le tabelle applicabili. Per altre informazioni, vedere Concedere agli utenti autorizzazioni di amministratore.
Nota
Le modifiche apportate all'account del servizio possono influire sulla sincronizzazione dei dati con Microsoft 365. Se l'account viene modificato, potrebbe essere necessario autenticare nuovamente il connettore in Microsoft 365.
Assicurarsi che l'account del servizio sia configurato correttamente. Se non sono presenti restrizioni a livello di pagina, il connettore controlla le autorizzazioni a livello di spazio e gestisce il contenuto come indicato di seguito:
- Se l'accesso anonimo è abilitato per uno spazio, il relativo contenuto è visibile a tutti gli utenti nel tenant.
- Se l'accesso anonimo è disabilitato, vengono applicate le autorizzazioni a livello di spazio.
- Se non vengono definite autorizzazioni a livello di spazio, il contenuto non è visibile agli utenti nel tenant.
Nota
Le autorizzazioni vengono gestite solo a livello di spazio e pagina. Le autorizzazioni per le pagine padre non vengono considerate.
Errore di OAuth a causa di credenziali non valide
Se anche l'amministratore di Microsoft 365 non è un amministratore di Confluence Cloud, l'autorizzazione di connessione ha esito negativo con l'errore "Credenziali di connessione non valide". Per risolvere questo errore, l'amministratore di Microsoft 365 può seguire questa procedura:
Aprire una finestra InPrivate browsing e accedere al portale di amministrazione usando le credenziali.
Nel portale di amministrazione selezionare l'origine dati Confluence e iniziare a creare la connessione.
Per Autenticazione selezionare OAuth 2.0.
Immettere l'ID client e il segreto client dell'app creata dall'amministratore di Confluence.
Selezionare Autorizza. Verrà visualizzata una finestra popup.
Copiare l'URL dal popup e condividerlo con l'amministratore di Confluence.
Chiedere all'amministratore di Confluence di accedere al proprio account Confluence e approvare la richiesta. Dopo l'approvazione, viene visualizzata una schermata vuota, che conferma l'esito positivo.
Dopo che l'amministratore di Confluence conferma l'approvazione, tornare alla finestra popup.
Fare clic con il pulsante destro del mouse sulla finestra popup e scegliere Controlla>console.
Nella console incollare il comando seguente:
window.opener.postMessage({type: 'oauthFinish', isSuccess: true}, '*')Nota
Se l'incollamento è disabilitato, digitare
allow pastingprima nella console, quindi incollare di nuovo il comando.Nella schermata di creazione della connessione viene visualizzato un messaggio di esito positivo e il pulsante Crea diventa attivo.
È ora possibile chiudere la finestra popup.
Identificare il numero di elementi per l'inserimento
Per verificare il numero di elementi previsto per l'inserimento in tutti i connettori applicabili in Confluence Cloud:
- Vai a
https://<Confluence instance name>.atlassian.net/wiki/admin/space-reports. - In Report spazio selezionare Crea report.
- Selezionare Scarica per esportare il report.
- Aprire il file .csv scaricato.
- Nella colonna Conteggio contenuto esaminare il numero di pagine che verranno sincronizzate in ogni spazio.
Nota
Il contenuto generato dall'intelligenza artificiale nel report potrebbe non essere accurato. Esaminare il contenuto prima di procedere.
Configurare CQL per la ricerca avanzata
Per recuperare le pagine da uno spazio specifico in Confluence Cloud che hanno determinate etichette e sono state modificate per l'ultima volta entro un intervallo di tempo definito, usare Confluence Query Language (CQL).
Includere i componenti seguenti nella query:
- Chiave spazio : identifica lo spazio in cui si vuole eseguire la ricerca.
- Tipo di pagina : filtra i risultati in modo da includere solo le pagine.
- Etichette : filtra le pagine in base a una o più etichette.
- Data ultima modifica : limita i risultati alle pagine modificate entro un intervallo di tempo specifico.
Nell'esempio seguente viene illustrata una query CQL.
CQLtype = page AND space = "SPACEKEY" AND label in ("label1", "label2") AND lastmodified >= "2025-01-01"
Nell'esempio precedente:
-
type= pagina: restituisce solo pagine. -
space= "SPACEKEY": sostituire "SPACEKEY" con la chiave effettiva per lo spazio. -
labelin ("label1", "label2"): restituisce le pagine con label1 o label2. -
lastmodified>= "2025-01-01": restituisce le pagine modificate il 1° gennaio 2025 o dopo tale data.
È possibile modificare il formato della data in base a yyyy-MM-dd o yyyy-MM-dd HH:mm per includere l'ora.
Consiglio
- Per il filtro delle etichette, usare l'etichetta in (...) per trovare la corrispondenza con più etichette.
- Per le funzioni date, CQL supporta funzioni dinamiche come
startOfYear()oendOfMonth()per semplificare il filtro delle date. Ad esempio,lastmodified >= startOfYear()restituisce le pagine modificate dall'inizio dell'anno corrente.
Per eseguire la query usando l'API REST di Confluence Cloud, usare la richiesta POST seguente.
curl -u yourUsername:yourPassword \
-X POST "https://your-confluence-url/rest/api/search" \
-H "Content-Type: application/json" \
-d '{
"cql": "type=page AND space=\"SPACEKEY\" AND label=\"your-label\" AND lastmodified >= \"2025-01-01\"",
"limit": 25,
"start": 0
}'
Sostituire:
-
yourUsernameeyourPasswordcon le credenziali o usare l'autenticazione basata su token. -
https://your-confluence-urlcon l'URL di base di Confluence. -
SPACEKEYcon la chiave di spazio. -
your-labelcon l'etichetta desiderata. - Modificare la data e la paginazione in base alle esigenze.
Effettuare il provisioning di un endpoint OAuth
Per consentire al connettore Confluence Cloud di accedere all'istanza di Confluence Cloud, un amministratore di Confluence deve effettuare il provisioning di un endpoint OAuth per abilitare l'app Microsoft Search e Microsoft 365 Copilot per accedere all'istanza.
Per istruzioni dettagliate, vedere Registrare un'app in Confluence Cloud.
Usare la tabella seguente per determinare quali ambiti selezionare quando si configura l'accesso tramite l'API Confluence.
| Nome ambito | Codice |
|---|---|
| Visualizzare i dettagli del contenuto Visualizzare i dettagli relativi al contenuto e alle relative proprietà associate. |
read:content-details:confluence |
| Visualizzare i record di controllo Visualizzare ed esportare i record di controllo per gli eventi di Confluence. |
read:audit-log:confluence |
| Visualizzare le pagine Visualizzare il contenuto della pagina. |
read:page:confluence |
| Visualizzare i gruppi Visualizzare i dettagli sui gruppi, inclusi i relativi membri. |
read:group:confluence |
| Visualizzare i dettagli utente Visualizzare i dettagli dell'utente. |
read:user:confluence |
| Visualizzare gli spazi Visualizzare i dettagli dello spazio. |
read:space:confluence |
| Visualizzare le restrizioni del contenuto e le autorizzazioni per lo spazio Visualizzare le restrizioni del contenuto e i dettagli delle autorizzazioni per lo spazio. |
read:permission:confluence |
| Visualizzare i riepiloghi del contenuto Visualizzare le informazioni sul contenuto. Si noti che questo non fornisce l'accesso al contenuto stesso. |
read:content.metadata:confluence |
| Visualizzare i commenti Visualizzare commenti su pagine o post di blog. |
read:comment:confluence |
| Visualizzare e scaricare allegati di contenuto Visualizzare e scaricare gli allegati di una pagina o di un post di blog a cui si ha accesso. |
read:attachment:confluence |
Aggiungere l'indirizzo IP per consentire l'elenco
Per assicurarsi che il connettore possa accedere alle API di Confluence, aggiungere gli indirizzi IP di Microsoft 365 necessari all'elenco consenti nel firewall, nel proxy o in altre configurazioni di rete.
Per Confluence Cloud, se la configurazione di rete blocca l'accesso alle API di Confluence, assicurarsi che gli indirizzi IP elencati nelle pagine della documentazione seguenti siano consentiti:
- Regole del firewall IP
- Indirizzi IP e domini da consentire nell'elenco di indirizzi consentiti nel firewall aziendale
Convalidare l'indicizzazione di Copilot per Confluence
Per verificare che Microsoft 365 Copilot possa accedere al contenuto richiesto da Confluence, seguire questa procedura di convalida:
- Verificare se tutti gli elementi necessari sono sincronizzati con Microsoft, in base ai prerequisiti.
- Passare alla pagina dei dettagli del connettore .
- Verificare che il numero di indici corrisponda al numero di pagine nello spazio confluence configurato.