View a markdown version of this page

Configurez la connexion d'entreprise avec Ping Identity pour Amazon Quick sur ordinateur - Amazon Quick
Étape 1 : Création d'une application OIDC dans Ping IdentityÉ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 Ping Identity 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 Ping Identity :

  1. Créez une application OIDC dans votre Ping Identity produit (PingFederateouPingOne) 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 Ping Identity

Enregistrez un client OIDC public dans votre Ping Identity produit. 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. Activez le type d'octroi Refresh Token et accordez la offline_access portée. Choisissez les instructions correspondant à votre Ping Identity produit.

PingFederate

Pour plus d'informations, consultez la section Configuration d'une application OIDC PingFederate dans la Ping Identity documentation.

Pour créer le PingFederate Client OIDC

  1. Dans la console d'PingFederateadministration, accédez à Applications → OAuth → Clients, puis choisissez Ajouter un client.

  2. Dans le champ ID client, entrez un identifiant unique pour ce client.

  3. Dans le champ Nom, saisissez Amazon Quick Desktop.

  4. Pour l'authentification du client, sélectionnez Aucune.

  5. Dans la section URI de redirection, saisissez http://localhost:18080 et choisissez Ajouter.

  6. Dans la liste des types de subventions autorisés, sélectionnez Code d'autorisation et actualiser le jeton.

  7. Cochez la case Exiger une clé de preuve pour l'échange de code (PKCE).

  8. Dans Common Scopes, accordez les autorisations suivantes :openid,, emailprofile,offline_access.

  9. Choisissez Enregistrer.

  10. Notez l'ID client. Vous aurez besoin de cette valeur pour les étapes ultérieures.

Pour configurer la politique OIDC

  1. Dans la console d'PingFederateadministration, accédez à Applications → OAuth → OpenID Connect Policy Management.

  2. Sélectionnez la politique OIDC associée à ce client ou choisissez Ajouter une politique pour en créer une.

  3. Cochez la case Retourner le jeton d'identification lors de l'actualisation de l'autorisation. Cela garantit que l'application de bureau reçoit un nouveau jeton d'identification avec les demandes actuelles lors de l'actualisation de la session.

  4. Sous Contrat d'attribut, vérifiez que la email réclamation est incluse et mappée à l'attribut utilisateur correspondant dans votre source d'authentification. La email réclamation doit figurer sur les jetons émis à la fois lors de l'authentification initiale et lors de l'attribution des jetons d'actualisation.

  5. 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. Remplacez-le <PINGFEDERATE_HOST> par le nom d'hôte de votre PingFederate 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>
Endpoint d'autorisation https://<PINGFEDERATE_HOST>/as/authorization.oauth2
Point de terminaison de jeton https://<PINGFEDERATE_HOST>/as/token.oauth2
URI JWKS https://<PINGFEDERATE_HOST>/pf/JWKS

PingOne

Pour plus d'informations, consultez la section Modification d'une application — Native dans la Ping Identity documentation.

Pour créer le PingOne Application native OIDC

  1. Dans la console PingOne d'administration, allez dans Applications → Applications et choisissez l'icône +.

  2. Entrez le Amazon Quick Desktop nom de l'application.

  3. Dans la section Type d'application, sélectionnez Natif, puis cliquez sur Enregistrer.

  4. 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
    Mise en application de la PKCE S256
    URI de redirection http://localhost:18080
    Méthode d'authentification Token Endpoint Aucune

  5. Choisissez Enregistrer.

  6. Dans l'onglet Ressources, ajoutez les étendues suivantes :openid,, emailprofile,offline_access.

    Ajoutez des étendues dans l'onglet Ressources, et non dans l'onglet Configuration

    Il s'agit d'une étape distincte de celle de l'onglet Configuration. PingOneaccorde uniquement la openid portée par défaut, vous devez donc ajouter explicitement emailprofile, et dans l'offline_accessonglet Ressources. Si vous ignorez cette étape, la connexion échoue avec le message « Echec de la demande d'informations utilisateur (HTTP 401) ». Cette erreur se produit car la connexion nécessite des jetons émis avec ces étendues et PingOne ne les accorde que si vous les ajoutez dans cet onglet.

  7. Dans l'onglet Mappages d'attributs, vérifiez que l'emailattribut est mappé à l'adresse e-mail de l'utilisateur.

  8. Basculez l'application sur Activé.

  9. 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'PingOneenvironnement.

Champ Value
ID client L'ID client de l'onglet Configuration
URL de l’émetteur https://auth.pingone.com/<ENV_ID>/as
Endpoint d'autorisation https://auth.pingone.com/<ENV_ID>/as/authorize
Point de terminaison de jeton https://auth.pingone.com/<ENV_ID>/as/token
URI JWKS https://auth.pingone.com/<ENV_ID>/as/jwks
Utilisez le chemin d'URI JWKS correct pour PingOne

Pour l'URI JSON Web Key Set (JWKS), utilisez le /as/jwks chemin indiqué dans le tableau précédent. Ne pas utiliser/.well-known/jwks.json, car il peut apparaître comme espace réservé dans certains PingOne formulaires. PingOnen'utilise pas ce chemin et la validation du jeton de connexion échoue si vous le saisissez.

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

Commencez par télécharger 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.