Configuration d'Authentication Server

Configurer le serveur d'applications Blue Prism

Pour ajouter des utilisateurs Authentication Server dans Blue Prism et synchroniser les données utilisateur, les détails du compte de service créé pour effectuer des requêtes authentifiées à l'API Authentication Server doivent être configurés sur le serveur d'applications Blue Prism. En outre, le serveur d'applications Blue Prism peut être configuré pour gérer les événements utilisateur et de compte de service qui sont publiés dans une file d'attente de messages par Authentication Server, de sorte que les mises à jour des utilisateurs d'Authentication Server et des comptes de service sont appliquées aux comptes de service ou aux utilisateurs de Blue Prism mappés.

Cela est configuré dans l'onglet Intégration d'Authentication Server sur l'écran Détails de la configuration du serveur Blue Prism.

1. Lancez le serveur d'applications Blue Prism (BPServer.exe à partir de C:\Program Files\Blue Prism Limited\Blue Prism Automate).
2. Pour ouvrir la configuration du serveur, sélectionnez l'environnement pertinent dans la liste déroulante Configuration actuelle et cliquez sur Modifier.

3. Dans l'onglet Intégration d'Authentication Server :

   1. Saisissez les réglages de l'agent tels que configurés dans l'installation de Blue Prism Hub :

      • Adresse : adresse RabbitMQ au format rabbitmq://<host>:<port>/
      • Nom d'utilisateur : nom d'utilisateur RabbitMQ.
      • Mot de passe : mot de passe RabbitMQ.

      • Identificateur de l'environnement : utilisé pour faire la distinction entre les différents environnements Blue Prism configurés, le cas échéant. Cette valeur ne peut contenir qu'une séquence des caractères suivants : lettres, chiffres, traits d'union, traits de soulignement, points et deux-points.

        

   2. Saisissez les détails du client. Ils sont utilisés pour la synchronisation des utilisateurs et des comptes de service et lors des appels directement à l'API Authentication Server, par exemple, lors de l'ajout d'utilisateurs Authentication Server à des rôles Blue Prism, comme configuré dans Créer un compte de service dans Hub .

      • ID client : l'ID client du compte de service utilisé par Blue Prism pour communiquer avec Authentication Server.
      • Secret client : clé secrète client générée par le compte de service utilisé par Blue Prism pour communiquer avec Authentication Server.

      Dans Hub 4.7 et les versions ultérieures, l'ID client est sensible à la casse. Vous devez vous assurer de saisir l'ID client dans le même cas que celui défini dans le compte de service.

   3. Cliquez sur Tester la connexion pour vous assurer que les détails saisis sont valides.

      Ne sélectionnez pas Activer la connexion tant que vous n'avez pas terminé le mappage d'utilisateur. Vous pouvez enregistrer vos modifications et revenir pour activer la connexion une fois que vous avez terminé le mappage d'utilisateur.

   4. Cliquez sur Enregistrer pour appliquer les réglages.

Ajouter des utilisateurs via l'outil de mappage

Avant de commencer le mappage, veuillez vous assurer qu'un utilisateur administrateur natif Blue Prism existe dans le système et que cet utilisateur est supprimé manuellement du fichier de mappage avant d'effectuer le processus de mappage décrit ci-dessous. Cela permet de s'assurer qu'en cas de problème avec Authentication Server ou la configuration du système, il existe toujours un utilisateur administrateur qui peut se connecter via une connexion directe à la base de données.

Créer des comptes dans la base de données Authentication Server pour les utilisateurs natifs Blue Prism existants qui n'ont pas encore de comptes utilisateur Hub correspondants

1. Ouvrez Invite de commande en tant qu'administrateur et accédez au répertoire d'installation de Blue Prism contenant AutomateC.exe (par exemple C:\Program Files\Blue Prism Limited\Blue Prism Automate).

2. Exécutez la commande suivante pour obtenir un fichier de modèle CSV contenant une liste de tous les utilisateurs natifs Blue Prism dans la base de données qui sont disponibles pour le mappage :

   Copier

   automatec /getblueprismtemplateforusermapping <pathtooutputfile> /user <adminuser> <adminpwd> 

3. Dans l'Explorateur Windows, ouvrez le fichier de sortie et ajoutez le prénom, le nom et l'adresse e-mail pour chaque utilisateur Blue Prism que vous souhaitez ajouter.

   Les champs Prénom, Nom et Adresse e-mail n'existent pas dans Blue Prism. Par conséquent, il doivent être ajoutés pour créer les utilisateurs dans Authentication Server.

