View a markdown version of this page

Configura l'accesso aziendale con ID Microsoft Entra per Amazon Quick su desktop - Amazon Quick
Fase 1: Creare un'applicazione OIDC in ID Microsoft EntraPassaggio 2: aggiungi l'accesso all'estensione nella console di amministrazione di Amazon QuickPassaggio 3: crea l'estensione nella console Amazon QuickPassaggio 4: scarica, verifica e distribuisci l'applicazione desktop

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

Configura l'accesso aziendale con ID Microsoft Entra per Amazon Quick su desktop

 Si applica a: Enterprise Edition 
   Destinatari: amministratori di sistema 

Questa pagina illustra tutti e quattro i passaggi per configurare l'accesso aziendale con: Microsoft Entra ID

  1. Crea un'applicazione OIDC Microsoft Entra ID e registrane i valori.

  2. Aggiungi l'accesso all'estensione nella console di amministrazione di Amazon Quick.

  3. Crea l'estensione nella console Amazon Quick.

  4. Scarica, verifica e distribuisci l'applicazione desktop.

Nota

Prima di iniziare, rivedi i prerequisiti inConfigurazione di Amazon Quick su desktop per distribuzioni aziendali.

Fase 1: Creare un'applicazione OIDC in ID Microsoft Entra

Registra un'applicazione client OIDC pubblica in. Microsoft Entra ID L'applicazione desktop Amazon Quick utilizza questo client per autenticare gli utenti tramite il flusso di codice di autorizzazione con PKCE. Questo client non richiede alcun segreto. Concedi l'offline_accessambito in modo che l'applicazione possa emettere token di aggiornamento. In caso contrario, gli utenti devono riautenticarsi frequentemente.

Per ulteriori informazioni, consulta Registrare un'applicazione nella Microsoft Entra documentazione.

Per creare Inserisci l'ID registrazione all'app

  1. Nel Azure portale, vai a Microsoft Entra ID → Registrazioni app → Nuova registrazione.

  2. Configura le impostazioni seguenti:

    Impostazione Valore
    Nome Amazon Quick Desktop
    Tipi di account supportati Solo account in questo elenco organizzativo (tenant singolo)
    Piattaforma URI di reindirizzamento Pubblica client/native (mobile e desktop)
    URI di reindirizzamento http://localhost:18080

  3. Scegli Registrati.

  4. Nella pagina Panoramica, annota l'ID dell'applicazione (client) e l'ID della directory (tenant). Questi valori saranno necessari nei passaggi successivi.

Questa è una registrazione pubblica del cliente. Entra IDapplica automaticamente il PKCE per i client pubblici.

Per configurare le autorizzazioni API

  1. Nella registrazione dell'app, vai a Autorizzazioni API → Aggiungi un'autorizzazione → → Autorizzazioni delegate. Microsoft Graph

  2. Aggiungi le seguenti autorizzazioni:openid,,,. email profile offline_access

  3. Scegli Add Permissions (Aggiungi autorizzazioni).

  4. Se la tua organizzazione lo richiede, scegli Concedi il consenso all'amministratore per [la tua organizzazione].

Per configurare le impostazioni di autenticazione

  1. Nella registrazione dell'app, vai a Autenticazione.

  2. In Impostazioni avanzate, imposta Consenti flussi di client pubblici su Sì.

  3. Verifica che http://localhost:18080 sia elencato in Applicazioni mobili e desktop.

  4. Scegli Save (Salva).

Per configurare le dichiarazioni relative ai token

  1. Nella registrazione dell'app, vai a Configurazione dei token.

  2. Scegli Aggiungi reclamo opzionale.

  3. Seleziona il tipo di token: ID.

  4. Seleziona il email reclamo e scegli Aggiungi.

Importante

Questo passaggio è obbligatorio. Senza il claim email opzionale, Microsoft Entra ID non include l'indirizzo email dell'utente nel token ID e Amazon Quick non può mappare il token a un utente. Inoltre, ogni utente che effettua l'accesso deve avere il proprio attributo Mail inserito nel proprio Entra ID profilo (nella sezione Informazioni di contatto). Il nome utente principale (UPN) da solo non è sufficiente: l'attributo Mail deve contenere un valore.

