Blue Prism Digital Worker API installieren und konfigurieren

Voraussetzungen

Mindesthardwareanforderungen

Siehe Blue Prism Software- und Hardwareanforderungen für Details zu den Mindestanforderungen für den Webserver, auf dem die Digital Worker API installiert wird.

IIS-Konfiguration des Webservers

Die Digital Worker API muss im Rahmen der Blue Prism Desktop Installation installiert werden. Die API muss auf einem IIS-fähigen Server installiert werden, der eine Verbindung zur Blue Prism Datenbank mit niedriger Latenz haben sollte. Die Digital Worker API kann bei Bedarf auf demselben Server wie die Blue Prism API installiert werden.

Wenn Sie die Digital Worker API auf einem separaten Webserver auf der Blue Prism API installieren, muss die folgende Konfiguration auf den Webserver angewendet werden, der die API hostet. Wenn Sie die Digital Worker API auf demselben Server wie die Blue Prism API installieren und den Webserver bereits eingerichtet haben, muss dieser Schritt nicht wiederholt werden. Dies kann mit dem bereitgestellten PowerShell-Skript oder manuell konfiguriert werden.

Die Digital Worker API kann bei Bedarf auf demselben Webserver wie die Blue Prism API, Hub und Authentication Server installiert werden.

Skript-Konfiguration

Um den Webserver über ein Skript zu konfigurieren, führen Sie den folgenden Befehl mit der PowerShell-Eingabeaufforderung aus:

Install-WindowsFeature -name Web-Server, Web-Windows-Auth -IncludeManagementTools

Authentication Server aktivieren

Um die Authentifizierung für die API zu aktivieren, muss Ihre Blue Prism Umgebung für die Verwendung von Authentication Server konfiguriert sein und Authentication Server muss im interaktiven Client aktiviert sein.

• Authentication Server muss mit dem Hub Installationsprogramm installiert werden, siehe Hub Installationshandbuch.

• Zusätzlich zu der im Hub Installationshandbuch beschriebenen Konfiguration muss zuerst ein Authentication Server Benutzer im Hub erstellt und ihm dann die Desktop Benutzerrolle in Blue Prism zugewiesen werden. Dazu wird der Authentication Server Benutzer über „System“ > „Sicherheit“ > „Benutzerrollen“ zur Desktop Benutzerrolle hinzugefügt.

• Informationen zum Konfigurieren Ihrer Blue Prism Umgebung für die Verwendung von Authentication Server finden Sie im Authentication Server Konfigurationshandbuch.

Digital Worker API installieren

Nachdem Sie Hub, Authentication Server und Blue Prism Enterprise installiert haben, können Sie nun die Digital Worker API installieren.

Um die Digital Worker API zu installieren, laden Sie das Blue Prism Digital Worker API Installationsprogramm aus dem Blue Prism Portal herunter, führen Sie es aus und gehen Sie wie folgt vor. Das Installationsprogramm muss mit Administratorrechten ausgeführt werden.

