View a markdown version of this page

Configurez la connexion d'entreprise avec Identifiant Microsoft Entra pour Amazon Quick sur ordinateur - Amazon Quick
Étape 1 : Création d'une application OIDC dans Identifiant Microsoft EntraÉtape 2 : ajouter l'accès à l'extension dans la console d'administration Amazon QuickÉtape 3 : Création de l'extension dans la console Amazon QuickÉtape 4 : Téléchargez, vérifiez et distribuez l'application de bureau

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurez la connexion d'entreprise avec Identifiant Microsoft Entra pour Amazon Quick sur ordinateur

 S’applique à : édition Enterprise 
   Public cible : administrateurs système 

Cette page vous explique les quatre étapes à suivre pour configurer la connexion d'entreprise avec Microsoft Entra ID :

  1. Créez une application OIDC dans Microsoft Entra ID et enregistrez ses valeurs.

  2. Ajoutez l'accès à l'extension dans la console d'administration Amazon Quick.

  3. Créez l'extension dans la console Amazon Quick.

  4. Téléchargez, vérifiez et distribuez l'application de bureau.

Note

Avant de commencer, passez en revue les prérequis dansConfiguration d'Amazon Quick sur ordinateur pour les déploiements en entreprise.

Étape 1 : Création d'une application OIDC dans Identifiant Microsoft Entra

Enregistrez une application cliente OIDC publique dans. Microsoft Entra ID L'application de bureau Amazon Quick utilise ce client pour authentifier les utilisateurs via le flux de code d'autorisation avec PKCE. Ce client n'a besoin d'aucun secret client. Accordez la offline_access portée afin que l'application puisse émettre des jetons d'actualisation. Dans le cas contraire, les utilisateurs doivent s'authentifier à nouveau fréquemment.

Pour plus d'informations, consultez la section Enregistrer une application dans la Microsoft Entra documentation.

Pour créer le Entrez votre identifiant enregistrement de l'application

  1. Dans le Azure portail, accédez à Microsoft Entra ID → Inscriptions d'applications → Nouvelle inscription.

  2. Configurez les paramètres suivants :

    Paramètre Value
    Nom Amazon Quick Desktop
    Types de comptes pris en charge Comptes figurant dans ce répertoire organisationnel uniquement (locataire unique)
    Plateforme d'URI de redirection Public client/native (mobile et ordinateur de bureau)
    URI de redirection http://localhost:18080

  3. Choisissez S’inscrire.

  4. Sur la page Vue d'ensemble, notez l'ID de l'application (client) et l'ID du répertoire (locataire). Vous aurez besoin de ces valeurs pour les étapes ultérieures.

Il s'agit d'un enregistrement public de client. Entra IDapplique automatiquement PKCE pour les clients publics.

Pour configurer les autorisations d'API

  1. Dans l'enregistrement de l'application, accédez à Autorisations API → Ajouter une autorisation → Microsoft Graph → Autorisations déléguées.

  2. Ajoutez les autorisations suivantes :openid,email,profile,offline_access.

  3. Choisissez Ajouter des autorisations.

  4. Si votre organisation l'exige, choisissez Accorder le consentement de l'administrateur pour [votre organisation].

Pour configurer les paramètres d'authentification

  1. Dans l'enregistrement de l'application, accédez à Authentification.

  2. Dans Paramètres avancés, définissez Autoriser les flux de clients publics sur Oui.

  3. Vérifiez que cela http://localhost:18080 figure dans la liste des applications mobiles et de bureau.

  4. Choisissez Enregistrer.

Pour configurer les réclamations relatives aux jetons

  1. Dans l'enregistrement de l'application, accédez à Configuration des jetons.

  2. Choisissez Ajouter une réclamation facultative.

  3. Sélectionnez le type de jeton : ID.

  4. Sélectionnez la email réclamation, puis cliquez sur Ajouter.

Important