4. Supprimez tous les utilisateurs du fichier qui ne doivent pas se connecter via Authentication Server. Au moins un utilisateur administrateur natif doit être supprimé du fichier afin qu'il puisse toujours se connecter via une connexion directe à la base de données.

   Si vous utilisez l'authentification native pour authentifier également les ressources d'exécution, les commandes AutomateC ou les requêtes de service Web, vous devez également supprimer du fichier tous les comptes utilisateur natifs requis pour les authentifier.

5. Enregistrez le fichier CSV.

6. Ouvrez Invite de commande en tant qu'administrateur et accédez au répertoire d'installation de Blue Prism contenant AutomateC.exe.

7. Exécutez la commande suivante pour terminer le mappage des utilisateurs :

   Copier

   automatec /mapauthenticationserverusers <input CSV> <output CSV for errors> /user <admin username> <admin password> /dbconname <Blue Prism Server connection name>

   Où :

   • <CSV en entrée> : le chemin d'accès à votre fichier CSV enregistré.
   • <CSV en sortie pour les erreurs> : le chemin d'accès à un fichier créé automatiquement s'il y a des erreurs dans le processus de mappage.
   • <nom d'utilisateur administrateur> et <mot de passe administrateur> : les identifiants d'un utilisateur administrateur natif dans Blue Prism.

   • <Nom de connexion au serveur Blue Prism> : le nom de votre connexion au serveur Blue Prism tel que défini dans les réglages du serveur Blue Prism.

   Par exemple :

   

   Assurez-vous que la machine sur laquelle vous exécutez la commande est en mesure d'accéder au site Web d'Authentication Server. Pour plus de détails, voir Dépannage d'Authentication Server.

Mapper les utilisateurs Blue Prism existants aux utilisateurs Authentication Server existants

1. Ouvrez Invite de commande en tant qu'administrateur et accédez au répertoire d'installation de Blue Prism contenant AutomateC.exe (par exemple C:\Program Files\Blue Prism Limited\Blue Prism Automate).

2. Exécutez la commande suivante pour obtenir un fichier de modèle CSV contenant une liste de tous les utilisateurs disponibles pour le mappage dans la base de données Blue Prism :

   Copier

   automatec /getblueprismtemplateforusermapping <pathtooutputfile> /user <adminuser> <adminpwd> 

3. Exécutez la commande suivante pour obtenir un fichier de modèle CSV contenant une liste de tous les utilisateurs disponibles pour le mappage dans la base de données Authentication Server :

   Copier

   automatec /getauthenticationservertemplateforusermapping {outputpath} /dbconname <Blue Prism Server connection name>

4. Dans l'Explorateur Windows, ouvrez les deux fichiers de sortie et, pour chaque utilisateur Blue Prism que vous souhaitez mapper, recherchez l'utilisateur Authentication Server correspondant et copiez le nom d'utilisateur Blue Prism dans le fichier de sortie Authentication Server.

   Un nom d'utilisateur Blue Prism ou un ID utilisateur Authentication Server sont requis au minimum. Les champs supplémentaires Prénom, Nom et Adresse e-mail requis dans la base de données Authentication Server doivent déjà être présents pour les utilisateurs Authentication Server.

5. Supprimez tous les utilisateurs qui ne doivent pas être mappés à partir du fichier de sortie Authentication Server. Au moins un utilisateur administrateur natif doit être supprimé du fichier afin qu'il puisse toujours se connecter via une connexion directe à la base de données. Vous pouvez également supprimer du fichier tout compte utilisateur natif qui sera requis pour authentifier les ressources d'exécution, les commandes AutomateC ou les requêtes de service Web.
6. Enregistrez le fichier de sortie Authentication Server.
7. Ouvrez Invite de commande en tant qu'administrateur et accédez au répertoire d'installation de Blue Prism contenant AutomateC.exe.

8. Exécutez la commande suivante pour terminer le mappage des utilisateurs :

   Copier

   automatec /mapauthenticationserverusers <input CSV> <output CSV for errors> /user <admin username> <admin password> /dbconname <Blue Prism Server connection name>

   Où :

   • <CSV en entrée> : le chemin d'accès à votre fichier CSV enregistré.
   • <CSV en sortie pour les erreurs> : le chemin d'accès à un fichier créé automatiquement s'il y a des erreurs dans le processus de mappage.
   • <nom d'utilisateur administrateur> et <mot de passe administrateur> : les identifiants d'un utilisateur administrateur natif dans Blue Prism.

   • <Nom de connexion au serveur Blue Prism> : le nom de votre connexion au serveur Blue Prism tel que défini dans les réglages du serveur Blue Prism.

   Par exemple :

   

   Assurez-vous que la machine sur laquelle vous exécutez la commande est en mesure d'accéder au site Web d'Authentication Server. Pour plus de détails, voir Dépannage d'Authentication Server.

