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 con Microsoft Teams
Usa il connettore di azione Microsoft Teams per inviare messaggi, gestire canali, pianificare riunioni e gestire la collaborazione del team direttamente in Amazon Quick tramite linguaggio naturale.
La configurazione di questa integrazione prevede due passaggi. Innanzitutto, si registra un'applicazione in Microsoft Entra e si configurano le relative autorizzazioni. Quindi, crei l'integrazione in Amazon Quick e la connetti alla tua app Entra. 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.
-
Un account Microsoft 365 con accesso a Teams.
-
Accesso all'interfaccia di amministrazione di Microsoft Entra
con almeno le autorizzazioni di Application Developer. -
Per i requisiti di abbonamento, consultaConfigura le integrazioni nella console.
Configurare Microsoft Entra
Prima di configurare Amazon Quick, crea una registrazione dell'app in Microsoft Entra. Completa tutti i seguenti passaggi in Entra prima di passare alla console Amazon Quick.
Per ulteriori informazioni sulle registrazioni delle app, vedi Registrare un'applicazione con la piattaforma di identità Microsoft
Registrare l'applicazione
-
Apri l'interfaccia di amministrazione di Microsoft Entra
. -
Nella barra di navigazione a sinistra, scegli Entra ID, quindi scegli Registrazioni app.
-
Scegli Nuova registrazione.
-
In Nome, inserisci un nome descrittivo per la tua integrazione.
-
Per i tipi di account supportati, scegli Account solo in questa directory organizzativa.
-
Per Redirect URI, selezionate Web e immettete
https://. Sostituisci{region}.quicksight.aws.amazon.com/sn/oauthcallback{region}con la AWS regione in cui è distribuita l'istanza Amazon Quick. -
Scegli Registrati.
-
Nella pagina di panoramica, copia l'ID dell'applicazione (client) e l'ID della directory (tenant). Questi valori sono necessari per la configurazione di Amazon Quick.
Crea un segreto per il cliente
Amazon Quick necessita di un client secret per l'autenticazione con Microsoft Entra. Questo segreto funge da password per la registrazione dell'app.
-
Dalla registrazione dell'app, scegli Certificati e segreti.
-
Scegli Nuovo segreto del cliente.
-
Inserisci una descrizione e scegli un periodo di scadenza.
-
Scegliere Aggiungi.
-
Copia immediatamente il valore. Questo valore viene visualizzato solo una volta.
Importante
Copia il valore segreto, non l'ID segreto. Il valore è la stringa più lunga utilizzata per l'autenticazione.
Configura le autorizzazioni API
Microsoft Graph supporta due tipi di autorizzazione per questa integrazione. Le autorizzazioni delegate consentono all'app di agire per conto di un utente che ha effettuato l'accesso. Le autorizzazioni dell'applicazione consentono all'app di agire senza un utente registrato. Per ulteriori informazioni, vedere Panoramica delle autorizzazioni di Microsoft Graph
-
Dalla registrazione dell'app, scegli Autorizzazioni API.
-
Scegli Aggiungi un'autorizzazione, quindi scegli Microsoft Graph.
-
Scegli Autorizzazioni delegate o Autorizzazioni per applicazioni in base al metodo di autenticazione utilizzato e aggiungi le autorizzazioni dalla tabella appropriata riportata di seguito.
-
Scegli Concedi il consenso dell'amministratore per [il nome del tenant] per approvare le autorizzazioni.
Per l'autenticazione degli utenti (autorizzazioni delegate):
Aggiungi quanto segue come autorizzazioni delegate nella registrazione dell'app Entra. Per il riferimento completo alle autorizzazioni, vedere il riferimento alle autorizzazioni di Microsoft Graph
| Autorizzazione | Description |
|---|---|
Chat.ReadWrite |
Consente all'app di leggere e scrivere i messaggi di chat dell'utente che ha effettuato l'accesso. |
ChatMessage.Send |
Consente all'app di inviare messaggi di chat per conto dell'utente che ha effettuato l'accesso. |
Team.ReadBasic.All |
Consente all'app di leggere i nomi e le descrizioni dei team per conto dell'utente che ha effettuato l'accesso. |
Channel.ReadBasic.All |
Consente all'app di leggere i nomi e le descrizioni dei canali per conto dell'utente che ha effettuato l'accesso. |
Channel.Create |
Consente all'app di creare canali in qualsiasi team per conto dell'utente che ha effettuato l'accesso. |
ChannelMessage.Read.All |
Consente all'app di leggere tutti i messaggi del canale per conto dell'utente che ha effettuato l'accesso. |
ChannelMessage.Send |
Consente all'app di inviare messaggi nei canali per conto dell'utente che ha effettuato l'accesso. |
ChannelMember.ReadWrite.All |
Consente all'app di aggiungere e rimuovere membri dai canali per conto dell'utente che ha effettuato l'accesso. |
TeamMember.ReadWrite.All |
Consente all'app di aggiungere e rimuovere membri da tutti i team per conto dell'utente che ha effettuato l'accesso. |
User.Read.All |
Consente all'app di leggere il set completo di proprietà del profilo di tutti gli utenti per conto dell'utente che ha effettuato l'accesso. |
OnlineMeetings.ReadWrite |
Consente all'app di leggere e creare riunioni online per conto dell'utente che ha effettuato l'accesso. |
OnlineMeetingTranscript.Read.All |
Consente all'app di leggere tutte le trascrizioni delle riunioni online per conto dell'utente che ha effettuato l'accesso. |
Calendars.ReadWrite |
Consente all'app di leggere e scrivere eventi nei calendari degli utenti per conto dell'utente che ha effettuato l'accesso. |
offline_access |
Consente all'app di aggiornare i token di accesso senza richiedere all'utente di effettuare nuovamente l'accesso. Ciò riduce la frequenza con cui gli utenti devono autenticarsi nuovamente. |
Per l'autenticazione del servizio (autorizzazioni dell'applicazione):
Aggiungi quanto segue come autorizzazioni dell'applicazione nella registrazione dell'app Entra.
| Autorizzazione | Description |
|---|---|
Chat.Read.All |
Consente all'app di leggere tutti i messaggi di chat dell'organizzazione senza un utente registrato. |
Chat.Send |
Consente all'app di inviare messaggi di chat senza un utente registrato. |
Team.ReadBasic.All |
Consente all'app di leggere i nomi e le descrizioni di tutti i team senza un utente registrato. |
Channel.ReadBasic.All |
Consente all'app di leggere tutti i nomi e le descrizioni dei canali senza un utente registrato. |
ChannelMessage.Read.All |
Consente all'app di leggere tutti i messaggi del canale senza che un utente abbia effettuato l'accesso. |
ChannelMessage.Send |
Consente all'app di inviare messaggi a qualsiasi canale senza un utente registrato. |
ChannelMember.ReadWrite.All |
Consente all'app di aggiungere e rimuovere membri da tutti i canali senza che un utente abbia effettuato l'accesso. |
TeamMember.ReadWrite.All |
Consente all'app di aggiungere e rimuovere membri da tutti i team senza un utente registrato. |
User.Read.All |
Consente all'app di leggere il set completo di proprietà del profilo di tutti gli utenti senza un utente registrato. |
OnlineMeetingTranscript.Read.All |
Consente all'app di leggere tutte le trascrizioni delle riunioni online senza un utente registrato. |
Importante
Con l'autenticazione del servizio, tutte le azioni vengono eseguite come account di servizio. Qualsiasi utente con accesso a questa integrazione può eseguire azioni su tutti i team e i canali a cui l'account di servizio può accedere. Ambita le autorizzazioni dell'applicazione in modo appropriato per i requisiti di sicurezza della tua organizzazione.
Registra le tue credenziali
Prima di uscire dall'interfaccia di amministrazione di Microsoft Entra, verifica di avere i seguenti valori. Ne hai bisogno per la configurazione di Amazon Quick.
| Valore | Dove trovarlo |
|---|---|
| ID dell’applicazione (client) | Pagina di panoramica sulla registrazione dell'app |
| ID della directory (tenant) | Pagina di panoramica sulla registrazione dell'app |
| Valore segreto del cliente | Pagina dei certificati e dei segreti |
Configura l'integrazione in Amazon Quick
Dopo aver completato la configurazione Entra, crea l'integrazione in Amazon Quick.
-
Nella console Amazon Quick, scegli Integrazioni.
-
Scegli la scheda Azioni.
-
Scegli Microsoft Teams e scegli il pulsante Aggiungi (più «+»).
-
Inserisci i dettagli dell'integrazione:
-
Nome: nome descrittivo per l'integrazione con Teams.
-
Descrizione (opzionale): scopo dell'integrazione.
-
-
Scegli il tipo di connessione e compila le impostazioni di connessione:
-
Per l'autenticazione utente (OAuth), configura i seguenti campi:
URL di base:
https://graph.microsoft.com/v1.0ID cliente: ID dell'applicazione (client) ottenuto dalla registrazione dell'app Entra.
Client Secret: valore segreto del cliente derivante dalla registrazione dell'app Entra.
URL del token:
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/tokenURL di autenticazione —
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorizeURL di reindirizzamento —
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
-
Per l'autenticazione del servizio, configura i seguenti campi:
ID client: ID dell'applicazione (client) ottenuto dalla registrazione dell'app Entra.
Client Secret: valore segreto del cliente derivante dalla registrazione dell'app Entra.
URL del token:
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/tokenAmbito:
.default
-
-
Scegli Crea e continua.
-
Scegli gli utenti con cui condividere l'integrazione.
-
Scegli Next (Successivo).
Operazioni disponibili
Dopo aver configurato l'integrazione, sono disponibili le seguenti azioni.
| Categoria | Azione | Description |
|---|---|---|
| Chat | Elenca chat | Visualizza le tue conversazioni in chat. |
| Chat | Crea chat | Inizia una nuova conversazione in chat. |
| Chat | Invia messaggio di chat | Invia un messaggio in una chat. |
| Team | Elenca squadre | Visualizza i team di cui fai parte. |
| Team | Elenca i membri del team | Visualizza i membri di un team. |
| Team | Aggiungi membro del team | Aggiungi un membro a un team. |
| Canali | Elenca canali | Visualizza i canali di un team. |
| Canali | Crea canale | Crea un nuovo canale in un team. |
| Canali | Elenca i messaggi del canale | Visualizza i messaggi in un canale. |
| Canali | Invia un messaggio al canale | Pubblica un messaggio su un canale. |
| Canali | Elenca i membri del canale | Visualizza i membri di un canale. |
| Canali | Aggiungi membro del canale | Aggiungi un membro a un canale. |
| Utenti | Creazione di elenchi sugli utenti | Visualizza gli utenti della tua organizzazione. |
| Riunioni | Elenca le riunioni online | Visualizza le riunioni online pianificate. |
| Riunioni | Crea una riunione online | Pianifica una nuova riunione online. |
| Riunioni | Elenca le trascrizioni delle riunioni | Visualizza le trascrizioni delle riunioni. |
| Calendar | Elenca gli eventi del calendario | Visualizza gli eventi sul tuo calendario. |
| Calendar | Crea un evento del calendario | Crea un nuovo evento del calendario. |
Gestisci e risolvi i problemi
Per modificare, condividere o eliminare la tua integrazione, consulta. Gestione delle integrazioni esistenti
Problemi di autenticazione
-
Registrazione errata dell'app: verifica che la registrazione dell'app in Microsoft Entra includa le autorizzazioni API richieste e che sia stato concesso il consenso dell'amministratore.
-
Segreto client scaduto: controlla se il segreto del client è scaduto in Certificati e segreti e generane uno nuovo, se necessario.
-
URI di reindirizzamento errato: verifica che l'URI di reindirizzamento in Microsoft Entra corrisponda.
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
Messaggi di errore comuni
-
Access denied. You do not have permission to perform this action— L'utente autenticato non dispone delle autorizzazioni richieste. Contatta l'amministratore per verificare e concedere le autorizzazioni appropriate. -
AADSTS50020: User account from identity provider does not exist in tenant— L'account utente non è configurato nel tenant Microsoft Entra corretto. Verifica che nel tenant esista un account utente che corrisponda all'ID di Directory (tenant) indicato nella registrazione dell'app.
