View a markdown version of this page

Integrazione delle azioni di Atlassian Confluence Cloud - Amazon Quick
Prima di iniziareConfigurare l'Atlassian Developer ConsolePreparare l'autenticazioneConfigura l'integrazione in Amazon QuickOperazioni disponibiliGestisci e risolvi i problemi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Integrazione delle azioni di Atlassian Confluence Cloud

Usa il connettore di azione Atlassian Confluence Cloud per creare, aggiornare e gestire pagine e spazi Confluence direttamente in Amazon Quick tramite linguaggio naturale.

Per configurare questa integrazione, devi prima creare un'app OAuth 2.0 (3LO) nella Atlassian Developer Console e configurarne le autorizzazioni. Quindi, crei l'integrazione in Amazon Quick e la connetti alla tua app Atlassian. Per informazioni sui metodi di autenticazione supportati da Amazon Quick, consultaMetodi di autenticazione.

Prima di iniziare

Assicurati di disporre di quanto segue prima di configurare l'integrazione.

Configurare l'Atlassian Developer Console

Se prevedi di utilizzare l'autenticazione utente (3LO), crea un'app OAuth 2.0 nell'Atlassian Developer Console prima di configurare Amazon Quick. Completa tutti i passaggi seguenti prima di passare alla console Amazon Quick.

Se prevedi di utilizzare solo l'autenticazione del servizio (chiave API), puoi saltare questa sezione e procedere Preparare l'autenticazione con.

Per ulteriori informazioni sulle app OAuth 2.0 (3LO), consulta le app OAuth 2.0 (3LO) nella documentazione per sviluppatori di Atlassian.

Crea un'app OAuth 2.0 (3LO)

Amazon Quick utilizza un'app Atlassian OAuth 2.0 (3LO) per autenticarsi con il tuo prodotto Atlassian Cloud per conto dei tuoi utenti. Crea questa app nell'Atlassian Developer Console prima di configurare Amazon Quick.

  1. Apri l'Atlassian Developer Console e accedi con il tuo account Atlassian.

  2. Scegli Crea, quindi scegli l'integrazione 2.0. OAuth

  3. Per Nome, inserisci un nome descrittivo per l'integrazione, ad esempioyour-app-name connector.

  4. Leggi e accetta i termini per gli sviluppatori di Atlassian.

  5. Scegli Create (Crea).

Configurazione delle autorizzazioni

Dopo aver creato l'app OAuth 2.0, aggiungi le autorizzazioni API di cui Amazon Quick ha bisogno per interagire con il tuo prodotto Atlassian.

  1. Dalla tua app nella Atlassian Developer Console, scegli Autorizzazioni nella barra di navigazione a sinistra.

  2. Trova l'API per il tuo prodotto Atlassian (ad esempio, Jira API o Confluence API) e scegli Aggiungi. Il pulsante cambia in Configura dopo l'aggiunta dell'API.

  3. Scegli Configura. La pagina degli ambiti si apre con le schede Ambiti classici e Ambiti granulari.

  4. Nella scheda Ambiti classici, scegli Modifica ambiti. Seleziona gli ambiti classici richiesti e scegli Salva.

  5. Scegli la scheda Ambiti granulari, quindi scegli Modifica ambiti. Seleziona gli ambiti granulari richiesti e scegli Salva.

Per gli ambiti specifici richiesti per l'integrazione, consulta la sezione sugli ambiti che segue.

Ambiti richiesti per Confluence

Aggiungi i seguenti ambiti all'app OAuth 2.0 per l'integrazione delle azioni di Confluence Cloud.

Ambito classico

Nella scheda Ambiti classici, scegli Modifica ambiti e seleziona il seguente ambito.

Integrazione di Confluence Action: ambito classico
Scope Description
search:confluence Cerca i riepiloghi dei contenuti e degli spazi di Confluence.

Ambiti granulari

Scegli la scheda Ambiti granulari, quindi scegli Modifica ambiti. Seleziona i seguenti ambiti.

Integrazione di Confluence Action: ambiti granulari
Scope Description
read:page:confluence Visualizza il contenuto della pagina.
write:page:confluence Crea e aggiorna pagine.
read:space:confluence Accedi alle informazioni sullo spazio.

Configurazione dell’autorizzazione

Imposta l'URL di callback in modo che Atlassian possa reindirizzare gli utenti ad Amazon Quick dopo aver autorizzato l'app.

  1. Dalla tua app nella Atlassian Developer Console, scegli Autorizzazione nella barra di navigazione a sinistra.

  2. Accanto a OAuth 2.0 (3LO), scegli Aggiungi.

  3. Per Callback URLs, inserisci. https://region.quicksight.aws.amazon.com/sn/oauthcallback Sostituisci region con la AWS regione in cui è distribuita l'istanza Amazon Quick, ad esempious-east-1.

  4. Scegli Save changes (Salva modifiche).

Registra le tue credenziali

Prima di uscire dall'Atlassian Developer Console, verifica di avere i seguenti valori. Ne hai bisogno per la configurazione di Amazon Quick.

  1. Dalla tua app nell'Atlassian Developer Console, scegli Impostazioni nella barra di navigazione a sinistra.

  2. In Dettagli di autenticazione, copia i valori Client ID e Secret.

Credenziali richieste dalla Atlassian Developer Console
Valore Dove trovarlo
ID client Pagina delle impostazioni, in Dettagli di autenticazione
Segreto Pagina delle impostazioni, in Dettagli di autenticazione