Schritt	Installationsbildschirm	Details
1		Willkommen Falls erforderlich, wählen Sie für das Installationsprogramm eine andere Sprache in der Dropdown-Liste aus. Die Standardsprache ist Englisch (USA). Klicken Sie auf Weiter.
2		Lizenzvereinbarung Lesen Sie die Endbenutzer-Lizenzvereinbarung. Wenn Sie den Bedingungen zustimmen, aktivieren Sie das Kontrollkästchen. Klicken Sie auf Weiter.
3		Zielordner Geben Sie den erforderlichen Installationsordner an. Der Standardspeicherort ist C:\Programme (x86)\Blue Prism\Blue Prism Digital Worker API, aber Sie können Ihren eigenen über die Schaltfläche Ändern auswählen. Klicken Sie auf Weiter.
4		IIS-Einrichtung Konfigurieren Sie den IIS (Internet Information Service) für die Digital Worker API. Site-Name – Standardmäßig wird Blue Prism API DW verwendet und kann nicht geändert werden. Hostname – Geben Sie die URL der Digital Worker API Website ein. Diese URL muss auch mit der im erforderlichen Zertifikat enthaltenen Site übereinstimmen. Port – Geben Sie die Portnummer des Computers ein, auf dem Sie die Digital Worker API installieren. Die Standard-Portnummer ist 443. Wenn die Blue Prism API auf demselben Server installiert ist und Sie die Standard-Portnummer bereits verwendet haben, müssen Sie hier eine andere Portnummer eingeben. SSL-Zertifikat – Wählen Sie das entsprechende SSL-Zertifikat (Secure Sockets Layer) aus, das für die Website ausgestellt wurde, die für den Hostnamen angegeben wurde. Klicken Sie auf Weiter.
5		SQL-Verbindung konfigurieren Konfigurieren Sie die SQL-Datenbankverbindung für die Digital Worker API. SQL Server – Geben Sie den Hostnamen oder die IP-Adresse des SQL Servers ein. Wenn Sie einen nicht standardmäßigen SQL-Port verwenden, geben Sie den Hostnamen des SQL-Servers ein, gefolgt vom Port. Zum Beispiel: SQLSERVER1,1434. Authentifizierungsmodus – Wählen Sie den Authentifizierungsmodus für das Konto aus, das die API verwenden wird, um eine Verbindung zur Blue Prism Datenbank herzustellen: Für die Windows-Authentifizierung (Standardeinstellung) ist dies die Identität des IIS-Anwendungspools, der mit der Site verknüpft ist. Geben Sie für die SQL-Authentifizierung den Benutzernamen und das Passwort ein. Datenbankname – Geben Sie den Namen Ihrer Blue Prism Datenbank ein. Die minimalen SQL-Berechtigungen müssen dem Benutzer gewährt werden, der sich mit der Blue Prism Datenbank verbinden wird, damit die API korrekt funktioniert. Klicken Sie auf Verbindung testen, um die Verbindung zum SQL Server zu prüfen. Klicken Sie auf Weiter.
6		Verschlüsselungsschlüssel konfigurieren Wählen Sie den Speicherort, aus dem die Verschlüsselungsschlüssel geladen werden sollen. Blue Prism Serverkonfiguration (empfohlen) – Wählen Sie eine vorhandene Blue Prism Serverkonfiguration, von der die Verschlüsselungsschlüssel geladen werden sollen. Die in der Dropdown-Liste verfügbaren Optionen werden aus der Blue Prism Anwendungsserverkonfiguration übernommen. Der Webserver muss nicht mit einem aktiven Blue Prism Anwendungsserver kommunizieren können, aber die Serverkonfigurationsdatei muss auf dem Webserver vorhanden sein. Verschlüsselungsschlüssel aus Datenbank laden – Wählen Sie diese Option, wenn die Verschlüsselungsschlüssel in der Blue Prism Datenbank gespeichert sind. Dies ist häufig für Szenarien geeignet, in denen kein Anwendungsserver bereitgestellt wird. Klicken Sie auf Weiter, um die Digital Worker API zu installieren. Während der Installation der API wird ein Fortschrittsbalken angezeigt.
7		Installation abgeschlossen Sobald die Installation erfolgreich abgeschlossen ist, klicken Sie auf Fertigstellen, um das Installationsprogramm zu verlassen. Wenn die Installation fehlschlägt, klicken Sie auf Log anzeigen, um den aufgetretenen Fehler anzuzeigen.

DNS-Datensatz konfigurieren

Sobald die Digital Worker API installiert wurde, muss ein DNS-Datensatz konfiguriert werden, um die API-URL der entsprechenden IP-Adresse zuzuordnen.

Weitere Details zu diesem Vorgang finden Sie unter DNS-Auflösung und Blue Prism Netzwerkkonnektivität.

