Authentication Server Konfiguration

Blue Prism Anwendungsserver konfigurieren

Um Benutzer vom Authentication Server zu Blue Prism hinzuzufügen und die Benutzerdaten zu synchronisieren, müssen die Details des Dienstkontos, das erstellt wurde, um authentifizierte Anfragen an die Authentication Server API zu stellen, auf dem Blue Prism Anwendungsserver konfiguriert werden. Darüber hinaus kann der Blue Prism Anwendungsserver zur Behandlung von Benutzer- und Dienstkontoereignissen konfiguriert werden, die vom Authentication Server in einer Nachrichtenwarteschlange veröffentlicht werden, sodass Aktualisierungen an Authentication Server Benutzer- und Dienstkonten auf die zugeordneten Blue Prism Benutzer- oder Dienstkonten angewendet werden.

Dies kann auf der Registerkarte „Authentication Server Integration“ im Bildschirm für die Blue Prism Serverkonfigurationsdetails konfiguriert werden.

1. Starten Sie den Blue Prism Anwendungsserver (BPServer.exe von C:\Programme\Blue Prism Limited\Blue Prism Automate).
2. Um die Serverkonfiguration zu öffnen, wählen Sie die entsprechende Umgebung von der Dropdown-Liste Aktuelle Konfiguration aus und klicken Sie auf Bearbeiten.

3. Auf der Registerkarte „Authentication Server Integration“:

   1. Geben Sie die Brokereinstellungen wie in der Blue Prism Hub Installation konfiguriert ein:

      • Adresse – RabbitMQ-Adresse im Format rabbitmq://<host>:<port>/
      • Benutzername – RabbitMQ-Benutzername
      • Passwort – RabbitMQ-Passwort

      • Umgebungskennung – Wird bei Bedarf verwendet, um zwischen verschiedenen konfigurierten Blue Prism Umgebungen zu unterscheiden. Dieser Wert darf nur eine Abfolge der folgenden Zeichen enthalten: Buchstaben, Ziffern, Bindestriche, Unterstriche, Punkte und Doppelpunkte.

        

   2. Geben Sie die Client-Details ein. Diese werden für die Synchronisierung von Benutzer- und Dienstkonten und bei direkten Aufrufen an die Authentication Server API verwendet, z. B. beim Hinzufügen von Authentication Server Benutzern zu Blue Prism Rollen, wie unter Dienstkonto in Hub erstellen konfiguriert.

      • Client-ID – Die Client-ID des Dienstkontos, das von Blue Prism zur Kommunikation mit Authentication Server verwendet wird.
      • Client-Geheimnis – Der geheime Client-Schlüssel des Dienstkontos, das von Blue Prism zur Kommunikation mit Authentication Server verwendet wird.

      In Hub 4.7 und höher wird bei der Client-ID zwischen Groß- und Kleinschreibung unterschieden. Sie müssen sicherstellen, dass Sie die Client-ID in der gleichen Groß- und Kleinschreibung eingeben, wie sie im Dienstkonto festgelegt ist.

   3. Klicken Sie auf Verbindung testen, um sicherzustellen, dass die eingegebenen Details gültig sind.

      Wählen Sie Verbindung aktivieren nicht aus, bevor Sie die Benutzerzuordnung abgeschlossen haben. Sie können Ihre Änderungen speichern und die Verbindung aktivieren, sobald Sie die Benutzerzuordnung abgeschlossen haben.

   4. Klicken Sie auf Speichern, um die Einstellungen anzuwenden.

Benutzer über das Zuordnungstool hinzufügen

Stellen Sie vor Beginn der Zuordnung sicher, dass ein nativer Blue Prism Administrator im System vorhanden ist und dass dieser Benutzer manuell aus der Zuordnungsdatei entfernt wird, bevor Sie den unten beschriebenen Zuordnungsprozess durchführen. Damit wird sichergestellt, dass bei Problemen mit dem Authentication Server oder der Systemkonfiguration immer ein Administratorbenutzer zur Verfügung steht, der sich über eine direkte Datenbankverbindung anmelden kann.

Konten in der Authentication Server Datenbank für bestehende native Blue Prism Benutzer erstellen, die noch keine entsprechenden Hub Benutzerkonten haben

1. Öffnen Sie die Eingabeaufforderung als Administrator und navigieren Sie zum Blue Prism Installationsverzeichnis, das AutomateC.exe enthält (zum Beispiel C:\Programme\Blue Prism Limited\Blue Prism Automate).

2. Führen Sie den folgenden Befehl aus, um eine CSV-Vorlagendatei zu erhalten, die eine Liste aller nativen Blue Prism Benutzer in der Datenbank enthält, die für die Zuordnung verfügbar sind:

   Kopieren

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

3. Öffnen Sie im Windows-Explorer die Ausgabedatei und fügen Sie Vorname, Nachname und E-Mail-Adresse für jeden Blue Prism Benutzer hinzu, den Sie hinzufügen möchten.

   Die Felder „Vorname“, „Nachname“ und „E-Mail-Adresse“ sind nicht in Blue Prism vorhanden, also müssen sie zum Erstellen der Benutzer in Authentication Server hinzugefügt werden.