Registra i seguenti endpoint OIDC. Inserisci questi valori, insieme all'ID dell'applicazione (client) che hai annotato in precedenza, nel passaggio 2. Sostituiscili <TENANT_ID> con il tuo ID di Directory (tenant).

Importante

L'URL dell'emittente deve includere il suffisso del /v2.0 percorso. Non utilizzare l'URL di autorità mostrato nel pannello Entra ID Endpoints, che omette questo suffisso. Se manca il /v2.0 suffisso, la convalida del token fallisce con un errore «Emittente non valido» al momento dell'accesso.

Campo Valore
ID client L'ID dell'applicazione (client) riportato nella pagina di panoramica della registrazione dell'app
URL dell’emittente https://login.microsoftonline.com/<TENANT_ID>/v2.0
Endpoint di autorizzazione https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Endpoint Token https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
JWKS URI https://login.microsoftonline.com/<TENANT_ID>/discovery/v2.0/keys
Suggerimento

L'URI JWKS non viene visualizzato nel pannello Endpoints. Microsoft Entra ID Puoi trovarlo aprendo l'URL del documento di metadati OpenID Connect dal pannello Endpoints e individuando il campo nella risposta JSON. jwks_uri In alternativa, costruiscilo usando il formato mostrato nella tabella precedente.

Importante

Se l'applicazione dispone di chiavi di firma personalizzate grazie alla funzionalità di mappatura dei claim, è necessario aggiungere un parametro di appid query contenente l'ID dell'applicazione (client) all'URI JWKS. In caso contrario, la convalida del token non riesce perché l'endpoint delle chiavi predefinito non restituisce la chiave di firma personalizzata dell'applicazione. Ad esempio:

https://login.microsoftonline.com/<TENANT_ID>/discovery/v2.0/keys?appid=<CLIENT_ID>

Per confermare il valore corretto, aprite il documento di metadati OpenID Connect con lo stesso appid parametro appended (https://login.microsoftonline.com/<TENANT_ID>/.well-known/openid-configuration?appid=<CLIENT_ID>) e usate quello che restituisce. jwks_uri Per ulteriori informazioni, consulta Convalida della firma nella documentazione. Microsoft Entra

Passaggio 2: aggiungi l'accesso all'estensione nella console di amministrazione di Amazon Quick

Nella console di amministrazione di Amazon Quick, aggiungi un accesso all'estensione utilizzando i valori degli endpoint OIDC e l'ID cliente registrati nel passaggio 1.

Per aggiungere l'accesso all'estensione

  1. Accedi alla console di amministrazione di Amazon Quick e scegli Gestisci account.

  2. Nel riquadro di navigazione a sinistra, in Autorizzazioni, scegli Accesso con estensione.

  3. Scegli Aggiungi accesso all'estensione.

  4. In Seleziona servizio, seleziona Amazon Quick (applicazione desktop per Quick), quindi scegli Avanti.

  5. Inserisci i dettagli dell'estensione utilizzando i valori registrati nel passaggio 1:

    Campo Valore
    Nome Un nome per questo accesso all'estensione (ad esempio,QuickDesktop-access). Questo è solo un riferimento interno e non è configurato nel tuo IdP. Usa solo caratteri alfanumerici e trattini, senza spazi.
    Description (Facoltativo) Una descrizione di questo accesso all'estensione, solo come riferimento.
    URL dell’emittente L'URL esatto dell'emittente OIDC indicato nella Fase 1, incluso l'eventuale suffisso di percorso richiesto.
    Endpoint di autorizzazione L'URL dell'endpoint di autorizzazione OIDC indicato nella Fase 1
    Token Endpoint L'URL dell'endpoint del token OIDC riportato nella Fase 1
    JWKS URI L'URI del set di chiavi Web JSON del passaggio 1
    ID client L'identificatore del client OIDC (ID client o ID dell'applicazione (client)) registrato nel passaggio 1. Obbligatorio.

  6. Scegliere Aggiungi.

    Importante

    Verifica che tutti i valori siano corretti prima di scegliere Aggiungi. La configurazione di accesso all'estensione non può essere modificata dopo la creazione. Se un valore non è corretto, è necessario eliminare l'accesso all'estensione e crearne uno nuovo.

