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à. # SlackEstensione Amazon Quick L'estensione Quick Slack integra l'assistenza basata sull'intelligenza artificiale direttamente nei flussi di lavoro di comunicazione del tuo team. Gli utenti possono accedere alle conoscenze e alle funzionalità di Quick all'interno dei Slack canali e ai messaggi diretti senza passare da un'applicazione all'altra. L'Slackestensione consente agli utenti di: + Aggiungi Amazon Quick come collaboratore utilizzando **@Amazon Quick mentions**. + Ottieni riepiloghi e approfondimenti sulle conversazioni. + Accedi alle basi di conoscenza e ai documenti organizzativi direttamente dai Slack canali. + Genera note e azioni dalle discussioni nei Slack thread. + Ottieni assistenza per l'analisi dei dati e la generazione di report utilizzando i file caricati. **Importante** Quando Amazon Quick viene utilizzato nei Slack canali pubblici, le risposte si basano sulle autorizzazioni dell'utente che invoca. Ciò può includere contenuti a cui gli altri membri del canale non sono autorizzati ad accedere. Valuta attentamente l'utilizzo di Amazon Quick nei canali pubblici per prevenire l'esposizione involontaria di informazioni sensibili. Amazon Quick non utilizza i dati utente per migliorare il servizio o per addestrare i modelli linguistici di grandi dimensioni sottostanti (LLMs). **Topics** + [Prerequisiti per l'estensione Slack](#slack-prerequisites) + [Configura l'accesso Slack alle estensioni](#configure-slack-extension) ## Prerequisiti per l'estensione Slack Prima di aggiungere Amazon Quick Slack Extension, gli amministratori devono soddisfare i seguenti requisiti: + Disponi di uno spazio di Slack lavoro a pagamento. + Ottieni l'accesso amministrativo al tuo spazio di Slack lavoro. + Inizia a usare Amazon Quick. + Il tuo ID dell'Slackarea di lavoro (deve iniziare con «T» ed essere alfanumerico). Un modo per trovare l'ID dell'Slackarea di lavoro consiste nell'accedere all'Slackarea di lavoro e avviare una chat con l'app che esegue il comando. Slack Developer Tools `/sdt whoami` Per ulteriori informazioni, consulta [Individuare l'URL o l'ID Slack nel centro assistenza](https://slack.com/help/articles/221769328-Locate-your-Slack-URL-or-ID). Slack Se hai configurato l'autenticazione per connetterti ad Amazon Quick con IAM Identity Center, completa i seguenti passaggi aggiuntivi: 1. Assicurati di avere un'istanza IAM Identity Center abilitata sul tuo AWS account. 1. Se stai collegando un provider IAM esterno a IAM Identity Center, assicurati che a ogni utente nella configurazione del provider IAM sia associata un'e-mail. 1. Se utilizzi Entra ID, configura la propagazione dell'identità SCIM tra l'Microsoft Entra IDistanza e IAM Identity Center. Per i passaggi dettagliati, consulta [Configurare SAML e SCIM con Microsoft Entra ID e IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/azure-ad-idp.html). ## Configura l'accesso Slack alle estensioni In qualità di amministratore, devi consentire alla tua Slack estensione Amazon Quick di connettersi al tuo ambiente applicativo Amazon Quick. Puoi utilizzare la console Amazon Quick per gestire le configurazioni di accesso alle estensioni. ### Mappatura degli attributi utente Quando configuri un'Slackestensione, l'identità dell'utente viene mappata per impostazione predefinita utilizzando i seguenti attributi: + **Attributo utente Amazon Quick**: l'indirizzo e-mail viene utilizzato per mappare gli utenti Amazon Quick agli Slack account corrispondenti. Il sistema utilizza l'indirizzo e-mail per stabilire la connessione tra le identità degli utenti. + **Slackattributo utente**: User Profile Email viene utilizzato per confrontare gli account Slack utente. Viene mappato all'indirizzo e-mail associato al Slack profilo dell'utente. Queste mappature predefinite garantiscono un'identificazione utente sicura e accurata su entrambe le piattaforme senza richiedere configurazioni aggiuntive. **Topics** + [Mappatura degli attributi utente](#slack-user-attributes) + [Aggiungi l'accesso all'estensione Slack per gli account che utilizzano IAM Identity Center](#add-slack-extension-access-idc) + [Aggiungi Slack l'accesso tramite estensione per gli account che utilizzano altri metodi di autenticazione](#add-slack-extension-access) + [Modifica Slack l'accesso all'estensione](#edit-slack-extension-access) + [Eliminare Slack l'accesso all'estensione](#delete-slack-extension-access) ### Aggiungi l'accesso all'estensione Slack per gli account che utilizzano IAM Identity Center La configurazione dell'accesso alle estensioni con IAM Identity Center richiede il completamento dei passaggi specifici del provider di identità (Entra ID o Okta) seguiti dai passaggi di configurazione comuni riportati in. AWS #### Configura IAM Identity Center con Entra ID Segui questi passaggi solo se utilizzi IAM Identity Center con Entra ID per configurare e configurare un tenant di Azure sul tuo portale Microsoft Azure: **Per configurare un tenant di Azure** 1. Nell'account Azure, crea una nuova registrazione per l'app. 1. Vai a **Registrazioni delle app**. 1. Nella schermata di **registrazione dell'app**, scegli **Nuova** registrazione. Nell'opzione **Tipi di account supportati**, scegli **Account solo in questa directory organizzativa (Solo per uso personale - Tenant singolo**). Una volta terminato, scegli **Registra**. 1. Annota l'ID del cliente. Saranno necessari in seguito. 1. Crea un client secret per la registrazione dell'app e prendine nota. Saranno necessari in seguito. 1. Aggiungi callback URLs per ogni regione in cui verrà installata l'estensione Slack. 1. Vai alla scheda **Autenticazione** della registrazione dell'app. 1. Scegli **Configurazioni della piattaforma**, **Aggiungi una piattaforma**. 1. Scegli **Web**. 1. Componi un URL di callback utilizzando il seguente formato, sostituendolo *your-region* con la tua regione di istanza Amazon Quick. L'estensione Slack supporta le seguenti regioni:`ap-southeast-2`,`eu-west-1`, `us-west-2` e. `us-east-1` ``` qbs-cell001.dp.appintegrations.your-region.prod.plato.ai.aws.dev/auth/idc-tti/callback ``` 1. Inserisci l'URL di callback come URI di reindirizzamento e scegli **Configura** al termine. Segui questi passaggi per configurare un Trusted Token Issuer sulla tua istanza IAM Identity Center nella tua console: AWS **Per configurare un emittente di token affidabile** 1. Accedi al tuo AWS account e accedi all'istanza di IAM Identity Center. 1. Vai a **Impostazioni**, **Autenticazione**. 1. Scegli **Crea emittente di token attendibili**. 1. Aggiungi l'URL dell'emittente, che dovrebbe seguire questo modello, dove *Tenant ID* si riferisce al tuo ID tenant Entra: ``` login.microsoftonline.com/Tenant ID/v2.0 ``` **Nota** L'URL dell'emittente deve essere l'endpoint di rilevamento OIDC della vostra identità senza il noto percorso URI del documento. Se includi il noto percorso URI del documento, questo non funzionerà. Vedi Impostazioni di configurazione dell'emittente di token affidabili. 1. Scegli **Email** come attributo Identity Provider e attributo IAM Identity Center. Dopo aver completato questi passaggi specifici per Entra ID, procedi alla [AWS Configurazione completa (tutti i provider)](#complete-aws-config-slack) sezione seguente. #### Configura IAM Identity Center con Okta Segui questi passaggi solo se utilizzi IAM Identity Center con Okta per configurare e configurare l'integrazione delle app nella console di amministrazione Okta: **Per configurare un'applicazione Okta** 1. Nel tuo account Okta, crea una nuova integrazione dell'app Okta. 1. **Nella tua console di amministrazione Okta, vai su Applicazioni > **Applicazioni**.** 1. Fai clic su **Crea integrazione tra app**. 1. Per il metodo di accesso, selezionare **OIDC - OpenID Connect.** 1. **Per il tipo di applicazione, selezionare Applicazione Web.** 1. Fate clic su **Avanti**. 1. Fornisci un nome per l'integrazione dell'app. 1. In **Tipo di concessione** > **Sovvenzioni principali**, assicurati che siano **selezionati Codice di autorizzazione** e **Token di aggiornamento**. 1. In **Tipo di concessione** > **Avanzato** > **Altre sovvenzioni**, assicurati che sia selezionata l'opzione **Implicito (ibrido)**. 1. Aggiungi callback URIs per ogni regione in cui verrà installata l'estensione Slack 1. Componi un URI di callback utilizzando il seguente formato, sostituendolo *your-region* con la tua regione di istanza Amazon Quick per ogni regione in cui desideri configurare l'estensione. L'estensione Slack supporta le seguenti regioni:`ap-southeast-2`,`eu-west-1`, `us-west-2` e. `us-east-1` ``` qbs-cell001.dp.appintegrations.your-region.prod.plato.ai.aws.dev/auth/idc-tti/callback ``` 1. In **Reindirizzamento dell'accesso URIs**, fai clic su **Aggiungi URI** e incolla ciascuno dei URIs dati generati nel passaggio precedente. 1. Fornisci alla tua organizzazione l'accesso all'app: 1. In **Assegnazioni** > **Accesso controllato**, seleziona i gruppi dell'organizzazione a cui è necessario accedere. 1. In **Assegnazioni** > **Abilita l'accesso immediato**, seleziona **Abilita l'accesso immediato con la modalità Federation Broker**. 1. Fai clic su **Salva**. 1. Annota il **Client ID** e il **Client Secret** per l'integrazione dell'app che hai appena creato. Ne avrai bisogno nei passaggi successivi. **Per configurare un emittente di token affidabile** 1. Accedi al tuo AWS account e accedi all'istanza di IAM Identity Center. 1. Vai su **Impostazioni** > **Autenticazione**. 1. Scegli **Crea emittente di token attendibili**. 1. Aggiungi l'URL dell'emittente, che dovrebbe seguire questo modello, dove *yourOktaDomain* si riferisce all'URL okta della tua organizzazione, che potrebbe essere simile a: `your-organization.okta.com` ``` https://{yourOktaDomain}/oauth2/default ``` **Nota** L'URL dell'emittente deve essere l'endpoint di rilevamento OIDC della vostra identità senza il noto percorso URI del documento. Se includi il noto percorso URI del documento, questo non funzionerà. Vedi Impostazioni di configurazione dell'emittente di token affidabili. 1. Scegli **Email** come attributo Identity Provider e attributo IAM Identity Center. Dopo aver completato questi passaggi specifici di OKTA, procedi alla sezione seguente[AWS Configurazione completa (tutti i provider)](#complete-aws-config-slack). #### AWS Configurazione completa (tutti i provider) Segui questi passaggi per configurare le autorizzazioni sulla AWS console: **Per configurare le autorizzazioni** 1. Vai a Secrets Manager sulla AWS console. 1. Scegli **Archivia un nuovo segreto**. 1. Scegli **Altro tipo di segreto** e scegli la scheda **Testo normale**. 1. Il tuo segreto deve essere nel seguente formato e utilizzare l'ID del client di registrazione dell'app e il segreto del client di registrazione dell'app che hai salvato nei passaggi precedenti: ``` { "client_id":"Your app registration client ID", "client_secret":"Your app registration client secret" } ``` 1. Vai al segreto che hai appena creato e salva l'ARN per dopo. 1. Ora accedi a IAM su AWS console. 1. Scegli **Gestione degli accessi****, Ruoli** nella barra di navigazione a sinistra. 1. Scegli **Crea ruolo**. 1. Scegli una **politica di fiducia personalizzata**. 1. Configura il ruolo di trust del nostro service principal per la regione pertinente che hai selezionato durante la configurazione dell'integrazione con l'app del provider di identità aggiungendo la seguente dichiarazione in sostituzione della regione che hai scelto durante la creazione dell'integrazione *your-region* con l'app del provider di identità: ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "your-region.prod.appintegrations.plato.aws.internal" }, "Action": "sts:AssumeRole", "Condition": {} } ] } ``` 1. Scegli **Next (Successivo)**. 1. Fornisci un nome e una descrizione e scegli **Crea ruolo**. 1. Vai al ruolo che hai appena creato e sceglilo. 1. Scegli **Aggiungi autorizzazioni**, **Crea politica in linea**. 1. Scegli **JSON**. 1. Configura il ruolo con le autorizzazioni per leggere i segreti da Secrets Manager e le autorizzazioni `sso:DescribeTrustedTokenIssuer` da invocare aggiungendo la seguente dichiarazione: ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "BasePermissions", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue", "sso:DescribeTrustedTokenIssuer" ], "Resource": "*" } ] } ``` 1. **Fornisci un nome per la policy e scegli Crea policy.** 1. Copia e salva l'ARN del ruolo IAM che hai creato per un secondo momento. Ti servirà nei passaggi successivi. Ora puoi seguire questi passaggi per creare una nuova configurazione di accesso alle estensioni che consenta ad Amazon Quick di integrarsi con il tuo ambiente Slack: **Per creare una configurazione di accesso alle estensioni** 1. Accedi alla console Amazon Quick. 1. In alto a destra, scegli l'icona dell'immagine del profilo. 1. Dal menu a discesa, scegli **Gestisci** account. 1. **In **Autorizzazioni**, scegli Accesso alle estensioni.** 1. In alto a destra, scegli **Nuovo accesso alle estensioni**. 1. Seleziona **Slack.** Quindi, seleziona **Successivo**. 1. Configura i campi seguenti: + **Nome**: un nome per l'estensione è precompilato automaticamente. Puoi modificarlo e inserire un nome descrittivo per l'estensione Slack (massimo 512 caratteri alfanumerici, trattini consentiti ma senza spazi). + **Descrizione (opzionale)**: una descrizione dell'estensione è precompilata automaticamente. Puoi modificarlo e inserire una nuova descrizione per fornire un contesto aggiuntivo sulla configurazione dell'estensione (massimo 1000 caratteri). + **ID Slack Workspace**: inserisci il tuo identificatore dell'area di lavoro Slack. L'area di lavoro IDs deve iniziare con «T» e contenere tra 1 e 256 caratteri alfanumerici. + **Secrets Role ARN**: incolla l'ARN del ruolo IAM che hai creato nei passaggi precedenti. + **Secrets ARN**: incolla l'ARN del segreto di Secrets Manager che hai creato nei passaggi precedenti. 1. Scegli **Aggiungi** per salvare la nuova configurazione di accesso. Un messaggio di conferma si aprirà in alto a destra dello schermo. 1. Dal messaggio di successo, scegli **Visualizza estensioni** per completare l'installazione dell'estensione. **Nota** Puoi anche accedere alla schermata di installazione da **Connessioni** > **Estensioni** nel menu Amazon Quick. Una volta creata, questa configurazione di accesso alle estensioni consente agli autori e agli altri amministratori dell'organizzazione di creare e distribuire estensioni Amazon Quick all'interno del tuo ambiente Slack. **Nota** Affinché gli utenti finali possano iniziare a utilizzare l'estensione Slack, un amministratore o un autore deve completare la distribuzione dell'estensione dopo aver configurato l'accesso all'estensione. Comunica ai tuoi autori che possono visualizzare, modificare e completare l'installazione di questa estensione in **Estensioni** nella barra di navigazione a sinistra dopo che è stata condivisa. Per sapere come eseguire questa operazione, consulta Installazione dell'estensione Slack nella guida all'autore dell'estensione Slack. ### Aggiungi Slack l'accesso tramite estensione per gli account che utilizzano altri metodi di autenticazione Segui questi passaggi per creare una nuova configurazione di accesso alle estensioni che consenta ad Amazon Quick di integrarsi con il tuo Slack ambiente. 1. Accedi alla console Amazon Quick. 1. In alto a destra, seleziona l'icona dell'immagine del profilo. 1. Dal menu a discesa, seleziona **Gestisci** account. 1. **In **Autorizzazioni**, seleziona Accesso alle estensioni.** 1. In alto a destra, seleziona **Nuovo accesso alle estensioni**. 1. SelezionaSlack, quindi, **Avanti**. 1. Configura i campi seguenti: + **Nome**: un nome per l'estensione è precompilato automaticamente. Puoi modificarlo e inserire un nome descrittivo per l'Slackestensione (massimo 512 caratteri alfanumerici, trattini consentiti ma senza spazi). + **Descrizione** (opzionale): una descrizione dell'estensione è precompilata automaticamente. Puoi modificarlo e inserire una nuova descrizione per fornire un contesto aggiuntivo sulla configurazione dell'estensione (massimo 1000 caratteri). + **Slack Workspace ID**: inserisci l'identificatore dell'Slackarea di lavoro. L'ID Workspace deve iniziare con T e avere una lunghezza compresa tra 1 e 256 caratteri alfanumerici. 1. Seleziona **Aggiungi** per salvare la nuova configurazione di accesso. Un messaggio di conferma si aprirà in alto a destra dello schermo. 1. Dal messaggio di successo, seleziona **Visualizza estensioni** per completare l'installazione dell'estensione. **Nota** Puoi anche accedere alla schermata di installazione da **Connessioni** > **Estensioni** nel menu Amazon Quick. Una volta creata, questa configurazione di accesso alle estensioni consente agli autori e agli altri amministratori dell'organizzazione di distribuire le estensioni Amazon Slack Quick nel proprio spazio di lavoro. **Nota** Affinché gli utenti finali possano iniziare a utilizzare Slack l'estensione, un amministratore o un autore deve completare la distribuzione dell'estensione dopo aver configurato l'accesso all'estensione. Informa i tuoi autori che possono visualizzare, modificare e completare l'installazione di questa estensione in **Estensioni** nella barra di navigazione a sinistra una volta condivisa. Per sapere come eseguire questa operazione, consulta [Installazione dell'Slackestensione nella guida all'autore dell'Slackestensione](https://docs.aws.amazon.com/quicksuite/latest/userguide/slack-extension-author-guide.html#add-extensions-slack). ### Modifica Slack l'accesso all'estensione Utilizza questi passaggi per modificare le impostazioni di configurazione di un accesso all'Slackestensione esistente. 1. Accedi alla console Amazon Quick. 1. In alto a destra, seleziona l'icona dell'immagine del profilo. 1. Dal menu a discesa, seleziona **Gestisci** account. 1. **In **Autorizzazioni**, seleziona Accesso alle estensioni.** 1. Seleziona l'icona del menu a tre punti per l'Slackestensione che devi modificare. 1. Seleziona **Edit (Modifica)**. 1. Modifica la configurazione come richiesto e seleziona **Salva** per confermare le modifiche. Le modifiche alla configurazione di accesso all'Slackestensione vengono salvate e avranno effetto immediato. ### Eliminare Slack l'accesso all'estensione Segui questi passaggi per rimuovere definitivamente una configurazione di accesso all'Slackestensione. Questa operazione non può essere annullata. 1. Accedi alla console Amazon Quick. 1. In alto a destra, seleziona l'icona dell'immagine del profilo. 1. Dal menu a discesa, seleziona **Gestisci** account. 1. **In **Autorizzazioni**, seleziona Accesso alle estensioni.** 1. Seleziona l'icona del menu a tre punti per l'Slackestensione che devi eliminare. 1. Seleziona **Elimina**. 1. Inserisci la parola, «conferma» e seleziona **ELIMINA**. **Nota** L'eliminazione dell'accesso a un'estensione rimuove l'accesso per tutti gli utenti nell'Slackarea di lavoro ed elimina tutte le estensioni create per. Slack Se l'accesso all'estensione non riesce, l'amministratore deve passare alla visualizzazione autore ed eliminare Slack le estensioni che utilizzano l'accesso all'estensione configurato prima di tornare a eliminare l'accesso all'estensione. Con Slack l'accesso alle estensioni configurato, il tuo team può ora utilizzare le menzioni **rapide di @Amazon** nei canali e nei messaggi diretti per accedere all'assistenza basata sull'intelligenza artificiale e alle conoscenze organizzative direttamente all'interno del proprio spazio Slack di lavoro.