

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
<a name="desktop-enterprise-ping-identity"></a>


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

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

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

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

**Note**  
Avant de commencer, passez en revue les prérequis dans[Configuration d'Amazon Quick sur ordinateur pour les déploiements en entreprise](desktop-enterprise-setup.md).

## Étape 1 : Création d'une application OIDC dans Ping Identity
<a name="desktop-enterprise-ping-identity-step1"></a>

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
<a name="desktop-enterprise-pingfederate"></a>

Pour plus d'informations, consultez la section [ Configuration d'une application OIDC PingFederate](https://docs.pingidentity.com/solution-guides/customer_use_cases/htg_oidc_app_setup_pf.html) 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. **

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

1. Dans le champ **Nom**, saisissez `Amazon Quick Desktop`.

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

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

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

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

1. Dans ** Common Scopes**, accordez les autorisations suivantes :`openid`,, `email``profile`,`offline_access`.

1. Choisissez **Enregistrer**.

1. 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. **

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

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

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

1. 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
<a name="desktop-enterprise-pingone"></a>

Pour plus d'informations, consultez la section [ Modification d'une application — Native ](https://docs.pingidentity.com/pingone/applications/p1_edit_application_native.html) 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 ** \+.

1. Entrez le `Amazon Quick Desktop` nom de l'application.

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

1. Dans l'**onglet ** Configuration, choisissez ** Modifier ** et configurez les paramètres suivants :    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/desktop-enterprise-ping-identity.html)

1. Choisissez **Enregistrer**.

1. Dans l'**onglet ** Ressources, ajoutez les étendues suivantes :`openid`,, `email``profile`,`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 `email``profile`, et dans l'`offline_access`**onglet ** 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.

1. Dans l'**onglet Mappages d'**attributs, vérifiez que l'`email`attribut est mappé à l'adresse e-mail de l'utilisateur.

1. Basculez l'application sur ** Activé. **

1. 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
<a name="w2aac51c11c25c15"></a>

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

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

1. Choisissez ** Ajouter un accès à une extension**.

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

1. Entrez les détails de l'extension en utilisant les valeurs que vous avez enregistrées à l'étape 1 :    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/desktop-enterprise-ping-identity.html)

1. 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
<a name="w2aac51c11c25c17"></a>

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.

1. Choisissez ** Ajouter une extension**.

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

1. 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
<a name="w2aac51c11c25c19"></a>

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.

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

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

1. 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](getting-started-desktop.md).

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.

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

1. (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.

1. 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, consultez[Résolution des problèmes liés à la connexion d'entreprise à Amazon Quick sur ordinateur](desktop-enterprise-setup-troubleshooting.md).

Enfin, après avoir vérifié la configuration, distribuez l'application à vos utilisateurs. Dirigez-les vers [Prise en main](getting-started-desktop.md) 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.