Preparare l'autenticazione

I connettori di azione Confluence Cloud supportano due metodi di autenticazione. Raccogli le credenziali richieste prima di configurare Amazon Quick.

Autenticazione utente (3LO)

Se hai completato la configurazione dell'Atlassian Developer Console nella sezione precedente, dovresti avere i seguenti valori pronti. Inseriscili quando configuri l'integrazione in Amazon Quick.

  • URL di base: l'URL dell'istanza Confluence per le chiamate API. Questo non è lo stesso URL a cui accedono gli utenti. Assomiglia al seguente:https://api.atlassian.com/ex/confluence/yourInstanceId. Per trovare l'ID della tua istanza, vai ahttps://your-domain.atlassian.net/_edge/tenant_info.

  • ID cliente: dalla pagina Impostazioni dell'app Atlassian OAuth .

  • Client secret: dalla pagina Impostazioni dell'app OAuth Atlassian.

  • URL del token: https://auth.atlassian.com/oauth/token

  • URL di autorizzazione — https://auth.atlassian.com/authorize

  • URL di reindirizzamento — https://region.quicksight.aws.amazon.com/sn/oauthcallback

Autenticazione del servizio (chiave API)

Raccogli le seguenti informazioni dal tuo amministratore di Confluence Cloud:

  • Chiave API: token API Confluence.

  • URL di base: l'URL dell'istanza Confluence per le chiamate API.

  • Email: indirizzo e-mail associato all'account utente.

Configura l'integrazione in Amazon Quick

Dopo aver preparato le credenziali di autenticazione, crea l'integrazione in Amazon Quick.

  1. Nella console Amazon Quick, scegli Integrazioni.

  2. Scegli la scheda Azioni.

  3. In Configura una nuova integrazione di app per Actions, trova Atlassian Confluence Cloud e scegli il pulsante Aggiungi (più «+»).

  4. Nella pagina Tipo di integrazione, seleziona Esegui azioni in Atlassian Confluence Cloud e scegli Avanti.

  5. Nel modulo Crea integrazione, compila i seguenti campi:

    • Nome: nome descrittivo per l'integrazione con Confluence.

    • Descrizione (opzionale): note su come verrà utilizzata questa connessione.

    • Tipo di connessione: scegli Rete pubblica.

  6. In Impostazioni di autenticazione, scegli il metodo di autenticazione e compila i campi richiesti:

    1. Per l'autenticazione utente, configura i seguenti campi:

      • URL di base: l'URL dell'istanza Confluence per le chiamate API, nel formato. https://api.atlassian.com/ex/confluence/yourInstanceId Per trovare l'ID della tua istanza, vai a. https://your-domain.atlassian.net/_edge/tenant_info

      • ID cliente: ID cliente dalla pagina Impostazioni dell'app Atlassian OAuth .

      • Client secret: nascosto dalla pagina Impostazioni dell'app OAuth Atlassian.

      • URL del token: https://auth.atlassian.com/oauth/token

      • URL di autorizzazione — https://auth.atlassian.com/authorize

      • URL di reindirizzamento: questo campo è precompilato con il tuo URL di callback Amazon Quick.

    2. Per l'autenticazione del servizio, configura i seguenti campi:

      • Chiave API: token API Confluence.

      • URL di base: l'URL dell'istanza Confluence per le chiamate API.

      • Email: indirizzo e-mail associato all'account utente.

  7. Scegli Crea e continua.

  8. (Facoltativo) Nella pagina di integrazione Condividi, scegli gli utenti con cui condividere l'integrazione.

Operazioni disponibili

Dopo aver configurato l'integrazione, sono disponibili le seguenti azioni.

Azioni disponibili in Confluence Cloud
Azione Description
Crea pagina Crea una nuova pagina.
Ottieni pagine Visualizza tutte le pagine.
Cerca Cerca contenuti usando CQL.
Aggiorna pagina Aggiorna il contenuto della pagina.

Gestisci e risolvi i problemi

Per modificare, condividere o eliminare la tua integrazione, consulta. Gestione delle integrazioni esistenti

Problemi di autenticazione

  • Configurazione errata dell'app: verifica che l' OAuth app nell'Atlassian Developer Console includa gli ambiti richiesti e che l'URI di reindirizzamento corrisponda alla tua configurazione Amazon Quick.

  • Token API scaduto: se utilizzi l'autenticazione del servizio, verifica che il token API non sia scaduto e generane uno nuovo, se necessario.

  • URL di base errato: l'URL di base per le chiamate API non è lo stesso dell'URL di accesso a Confluence Cloud. Verifica di utilizzare il formato URL dell'API:. https://api.atlassian.com/ex/confluence/yourInstanceId Per trovare l'ID della tua istanza, vai ahttps://your-domain.atlassian.net/_edge/tenant_info.

Messaggi di errore comuni

  • Access denied. You do not have permission to perform this action— L'utente autenticato non dispone delle autorizzazioni richieste in Confluence Cloud. Contatta il tuo amministratore di Confluence Cloud per verificare e concedere le autorizzazioni appropriate.

  • OAuth 2.0 authorization failed— Verifica che l'ID client, il segreto del client e OAuth gli ambiti siano configurati correttamente sia nell'Atlassian Developer Console che in Amazon Quick.