4. Löschen Sie alle Benutzer aus der Datei, die sich nicht über Authentication Server anmelden sollen. Mindestens ein nativer Administratorbenutzer sollte aus der Datei entfernt werden, damit dieser sich weiterhin über eine direkte Datenbankverbindung anmelden kann.

   Wenn Sie die native Authentifizierung auch verwenden, um Laufzeitressourcen, AutomateC-Befehle oder Webdienstanfragen zu authentifizieren, sollten Sie auch alle nativen Benutzerkonten, die zur Authentifizierung dieser erforderlich sind, aus der Datei entfernen.

5. Speichern Sie die CSV-Datei.

6. Öffnen Sie die Eingabeaufforderung als Administrator und navigieren Sie zum Blue Prism Installationsverzeichnis, das AutomateC.exe enthält.

7. Führen Sie den folgenden Befehl aus, um die Benutzerzuordnung abzuschließen:

   Kopieren

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

   Dabei gilt:

   • <input CSV> – Der Pfad zu Ihrer gespeicherten CSV-Datei.
   • <output CSV for errors> – Der Pfad für eine Datei, die automatisch erstellt wird, wenn Fehler im Zuordnungsprozess vorliegen.
   • <admin username> und <admin password> – Die Anmeldedaten für einen nativen Administratorbenutzer in Blue Prism.

   • <Blue Prism server connection name> – Der Name Ihrer Blue Prism Serververbindung, wie er in den Blue Prism Servereinstellungen eingestellt ist.

   Zum Beispiel:

   

   Stellen Sie sicher, dass der Computer, auf dem Sie den Befehl ausführen, auf die Authentication Server Website zugreifen kann. Weitere Details finden Sie unter Authentication Server – Fehlerbehebung.

Vorhandene Blue Prism Benutzer bestehenden Authentication Server Benutzern zuordnen

1. Öffnen Sie die Eingabeaufforderung als Administrator und navigieren Sie zum Blue Prism Installationsverzeichnis, das AutomateC.exe enthält (zum Beispiel C:\Programme\Blue Prism Limited\Blue Prism Automate).

2. Führen Sie den folgenden Befehl aus, um eine CSV-Vorlagendatei zu erhalten, die eine Liste aller Benutzer enthält, die für die Zuordnung in der Blue Prism Datenbank verfügbar sind:

   Kopieren

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

3. Führen Sie den folgenden Befehl aus, um eine CSV-Vorlagendatei zu erhalten, die eine Liste aller Benutzer enthält, die für die Zuordnung in der Authentication Server Datenbank verfügbar sind:

   Kopieren

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

4. Öffnen Sie im Windows-Explorer beide Ausgabedateien. Suchen Sie für jeden Blue Prism Benutzer, den Sie zuordnen möchten, den entsprechenden Authentication Server Benutzer und kopieren Sie den Blue Prism Benutzernamen in die Authentication Server Ausgabedatei.

   Mindestens ein Blue Prism Benutzername und eine Authentication Server Benutzer-ID sind erforderlich. Die zusätzlichen Felder „Vorname“, „Nachname“ und „E-Mail-Adresse“, die in der Authentication Server Datenbank erforderlich sind, sollten für die Authentication Server Benutzer bereits vorhanden sein.

5. Löschen Sie alle Benutzer, die nicht zugeordnet werden sollen, aus der Authentication Server Ausgabedatei. Mindestens ein nativer Administratorbenutzer sollte aus der Datei entfernt werden, damit dieser sich weiterhin über eine direkte Datenbankverbindung anmelden kann. Sie können auch native Benutzerkonten aus der Datei entfernen, die zur Authentifizierung von Laufzeitressourcen, AutomateC-Befehlen oder Webdienstanfragen erforderlich sind.
6. Speichern Sie die Authentication Server Ausgabedatei.
7. Öffnen Sie die Eingabeaufforderung als Administrator und navigieren Sie zum Blue Prism Installationsverzeichnis, das AutomateC.exe enthält.

8. Führen Sie den folgenden Befehl aus, um die Benutzerzuordnung abzuschließen:

   Kopieren

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

   Dabei gilt:

   • <input CSV> – Der Pfad zu Ihrer gespeicherten CSV-Datei.
   • <output CSV for errors> – Der Pfad für eine Datei, die automatisch erstellt wird, wenn Fehler im Zuordnungsprozess vorliegen.
   • <admin username> und <admin password> – Die Anmeldedaten für einen nativen Administratorbenutzer in Blue Prism.

   • <Blue Prism server connection name> – Der Name Ihrer Blue Prism Serververbindung, wie er in den Blue Prism Servereinstellungen eingestellt ist.

   Zum Beispiel:

   

   Stellen Sie sicher, dass der Computer, auf dem Sie den Befehl ausführen, auf die Authentication Server Website zugreifen kann. Weitere Details finden Sie unter Authentication Server – Fehlerbehebung.