Les utilisateurs Authentication Server ne peuvent pas être mappés à des utilisateurs Blue Prism qui n'existent pas. Si un administrateur ne saisit pas de nom d'utilisateur Blue Prism dans le fichier CSV, mais saisit un ID utilisateur Authentication Server, un message d'erreur s'affiche.

Par exemple :

Activez la connexion au serveur de messagerie.

1. Lancez le serveur d'applications Blue Prism (BPServer.exe à partir de C:\Program Files\Blue Prism Limited\Blue Prism Automate).

2. Sur l'écran de configuration du serveur, cliquez sur Arrêter pour arrêter le serveur Blue Prism.

3. Dans l'onglet Intégration d'Authentication Server de l'écran Détails de la configuration du serveur, sélectionnez Activer la connexion et cliquez sur Enregistrer.
4. Revenez à l'écran Configuration du serveur et cliquez sur Démarrer pour démarrer le serveur Blue Prism.

5. Vérifiez que le bus de messages s'exécute. Vous devriez voir les lignes suivantes :

   [date stamp] : démarrage du bus de messages

   [date stamp] : bus de messages démarré

   Si le serveur Blue Prism fonctionne correctement et que la connexion est activée, tous les utilisateurs modifiés ou supprimés dans Hub, ou les comptes de service créés, modifiés ou supprimés dans Hub seront également mis à jour dans Blue Prism. Si le serveur Blue Prism se déconnecte ou se connecte ultérieurement, la synchronisation se terminera une fois la connexion restaurée.

6. Pour vérifier que la file d'attente de messages a bien été créée, lancez l'URL de RabbitMQ dans un navigateur tel que configuré dans l'installation de Blue Prism Hub, dans cet exemple rabbitmq://localhost:15672/.

7. Dans l'onglet Files d'attente, localisez la file d'attente qui vient d'être créée via les réglages d'intégration d'Authentication Server ci-dessus, par exemple blue-prism-app-server.user-synchronization.fresh-install.

Synchronisation manuelle des comptes utilisateur et de service

Les mises à jour des comptes utilisateur et de service peuvent être synchronisées manuellement entre les bases de données Blue Prism et Authentication Server en dehors du planning de mise à jour RabbitMQ en cas de perturbation du service en utilisant l'option Synchroniser les utilisateurs avec Authentication Server, disponible à partir du bouton de menu sur l'écran Sécurité - Utilisateurs dans le client interactif Blue Prism.

Pour utiliser cette option, le client interactif doit être connecté via un serveur d'applications Blue Prism qui a été configuré avec les détails du client du compte de service utilisé pour effectuer des requêtes authentifiées à l'API Authentication Server.

Une fois cette option sélectionnée, les mises à jour suivantes se produiront :

• Tous les nouveaux comptes de service Authentication Server seront ajoutés à la base de données Blue Prism.

  Seuls les comptes de service définis avec la permission de l'API Blue Prism API dans Hub s'afficheront sur l'écran Sécurité – Utilisateurs une fois synchronisés avec Authentication Server.

  Les utilisateurs d'Authentication Server ne sont pas ajoutés à l'environnement Blue Prism par le biais de cette option. Ils doivent être affectés manuellement à un rôle Blue Prism sur l'écran Appartenance au rôle (voir Nouveaux environnements Blue Prism). Cela permet d'éviter qu'un grand nombre d'utilisateurs Authentication Server qui n'ont pas besoin d'accéder à Blue Prism (p. ex. les utilisateurs d'Interact) soient ajoutés à la base de données Blue Prism.

• Tous les comptes utilisateur et de service qui ont été classés dans la base de données Authentication Server seront également classés dans la base de données Blue Prism.
• Tous les comptes utilisateur et de service dont le classement a été annulé dans la base de données Authentication Server verront leur classement également annulé dans la base de données Blue Prism.

Si vous choisissez d'utiliser uniquement la synchronisation manuelle et de ne pas activer de connexion au serveur de messagerie, lorsqu'un compte utilisateur a été supprimé dans Blue Prism mais déclassé dans Hub, une synchronisation manuelle sera nécessaire pour réactiver le compte utilisateur, avant qu'il puisse se connecter à Blue Prism via Authentication Server.