Cette étape est obligatoire. Sans cette réclamation email facultative, l'adresse e-mail de l'utilisateur Microsoft Entra ID n'est pas incluse dans le jeton d'identification, et Amazon Quick ne peut pas associer le jeton à un utilisateur. En outre, chaque utilisateur qui se connecte doit avoir son attribut Mail renseigné dans son Entra ID profil (sous Informations de contact). Le nom d'utilisateur principal (UPN) à lui seul n'est pas suffisant : l'attribut Mail doit contenir une valeur.

Enregistrez les points de terminaison OIDC suivants. Vous entrez ces valeurs, ainsi que l'ID de l'application (client) que vous avez noté précédemment, à l'étape 2. <TENANT_ID>Remplacez-le par votre ID de répertoire (locataire).

Important

L'URL de l'émetteur doit inclure le suffixe du /v2.0 chemin. N'utilisez pas l'URL d'autorité affichée dans le panneau Entra ID Endpoints, qui omet ce suffixe. Si le /v2.0 suffixe est absent, la validation du jeton échoue et une erreur « Émetteur non valide » apparaît au moment de la connexion.

Champ Value
ID client L'ID de l'application (client) figurant sur la page de présentation de l'enregistrement de l'application
URL de l’émetteur https://login.microsoftonline.com/<TENANT_ID>/v2.0
Endpoint d'autorisation https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Point de terminaison de jeton https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
URI JWKS https://login.microsoftonline.com/<TENANT_ID>/discovery/v2.0/keys
Astuce

L'URI JWKS n'est pas affiché dans le panneau Microsoft Entra ID Endpoints. Vous pouvez le trouver en ouvrant l'URL du document de métadonnées OpenID Connect depuis le panneau Endpoints et en localisant le jwks_uri champ dans la réponse JSON. Vous pouvez également le construire en utilisant le format indiqué dans le tableau précédent.

Important

Si votre application possède des clés de signature personnalisées en raison de la fonctionnalité de mappage des revendications, vous devez ajouter un paramètre de appid requête contenant l'ID de l'application (client) à l'URI JWKS. Sinon, la validation des jetons échoue car le point de terminaison des clés par défaut ne renvoie pas la clé de signature personnalisée de l'application. Par exemple :

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

Pour confirmer la valeur correcte, ouvrez le document de métadonnées OpenID Connect en ajoutant le même appid paramètre (https://login.microsoftonline.com/<TENANT_ID>/.well-known/openid-configuration?appid=<CLIENT_ID>) et utilisez celui jwks_uri qu'il renvoie. Pour plus d'informations, voir Valider la signature dans la Microsoft Entra documentation.

Étape 2 : ajouter l'accès à l'extension dans la console d'administration Amazon Quick

Dans la console d'administration Amazon Quick, ajoutez une extension d'accès à l'aide des valeurs de point de terminaison OIDC et de l'ID client que vous avez enregistrés à l'étape 1.

Pour ajouter l'extension, accédez

  1. Connectez-vous à la console d'administration Amazon Quick et choisissez Gérer le compte.

  2. Dans le volet de navigation de gauche, sous Autorisations, choisissez Accès aux extensions.

  3. Choisissez Ajouter un accès à une extension.

  4. Sous Sélectionner un service, sélectionnez Amazon Quick (application de bureau pour Quick), puis choisissez Suivant.

  5. Entrez les détails de l'extension en utilisant les valeurs que vous avez enregistrées à l'étape 1 :

    Champ Value
    Nom Un nom pour cet accès à l'extension (par exemple,QuickDesktop-access). Il s'agit d'une référence interne uniquement et n'est pas configurée dans votre IdP. Utilisez uniquement des caractères alphanumériques et des tirets, sans espaces.
    Description (Facultatif) Une description de cet accès à l'extension, à titre de référence uniquement.
    URL de l’émetteur L'URL exacte de l'émetteur OIDC de l'étape 1, y compris tout suffixe de chemin requis.
    Endpoint d'autorisation URL du point de terminaison d'autorisation OIDC de l'étape 1
    Token Endpoint URL du point de terminaison du jeton OIDC de l'étape 1
    URI JWKS L'URI du jeu de clés Web JSON de l'étape 1
    ID client L'identifiant client OIDC (ID client ou ID de l'application (client)) que vous avez enregistré à l'étape 1. Obligatoire.

  6. Choisissez Ajouter.

    Important

    Vérifiez que toutes les valeurs sont correctes avant de choisir Ajouter. La configuration d'accès à l'extension ne peut pas être modifiée après sa création. Si une valeur est incorrecte, vous devez supprimer l'accès à l'extension et en créer un nouveau.