Authentication Server Benutzer können nicht existierenden Blue Prism Benutzern nicht zugeordnet werden. Wenn ein Administrator keinen Blue Prism Benutzernamen in die CSV-Datei eingibt, sondern eine Authentication Server Benutzer-ID, wird eine Fehlermeldung angezeigt.

Zum Beispiel:

Aktivieren Sie die Verbindung zum Messaging-Server.

1. Starten Sie den Blue Prism Anwendungsserver (BPServer.exe von C:\Programme\Blue Prism Limited\Blue Prism Automate).

2. Klicken Sie auf dem Bildschirm „Serverkonfiguration“ auf Stopp, um den BPServer zu stoppen.

3. Wählen Sie auf der Registerkarte „Authentication Server Integration“ im Bildschirm „Serverkonfigurationsdetails“ die Option Verbindung aktivieren und klicken Sie auf Speichern.
4. Kehren Sie zum Bildschirm der Serverkonfiguration zurück und klicken Sie auf Start, um den BPServer zu starten.

5. Überprüfen Sie, ob der Nachrichtenbus ausgeführt wird. Sie sollten die folgenden Zeilen sehen:

   [Datumsstempel]: Nachrichtenbus wird gestartet

   [Datumsstempel]: Nachrichtenbus gestartet

   Wenn der Blue Prism Server erfolgreich ausgeführt wird und die Verbindung aktiviert ist, werden alle Benutzer, die in Hub bearbeitet oder gelöscht wurden, oder Dienstkonten, die in Hub erstellt, bearbeitet oder gelöscht wurden, ebenfalls in Blue Prism aktualisiert. Sollte der Blue Prism Server offline gehen oder später online gehen, wird die Synchronisierung durchgeführt, sobald die Verbindung wiederhergestellt wurde.

6. Um die Erstellung der Nachrichtenwarteschlange zu bestätigen, starten Sie die RabbitMQ-URL in einem Browser gemäß Konfiguration in der Blue Prism Hub Installation, in diesem Beispiel „rabbitmq://localhost:15672/“.

7. Suchen Sie auf der Registerkarte Warteschlangen die Warteschlange, die Sie gerade mit den obigen Einstellungen der Authentication Server Integration erstellt haben, zum Beispiel blue-prism-app-server.user-synchronization.fresh-install.

Benutzer- und Dienstkonten manuell synchronisieren

Benutzer- und Dienstkontoaktualisierungen können manuell zwischen den Blue Prism und Authentication Server Datenbanken außerhalb des RabbitMQ-Aktualisierungsplans synchronisiert werden, falls eine Dienstunterbrechung auftritt, indem die Option Benutzer mit Authentication Server synchronisieren verwendet wird, die über die Menüschaltfläche auf dem Bildschirm „Sicherheit – Benutzer“ im interaktiven Blue Prism Client verfügbar ist.

Um diese Option zu verwenden, muss der interaktive Client über einen Blue Prism Anwendungsserver verbunden sein, der mit den Client-Details des Dienstkontos konfiguriert wurde, das verwendet wird, um authentifizierte Anfragen an die Authentication Server API zu stellen.

Wenn diese Option ausgewählt ist, werden die folgenden Aktualisierungen durchgeführt:

• Alle neuen Authentication Server Dienstkonten werden der Blue Prism Datenbank hinzugefügt.

  Nur Dienstkonten, die im Hub mit der Blue Prism API-Berechtigung eingerichtet wurden, werden nach der Synchronisierung mit Authentication Server auf dem Bildschirm „Sicherheit – Benutzer“ angezeigt.

  Authentication Server Benutzer werden bei Verwendung dieser Option nicht zur Blue Prism Umgebung hinzugefügt. Sie müssen manuell einer Blue Prism Rolle auf dem Bildschirm „Rollenmitgliedschaft“ zugewiesen werden. Siehe Neue Blue Prism Umgebungen. Dadurch soll verhindert werden, dass eine große Anzahl von Authentication Server Benutzern, die Zugriff auf Blue Prism benötigen, z. B. Interact Benutzer, der Blue Prism Datenbank hinzugefügt werden.

• Alle Benutzer- und Dienstkonten, die in der Authentication Server Datenbank zurückgezogen wurden, werden auch in der Blue Prism Datenbank zurückgezogen.
• Für alle Benutzer- und Dienstkonten, deren Zurückziehung in der Authentication Server Datenbank rückgängig gemacht wurde, wird die Zurückziehung auch in der Blue Prism Datenbank rückgängig gemacht.

Wenn Sie sich dafür entscheiden, nur die manuelle Synchronisierung zu verwenden und keine Verbindung zum Messaging-Server zu aktivieren, und dann ein Benutzerkonto in Blue Prism gelöscht, aber seine Zurückziehung in Hub rückgängig gemacht wurde, ist eine manuelle Synchronisierung erforderlich, um das Benutzerkonto zu reaktivieren, bevor es sich über Authentication Server bei Blue Prism anmelden kann.