Gestion d'applications externes

Les applications externes enregistrées peuvent avoir accès aux ressources UiPath pour le locataire actuel via une API en utilisant le flux OAuth 2.0.

Remarque : vous devez être un administrateur pour que le locataire puisse effectuer les tâches décrites sur cette page.

Ajout d'une application externe

Pour enregistrer une application externe afin qu'elle puisse accéder à vos ressources UiPath à l'aide d'OAuth :

1. Connectez-vous au locataire en tant qu'administrateur.
2. Accédez à Locataire (Tenant) > Gérer l'accès (Manage Access) > Attribuer des rôles (Assign Roles) et cliquez sur Gérer les comptes et les groupes (Manage Accounts & Groups). Le portail de gestion au niveau du locataire s'ouvre.
3. Sur la gauche, sélectionnez Applications externes (External Applications). La page Applications externes (External Applications) s'ouvre, et la liste de toutes les applications externes enregistrées pour le locataire actuel apparaît :
   
   

   

   
   
4. Au-dessus du tableau, à droite, cliquez sur Ajouter une application (Add Application).
5. Remplissez le champ Nom de l'application (Application Name).
6. Sélectionnez une option pour Type d'application (Application Type).
   

   Si vous sélectionnez Application confidentielle (Confidential application), vous recevez une clé secrète d'application à la fin ; assurez-vous donc que votre application peut le stocker en toute sécurité. Si ce n'est pas le cas, sélectionnez Application non confidentielle (Non-confidential application).

7. Sous Ressources (Resources), cliquez sur Ajouter des étendues (Add Scopes).
   Le panneau Modifier la ressource (Edit Resource) s'ouvre sur la droite, où vous pouvez sélectionner les ressources auxquelles l'application doit avoir accès.
8. Dans la liste déroulante Ressource (Resource), sélectionnez l'API UiPath que l'application peut utiliser.
   Remarque : Vous ne pouvez ajouter une étendue que pour une seule ressource à la fois. Si vous souhaitez autoriser l'accès à plusieurs ressources, répétez ce processus pour ajouter une étendue pour chaque ressource.
9. Dans l'onglet Étendue(s) des utilisateurs (User Scope(s)), cochez les cases des autorisations d'API logiques que vous souhaitez accorder, selon vos besoins.

   L'octroi d'autorisations sous l'étendue de l'utilisateur signifie que l'application externe peut accéder à ces ressources dans un contexte utilisateur et qu'un utilisateur disposant des autorisations appropriées doit être connecté.

10. S'il s'agit d'une application confidentielle, vous pouvez basculer vers l'onglet Étendue(s) de l'application (Application Scope(s)) pour accorder également des autorisations au niveau de l'application pour la ressource sélectionnée, si nécessaire.

    Avec des autorisations sous l'étendue de l'application, l'application externe a accès aux données à l'échelle de l'application pour les étendues sélectionnées sans avoir besoin d'interaction de l'utilisateur.

    Les applications non confidentielles ne peuvent pas accéder à l'étendue de l'application.

11. Cliquez sur Enregistrer. Le panneau se ferme et la ressource et les étendues sélectionnées sont ajoutées au tableau Ressources (Resources) du formulaire.
12. Si l'application externe le permet, vous pouvez ajouter une URL dans le champ Rediriger l’URL (Redirect URL) ; la réponse d'autorisation y sera envoyée. L'application peut ensuite l'utiliser pour accéder aux ressources UiPath.
13. Cliquez sur Ajouter (Add) pour créer l'enregistrement.
    Un message de confirmation s'ouvre. Pour les applications confidentielles, le message de confirmation inclut la clé secrète de l'application que l'application externe enregistrée peut utiliser pour demander une autorisation. Assurez-vous de l'enregistrer dans un emplacement sécurisé, car vous ne pourrez plus la consulter.

Modification de l'étendue d'une application existante

Les étendues sont les autorisations de l'application externe par rapport à une ressource UiPath.

1. Connectez-vous au locataire en tant qu'administrateur.
2. Accédez à Locataire (Tenant) > Gérer l'accès (Manage Access) > Attribuer des rôles (Assign Roles) et cliquez sur Gérer les comptes et les groupes (Manage Accounts & Groups). Le portail de gestion au niveau du locataire s'ouvre.
3. Sur la gauche, sélectionnez Applications externes.

   La page Applications externes (External Applications) s'ouvre, et la liste de toutes les applications externes enregistrées pour le locataire actuel apparaît.

4. Cliquez sur Modifier à droite de la ligne de l'application.
5. Modifiez l'étendue à laquelle l'application a accès :
   • Utilisez les icônes à droite d'une ligne de ressource pour modifier l'étendue existante ou pour supprimer la ressource.
   • Cliquez sur Ajouter des étendues (Add Scopes) pour ajouter une ressource supplémentaire, puis sélectionnez des étendues pour celle-ci.
6. Cliquez sur Enregistrer (Save).

Génération d'une nouvelle clé secrète d'application

Si vous ne connaissez pas la clé secrète d'application générée pour une application externe confidentielle, vous ne pouvez pas la récupérer. Toutefois, vous pouvez en générer une nouvelle.

Remarque : Si vous générez une nouvelle clé secrète d'application, assurez-vous de la partager avec le développeur qui gère l'intégration avec l'application externe. Ils doivent mettre à jour le mécanisme d'authentification, sinon l'intégration existante ne fonctionnera plus.

Pour générer une nouvelle clé secrète d'application :

1. Connectez-vous au locataire en tant qu'administrateur.
2. Accédez à Locataire (Tenant) > Gérer l'accès (Manage Access) > Attribuer des rôles (Assign Roles) et cliquez sur Gérer les comptes et les groupes (Manage Accounts & Groups). Le portail de gestion au niveau du locataire s'ouvre.
3. Sur la gauche, sélectionnez Applications externes (External Applications). La page Applications externes (External Applications) s'ouvre, et la liste de toutes les applications externes enregistrées pour le locataire actuel apparaît.
4. Cliquez sur à droite de la ligne de l'application.
5. Sous Clé secrète de l'application (App Secret), cliquez sur Générer une nouvelle (Generate new).
   

   Une nouvelle clé secrète d'application est générée et affichée au-dessus du bouton. Il reste visible jusqu'à ce que vous cliquiez sur Annuler (Cancel) pour fermer la page.

6. Copiez la clé secrète de l'application et assurez-vous de la stocker dans un endroit sûr.

Fournir des détails aux développeurs

Après avoir enregistré une application externe, un développeur doit également configurer l’application externe pour qu’elle s’authentifie correctement, demande l’autorisation à UiPath Identity Server, puis accède aux ressources UiPath autorisées.

Les instructions pour les développeurs qui maintiennent l'intégration avec l'application externe sont disponibles dans Accéder aux ressources UiPath en utilisant des applications externes (Accessing UiPath Resources Using External Applications).

Pour que les développeurs puissent effectuer ces tâches, vous devez partager les informations suivantes avec eux :

• le Type d'application (Application Type) et l'ID d'application (Application ID), tous deux visibles sur la page Applications externes (External Applications)
• les étendues ajoutées pour chaque type d'étendue ; pour certaines ressources, le même nom est utilisé à la fois dans les étendues d'utilisateur et d'application, le type est donc également important

• s'il s'agit d'une application confidentielle, la clé secrète d'application générée lors de l'enregistrement de l'application externe.

  Remarque : si vous n'avez plus le secret, générez-en un nouveau, comme décrit ci-dessus sur cette page.