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
<a name="confluence-action-integration"></a>

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, consulta[Metodi di autenticazione](quick-action-auth.md).

## Prima di iniziare
<a name="confluence-action-prerequisites"></a>

Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Atlassian Confluence Cloud.
+ Accesso alla [Atlassian Developer Console](https://developer.atlassian.com/console/myapps/) per creare o gestire un'app. OAuth 
+ Per i requisiti di abbonamento, consulta. [Configura le integrazioni nella console](integration-console-setup-process.md)

## Configurare l'Atlassian Developer Console
<a name="confluence-action-atlassian-setup"></a>

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](#confluence-action-auth-setup) con.

Per ulteriori informazioni sulle app OAuth 2.0 (3LO), consulta le app [OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/) nella documentazione per sviluppatori di Atlassian.

### Crea un'app OAuth 2.0 (3LO)
<a name="atlassian-oauth-app"></a>

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](https://developer.atlassian.com/console/myapps/) e accedi con il tuo account Atlassian.

1. **Scegli **Crea**, quindi scegli l'integrazione 2.0. OAuth **

1. Per **Nome**, inserisci un nome descrittivo per l'integrazione, ad esempio`your-app-name connector`.

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

1. Scegli **Create** (Crea).

### Configurazione delle autorizzazioni
<a name="atlassian-oauth-permissions"></a>

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.

1. **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.

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

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

1. **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
<a name="confluence-action-oauth-scopes"></a>

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
<a name="atlassian-oauth-authorization"></a>

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

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

1. 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 esempio`us-east-1`.

1. Scegli **Save changes** (Salva modifiche).

### Registra le tue credenziali
<a name="atlassian-oauth-credentials"></a>

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.

1. 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
<a name="confluence-action-auth-setup"></a>

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 a`https://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
<a name="confluence-action-integration-setup"></a>

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

1. Nella console Amazon Quick, scegli **Integrazioni.**

1. Scegli la scheda **Azioni**.

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

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

1. 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**.

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

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

1. Scegli **Crea e continua**.

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

## Operazioni disponibili
<a name="confluence-action-available-actions"></a>

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
<a name="confluence-action-troubleshooting"></a>

Per modificare, condividere o eliminare la tua integrazione, consulta. [Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations)

### Problemi di autenticazione
<a name="confluence-action-troubleshooting-auth"></a>
+ **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 a`https://your-domain.atlassian.net/_edge/tenant_info`.

### Messaggi di errore comuni
<a name="confluence-action-troubleshooting-errors"></a>
+ **`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.