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.
Configurer la connexion d'entreprise avec Ping Identity pour Amazon Quick sur ordinateur
| S’applique à : édition Enterprise |
| Public cible : administrateurs système |
Cette page explique les quatre étapes de configuration de la connexion d'entreprise avec Ping Identity :
-
Créez une application OIDC dans votre produit Ping Identity (PingFederate ou PingOne) et enregistrez ses valeurs.
-
Ajoutez l'accès à l'extension dans la console d'administration Amazon Quick.
-
Créez l'extension dans la console Amazon Quick.
-
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éer une application OIDC dans Ping Identity
Enregistrez un client OIDC public dans votre produit Ping Identity. 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 pas besoin de secret client. Activez le type de subvention Refresh Token et accordez la offline_access portée. Choisissez les instructions pour votre produit Ping Identity.
PingFederate
Pour plus d'informations, consultez la section Configuration d'une application OIDC PingFederate dans
Pour créer le client PingFederate OIDC
-
Dans la console d' PingFederate administration, accédez à Applications → OAuth → Clients, puis choisissez Ajouter un client.
-
Dans le champ ID client, entrez un identifiant unique pour ce client.
-
Dans le champ Nom, saisissez
Amazon Quick Desktop. -
Pour l'authentification du client, sélectionnez Aucune.
-
Dans la section URI de redirection, entrez
http://localhost:18080et choisissez Ajouter. -
Dans la liste des types de subventions autorisés, sélectionnez Code d'autorisation et Actualiser le jeton.
-
Cochez la case Exiger une clé de preuve pour l'échange de code (PKCE).
-
Sous Champs d'application communs, accordez les éléments suivants :
openid,email,profile,offline_access. -
Choisissez Enregistrer.
-
Notez l'ID du client. Vous aurez besoin de cette valeur lors des étapes ultérieures.
Pour configurer la politique OIDC
-
Dans la console d' PingFederate administration, accédez à Applications → OAuth → OpenID Connect Policy Management.
-
Sélectionnez la politique OIDC associée à ce client ou choisissez Ajouter une politique pour en créer une.
-
Cochez la case Return ID Token on Refresh Grant. Cela garantit que l'application de bureau reçoit un nouveau jeton d'identification avec les demandes en cours lors de l'actualisation de la session.
-
Sous Contrat d'attribut, vérifiez que la
emailréclamation est incluse et mappée à l'attribut utilisateur correspondant dans votre source d'authentification. Laemailréclamation doit être présente sous forme de jetons émis à la fois lors de l'authentification initiale et lors de l'attribution des jetons d'actualisation. -
Choisissez Enregistrer.
Enregistrez les points de terminaison OIDC suivants. Vous entrez ces valeurs, ainsi que l'ID client que vous avez noté précédemment, à l'étape 2. <PINGFEDERATE_HOST>Remplacez-le par le nom d'hôte PingFederate de votre serveur.
| Champ | Value |
|---|---|
| ID client | L'ID client que vous avez saisi lors de la création du client |
| URL de l’émetteur | https://<PINGFEDERATE_HOST> |
| Point final d'autorisation | https://<PINGFEDERATE_HOST>/as/authorization.oauth2 |
| Point de terminaison de jeton | https://<PINGFEDERATE_HOST>/as/token.oauth2 |
| JWKS URI | https://<PINGFEDERATE_HOST>/pf/JWKS |
PingOne
Pour plus d'informations, consultez la section Modification d'une application — native
Pour créer l'application native PingOne OIDC
-
Dans la console PingOne d'administration, allez dans Applications → Applications et cliquez sur l'icône +.
-
Entrez
Amazon Quick Desktopcomme nom de l'application. -
Dans la section Type d'application, sélectionnez Native, puis cliquez sur Enregistrer.
-
Dans l'onglet Configuration, choisissez Modifier et configurez les paramètres suivants :
Paramètre Value Type de réponse Code Type de subvention Code d'autorisation et jeton d'actualisation Application de la PKCE S256 URI de redirection http://localhost:18080Méthode d'authentification Token Endpoint Aucune -
Choisissez Enregistrer.
-
Dans l'onglet Ressources, ajoutez les étendues suivantes :
openid,,emailprofile,offline_access. -
Dans l'onglet Mappages d'attributs, vérifiez que l'
emailattribut est mappé à l'adresse e-mail de l'utilisateur. -
Basculez l'application sur Activé.
-
Notez l'ID client et l'ID d'environnement dans l'onglet Configuration.
Note
Le PingOne domaine varie selon les régions. L'exemple suivant utilise .com. Remplacez le domaine par celui de votre environnement (par exemple.ca,.eu, ou.asia).
Enregistrez les points de terminaison OIDC suivants. Vous entrez ces valeurs, ainsi que l'ID client que vous avez noté précédemment, à l'étape 2. <ENV_ID>Remplacez-le par votre identifiant d' PingOne environnement.
| Champ | Value |
|---|---|
| ID client | L'ID du client dans l'onglet Configuration |
| URL de l’émetteur | https://auth.pingone.com/<ENV_ID>/as |
| Point final d'autorisation | https://auth.pingone.com/<ENV_ID>/as/authorize |
| Point de terminaison de jeton | https://auth.pingone.com/<ENV_ID>/as/token |
| JWKS URI | https://auth.pingone.com/<ENV_ID>/as/jwks |
Étape 2 : ajouter l'accès à l'extension dans la console d'administration Amazon Quick
Dans la console d'administration Amazon Quick, ajoutez un accès à une extension à l'aide des valeurs du point de terminaison OIDC et de l'ID client que vous avez enregistrés à l'étape 1.
Pour ajouter l'accès à l'extension
-
Connectez-vous à la console d'administration Amazon Quick et choisissez Gérer le compte.
-
Dans le volet de navigation de gauche, sous Autorisations, choisissez Extension access.
-
Choisissez Ajouter un accès à l'extension.
-
Sous Select Service, sélectionnez Amazon Quick (application de bureau pour Quick), puis choisissez Next.
-
Entrez les détails de l'extension en utilisant les valeurs que vous avez enregistrées à l'étape 1 :
Champ Value Nom 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 Point de terminaison Tok URL du point de terminaison du jeton OIDC de l'étape 1 JWKS URI L'URI du jeu de clés Web JSON à partir de l'étape 1 ID client L'identifiant du client OIDC (ID client ou ID d'application (client)) que vous avez enregistré à l'étape 1. Obligatoire. -
Choisissez Ajouter.
Important
Vérifiez que toutes les valeurs sont correctes avant de sélectionner 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éer 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
-
Dans la console Amazon Quick, dans le volet de navigation de gauche, sélectionnez Extensions. Si aucune extension n'apparaît, sélectionnez Plus pour la trouver.
-
Choisissez Ajouter une extension.
-
Sélectionnez l'application de bureau pour un accès rapide aux extensions que vous avez créée à l'étape 2, puis choisissez Next.
-
Choisissez Créer.
Important
Les étapes 2 et 3 sont toutes deux 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 les utilisateurs voient le message d'erreur suivant : « 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 qu'un administrateur a créé l'extension, la connexion d'entreprise est disponible pour tous les utilisateurs du compte. Les utilisateurs individuels n'ont pas besoin d'activer eux-mêmes l'extension ; ils doivent simplement télécharger l'application de bureau et se connecter.
Étape 4 : télécharger, vérifier et distribuer 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
-
Dans la console Amazon Quick, dans le volet de navigation de gauche, sélectionnez Extensions. Si aucune extension n'apparaît, sélectionnez Plus pour la trouver.
-
Sélectionnez l'extension Quick Desktop que vous avez créée à l'étape 3.
-
Choisissez l'icône Plus d'options (... ) pour l'extension.
-
Choisissez Télécharger pour Windows ou Télécharger pour Mac, en fonction de votre système d'exploitation.
Installez ensuite 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 de l'entreprise
-
Ouvrez l'application de bureau Amazon Quick.
-
Sur l'écran de connexion, choisissez Continuer avec SSO.
-
(Facultatif) Sélectionnez votre Région AWS région dans la liste ou choisissez Dynamic pour que l'application détecte automatiquement votre région.
-
Authentifiez-vous à l'aide des informations d'identification de votre entreprise. L'application est redirigée 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 aux extensions 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 de connexion d'entreprise pour Amazon Quick sur ordinateur.
Enfin, après avoir vérifié la configuration, distribuez l'application à vos utilisateurs. Dirigez-les vers Prise en main pour obtenir des instructions de téléchargement, d'installation et de connexion. Les utilisateurs choisissent Continuer avec l'authentification unique et se connectent à l'aide de leurs informations d'identification professionnelles. Aucune configuration supplémentaire par utilisateur n'est requise.