Passaggio 3: crea l'estensione nella console Amazon Quick

Dopo aver aggiunto l'accesso all'estensione nella console di amministrazione di Amazon Quick, crea l'estensione nella pagina Estensioni della console Amazon Quick.

Per creare l'estensione

  1. Nella console Amazon Quick, nel riquadro di navigazione a sinistra, scegli Estensioni. Se non vedi le estensioni, scegli Altro per trovarle.

  2. Scegli Aggiungi estensione.

  3. Seleziona l'applicazione desktop per l'accesso rapido alle estensioni che hai creato nel passaggio 2, quindi scegli Avanti.

  4. Scegli Create (Crea).

Importante

Sono obbligatori sia il passaggio 2 che il passaggio 3. Se aggiungi l'accesso all'estensione ma non crei l'estensione, l'accesso aziendale non è disponibile e gli utenti visualizzano l'errore: «L'accesso aziendale per Quick Desktop non è stato configurato per questo account».

Nota

La creazione dell'estensione è un'azione una tantum a livello di account. Dopo che un amministratore ha creato l'estensione, l'accesso aziendale è disponibile per tutti gli utenti dell'account. I singoli utenti non devono abilitare l'estensione da soli: devono solo scaricare l'applicazione desktop e accedere.

Passaggio 4: scarica, verifica e distribuisci l'applicazione desktop

In questo passaggio, scarichi e installi l'applicazione desktop, verifichi che l'accesso aziendale funzioni e quindi distribuisci l'applicazione ai tuoi utenti.

Innanzitutto, scarica l'applicazione dalla console Amazon Quick.

Per scaricare l'applicazione desktop

  1. Nella console Amazon Quick, nel riquadro di navigazione a sinistra, scegli Estensioni. Se non vedi le estensioni, scegli Altro per trovarle.

  2. Seleziona l'estensione Quick Desktop che hai creato nel passaggio 3.

  3. Scegli l'icona Altre opzioni (... ) per l'estensione.

  4. Scegli Scarica per Windows o Scarica per Mac, a seconda del sistema operativo in uso.

Quindi, installa l'applicazione. Per le istruzioni di installazione, consulta Nozioni di base.

Dopo aver installato l'applicazione, verifica che l'accesso aziendale funzioni.

Per verificare l'accesso aziendale

  1. Apri l'applicazione desktop Amazon Quick.

  2. Nella schermata di accesso, scegli Continua con SSO.

  3. (Facoltativo) Seleziona la tua regione Regione AWS dall'elenco o scegli Dinamico per fare in modo che l'applicazione rilevi automaticamente la tua regione.

  4. Effettua l'autenticazione con le tue credenziali aziendali. L'applicazione reindirizza al tuo provider di identità e quindi torna alla schermata Home dopo il successo dell'autenticazione.

Suggerimento

Se l'accesso non riesce, verifica i valori inseriti nel passaggio 2 rispetto agli endpoint OIDC e all'ID client del passaggio 1. Se un valore non è corretto, elimina l'accesso all'estensione in Autorizzazioni → Accesso alle estensioni nella console di amministrazione di Amazon Quick e ripeti il passaggio 2 con i valori corretti. Per ulteriore assistenza, consultaRisoluzione dei problemi di accesso aziendale per Amazon Quick su desktop.

Infine, dopo aver verificato la configurazione, distribuisci l'applicazione ai tuoi utenti. Indirizzali a loro Nozioni di base per le istruzioni per il download, l'installazione e l'accesso. Gli utenti scelgono Continua con SSO e accedono con le proprie credenziali aziendali: non è richiesta alcuna configurazione aggiuntiva per utente.