Étape 3 : Création de l'extension dans la console Amazon Quick

Après avoir ajouté l'accès à l'extension dans la console d'administration Amazon Quick, créez l'extension sur la page Extensions de la console Amazon Quick.

Pour créer l'extension

  1. Dans la console Amazon Quick, dans le volet de navigation de gauche, choisissez Extensions. Si les extensions ne s'affichent pas, choisissez Plus pour les trouver.

  2. Choisissez Ajouter une extension.

  3. Sélectionnez l'application de bureau pour l'accès rapide aux extensions que vous avez créée à l'étape 2, puis choisissez Suivant.

  4. Choisissez Créer.

Important

Les étapes 2 et 3 sont obligatoires. Si vous ajoutez l'accès à l'extension mais que vous ne créez pas l'extension, la connexion d'entreprise n'est pas disponible et l'erreur suivante s'affiche pour les utilisateurs : « La connexion d'entreprise pour Quick Desktop n'a pas été configurée pour ce compte ».

Note

La création de l'extension est une action ponctuelle au niveau du compte. Une fois l'extension créée par un administrateur, la connexion d'entreprise est disponible pour tous les utilisateurs du compte. Les utilisateurs individuels n'ont pas besoin d'activer l'extension eux-mêmes, ils doivent simplement télécharger l'application de bureau et se connecter.

Étape 4 : Téléchargez, vérifiez et distribuez l'application de bureau

Au cours de cette étape, vous téléchargez et installez l'application de bureau, vous vérifiez que la connexion d'entreprise fonctionne, puis vous distribuez l'application à vos utilisateurs.

Tout d'abord, téléchargez l'application depuis la console Amazon Quick.

Pour télécharger l'application de bureau

  1. Dans la console Amazon Quick, dans le volet de navigation de gauche, choisissez Extensions. Si les extensions ne s'affichent pas, choisissez Plus pour les trouver.

  2. Sélectionnez l'extension Quick Desktop que vous avez créée à l'étape 3.

  3. Cliquez sur l'icône Plus d'options (... ) pour l'extension.

  4. Choisissez Télécharger pour Windows ou Télécharger pour Mac, selon votre système d'exploitation.

Ensuite, installez l'application. Pour obtenir des instructions d’installation, consultez Prise en main.

Après avoir installé l'application, vérifiez que la connexion d'entreprise fonctionne.

Pour vérifier la connexion d'entreprise

  1. Ouvrez l'application de bureau Amazon Quick.

  2. Sur l'écran de connexion, choisissez Continuer avec le SSO.

  3. (Facultatif) Sélectionnez votre Région AWS région dans la liste ou choisissez Dynamique pour que l'application détecte automatiquement votre région.

  4. Authentifiez-vous à l'aide des informations d'identification de votre entreprise. L'application redirige vers votre fournisseur d'identité, puis revient à l'écran d'accueil une fois l'authentification réussie.

Astuce

Si la connexion échoue, vérifiez les valeurs que vous avez saisies à l'étape 2 par rapport aux points de terminaison OIDC et à l'ID client de l'étape 1. Si une valeur est incorrecte, supprimez l'accès à l'extension sous Autorisations → Accès à l'extension dans la console d'administration Amazon Quick, puis répétez l'étape 2 avec les valeurs correctes. Pour obtenir de l'aide supplémentaire, consultezRésolution des problèmes liés à la connexion d'entreprise à Amazon Quick sur ordinateur.

Enfin, après avoir vérifié la configuration, distribuez l'application à vos utilisateurs. Dirigez-les vers Prise en main les instructions de téléchargement, d'installation et de connexion. Les utilisateurs choisissent Continuer avec SSO et se connectent à l'aide de leurs informations d'identification professionnelles. Aucune configuration supplémentaire par utilisateur n'est requise.