IIS-Anwendungspool für Zugriff auf Datenbank per Windows-Authentifizierung konfigurieren

Dieser Abschnitt gilt nur für die Windows-Authentifizierung.

Nachdem Sie die Digital Worker API erfolgreich installiert haben, müssen Sie die folgende IIS-Konfiguration (Internet Information Service) abschließen:

Wenn die Digital Worker API zur Verwendung der Windows-Authentifizierung konfiguriert wurde, muss der Blue Prism Digital Worker Anwendungspool in IIS aktualisiert werden, um als Benutzer mit entsprechendem Zugriff auf die Blue Prism Datenbank ausgeführt zu werden. Führen Sie die folgenden Schritte aus, wenn Sie die Windows-Authentifizierung für die Datenbankverbindung verwenden:

Anwendungspoolidentitäten werden am häufigsten Dienstkonten zugeordnet.

1. Starten Sie den Internet Information Services Manager über das Windows-Startmenü.

2. Klicken Sie im Bereich „Verbindungen“ auf Anwendungspools.

   Das Fenster „Anwendungspools“ wird angezeigt.

3. Wählen Sie Blue Prism API DW aus.

4. Klicken Sie im Bereich „Aktionen“ auf Erweiterte Einstellungen.
5. Erweitern Sie im Dialogfeld „Erweiterte Einstellungen“ das Prozessmodell und klicken Sie auf die drei Punkte (...) neben Anwendungspoolidentität.

   

6. Wählen Sie im Dialogfeld „Anwendungspoolidentität“ die Option Benutzerdefiniertes Konto aus und klicken Sie auf Einstellen….

7. Geben Sie im Dialogfeld „Anmeldedaten festlegen“ die Windows-Anmeldedaten eines Dienstkontos ein, das Zugriff auf die Blue Prism Datenbank hat, und klicken Sie auf OK.

   Der Datenbankbenutzer, der eine Verbindung zur Blue Prism Datenbank herstellen muss, muss über die Berechtigungen „db_datareader“ und „db_datawriter“ verfügen.

   

8. Erweitern Sie im Bereich „Verbindungen“ den Knoten Sites und wählen Sie Blue Prism API DW aus.

Das Blue Prism API DW Startfenster wird angezeigt.

9. Klicken Sie im Bereich „Aktionen“ unter „Website verwalten“ auf Neu starten.

Nachdem Sie die Digital Worker API erfolgreich installiert und konfiguriert haben, müssen Sie den Blue Prism Desktop Client installieren und eine Verbindung für die Desktop Benutzer konfigurieren. Siehe Desktop Client installieren und verbinden für nähere Informationen.

IIS-Anwendungspool für hohe Nutzung konfigurieren (optional)

Wenn mehr als 750 hochaktive Benutzer auf die Desktop Umgebung zugreifen, kann es zu einer Zeitüberschreitung der Digital Worker API kommen, was zur Anzeige von Fehlermeldungen führt. Um dies zu verhindern, wird empfohlen, die Einstellung Regelmäßige Zeitintervalle (in Minuten) im IIS-Anwendungspool (Internet Information Service) von 1740 auf 180 zu reduzieren.

So ändern Sie diese Einstellung in IIS:

1. Starten Sie IIS über das Windows-Startmenü.

2. Klicken Sie im Bereich „Verbindungen“ auf Anwendungspools.

   Das Fenster „Anwendungspools“ wird angezeigt.

3. Wählen Sie Blue Prism API DW aus.

4. Klicken Sie im Bereich „Aktionen“ auf Recycling.
5. Ändern Sie im Dialogfeld „Recyclingeinstellungen des Anwendungspools bearbeiten“ den Wert des Felds Regelmäßige Zeitintervalle (in Minuten) auf 180.



6. Klicken Sie auf Weiter und dann auf Fertigstellen, um die Änderungen anzuwenden.