Services über Service Configuration konfigurieren

Dieses Kapitel behandelt den Konfigurationsprozess für Services, die Teil der Tricentis Tosca Server-Features sind.

Serviceeinstellungen ändern

Sie können Ihre Serviceeinstellungen ändern. Tricentis empfiehlt jedoch, dies nicht zu tun.

Der Standardwert für den geheimen Schlüssel ClientSecret jedes Services ist <to be generated>. Nach dem Start der Tricentis Service Configuration wird der Schlüssel ClientSecret automatisch generiert. Er ist mit Ihrer ClientId verknüpft.

Sie können darauf über die Datei appsettings.json zugreifen. Standardmäßig befindet sich diese Datei im Verzeichnis jedes Services unter C:\Programme (x86)\TRICENTIS\Tosca Server\.

Jeder Service verwendet den gleichen ClientSecret in jeder appsettings.json-Datei aller Services.

Auf die Tricentis Service Configuration zugreifen

Die Tricentis Service Configuration wird automatisch geöffnet, wenn Sie die Einstellungsseite im letzten Bildschirm der Tosca Server-Installation geöffnet haben.

Um die Service Configuration manuell zu starten, rufen Sie die Startseite des Tosca Server auf und klicken Sie auf Settings.

Sie können Services nur auf dem Rechner konfigurieren, auf dem Sie die Services installiert haben. Sie können nicht von einem anderen Rechner aus auf die Service Configuration zugreifen.

Admin-Zugriff festlegen

Um Services zu konfigurieren, benötigen Sie Administratorrechte.

Wenn Sie die Tricentis Service Configuration als Nicht-Admin-Benutzer gestartet haben, startet die Tricentis Service Configuration mit dem Fenster User Account Control (UAC).

Um den Administratormodus zu aktivieren, klicken Sie auf Yes.

Services mit Tricentis Service Configuration konfigurieren

Um die Services zu konfigurieren, führen Sie die folgenden Schritte aus:

  1. Klicken Sie in der Tricentis Service Configuration auf den Reiter des Services, den Sie konfigurieren möchten.

  2. Füllen Sie die Eigenschaftsfelder der Konfiguration aus. Informationen darüber, welche Eigenschaften Sie für welchen Service konfigurieren müssen, finden Sie in den folgenden Abschnitten:

  3. Wiederholen Sie die obigen Schritte für alle Services, die Sie konfigurieren möchten. Die Tricentis Service Configuration markiert alle aktualisierten Service-Reiter mit einem Asterisk.

  4. Klicken Sie auf Save. Dadurch werden alle Änderungen gespeichert, d. h. Sie müssen nicht jeden Service einzeln speichern.

    Sie können nicht speichern, wenn Sie einen ungültigen Eigenschaftswert eingegeben haben. Die Tricentis Service Configuration zeigt auf dem Service-Reiter mit dem ungültigen Eigenschaftswert ein orangefarbenes Ausrufezeichen an.

  5. Klicken Sie auf OK, um den Neustart aller Tricentis Services zu bestätigen.

Wenn ein Service nicht neu gestartet werden kann, können Sie Ihre Log-Dateien überprüfen, indem Sie auf View Logs neben dem Service klicken.

Tosca Gateway Service konfigurieren

Mit dem Tosca Gateway, das die Landing Page des Tosca Server enthält, können Sie über eine einzige Weboberfläche auf alle Server-Features zugreifen.

Konfigurieren Sie für das Tosca Gateway die folgenden Einstellungen:

Eigenschaft

Beschreibung

Port

Geben Sie den Port zur Adressierung des Tosca Gateway ein.

Binding

Geben Sie an, ob Sie eine HTTP- oder HTTPS-Bindung verwenden möchten.

Skip certificate revocation check*

Geben Sie an, ob Sie die Zertifikatsperrüberprüfung optional machen möchten.

Hostname

Geben Sie den Namen des Hosts ein, über den Sie sich mit dem Service verbinden. Der Standardhostname ist localhost.

Stellen Sie sicher, dass Sie einen gültigen Hostnamen gemäß den RFC 1123-Vorgaben eingeben. Überprüfen Sie dazu, ob er die folgenden Kriterien erfüllt:

  • Er enthält nur A-Z, a-z, 0-9, -.

  • Der Hostname beginnt nicht mit -.

Wenn Sie ein Tokensignaturzertifikat angeben, wird der Hostname automatisch auf den Common Name (CN) gemäß der Subjektnameneigenschaft des Zertifikats aktualisiert. Bei Bedarf können Sie den Hostnamen noch ändern. Klicken Sie einfach in das Eigenschaftenfeld Hostname und geben Sie den Namen des Hosts ein.

Wenn Sie einen Proxyserver verwenden und den Standardhostnamen localhost nicht verwenden, müssen Sie eine der folgenden Aktionen ausführen:

  • Deaktivieren Sie die Proxy-Einstellungen Ihres Computers.

  • Legen Sie die Umgebungsvariable NO_PROXY fest, z. B. in der Windows-Registrierung HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment. Um den Proxy für bestimmte Domänen zu umgehen, setzen Sie die Umgebungsvariable NO_PROXY auf eine durch Komma getrennte Liste von Domänennamen. Jeder Domänenname muss mit dem Zeichen . beginnen. Verwenden Sie im Domänennamen nicht das Zeichen *.

Certificate Thumbprint*

Geben Sie den Fingerabdruck für das SSL-Zertifikat ein.

Certificate Location*

Wählen Sie den Speicherort des SSL-Zertifikats aus.

Certificate Store*

Wählen Sie den Speicher, in dem sich das SSL-Zertifikat befindet.

Allowed Origins

Verwenden Sie diese Eigenschaft, um nur eingehende Anfragen von angegebenen Ursprüngen zuzulassen. Sie können die zulässigen Ursprünge wie folgt angeben:

  • * um jeden Ursprung zu akzeptieren.

  • <Ursprung>, um einen einzelnen Ursprung anzugeben.

  • <Ursprung>;<Ursprung>, um mehrere Ursprünge durch ; getrennt anzugeben. Zum Beispiel http://tricentis.com;http://my.website.com.

*Sie müssen dies nur konfigurieren, wenn Sie eine HTTPS-Bindung verwenden.

Tricentis Project Service konfigurieren

Der Tricentis Project Service speichert Informationen über Projekte wie Datenbankverbindungszeichenfolge und Projektname an zentraler Stelle.

Konfigurieren Sie für den Tricentis Project Service die folgenden Eigenschaften:

Eigenschaft

Beschreibung

Port

Geben Sie den Port ein, über den Tricentis Project Service angesprochen wird. Der Standardport ist 5003.

Tricentis Authentication Service konfigurieren

Um die serverbasierte Tricentis User Administration nutzen zu können, müssen Sie den Tricentis Authentication Service und die Tricentis Mail Configuration konfigurieren.

Konfigurieren Sie für den Tricentis Authentication Service die folgenden Eigenschaften:

Eigenschaft

Beschreibung

Port

Geben Sie den Port ein, über den Tricentis Authentication Service angesprochen wird. Der Standardport ist 5000.

Certificate Thumbprint (Token Signatures)

Geben Sie den Fingerabdruck für das Tokensignaturzertifikat ein. Weitere Informationen finden Sie hier: siehe Kapitel "Token-Sign-Zertifikat".

Certificate Location (Token Signatures)

Wählen Sie den Speicherort des Tokensignaturzertifikats.

Certificate Store (Token Signatures)

Wählen Sie den Speicher aus, in dem sich das Tokensignaturzertifikat befindet.

User Storage Database

Der Standard-Datenbankpfad von SQLite lautet %PROGRAMDATA%\TRICENTIS\IdentityManagement\UserStore.db.

Sie können eine andere Datenbank auf eine der folgenden Arten angeben:

  • Geben Sie einen anderen SQLite-Datenbankpfad ein.

  • Wählen Sie eine MSSQL- oder PostgresSQL-Datenbank aus dem Aufklappmenü und geben Sie den entsprechenden Pfad ein.

Wenn Sie die Datenbank ändern, werden Ihre Daten nicht automatisch migriert. Sie müssen die Migration manuell durchführen.

Configuration Database

Der Standard-Datenbankpfad von SQLite lautet %PROGRAMDATA%\TRICENTIS\IdentityManagement\ConfigurationStore.db.

Sie können eine andere Datenbank auf eine der folgenden Arten angeben:

  • Geben Sie einen anderen SQLite-Datenbankpfad ein.

  • Wählen Sie eine MSSQL- oder PostgresSQL-Datenbank aus dem Aufklappmenü und geben Sie den entsprechenden Pfad ein.

Wenn Sie die Datenbank ändern, werden Ihre Daten nicht automatisch migriert. Sie müssen die Migration manuell durchführen.

Operational Database

Der Standard-Datenbankpfad von SQLite lautet %PROGRAMDATA%\TRICENTIS\IdentityManagement\OperationalStore.db.

Sie können eine andere Datenbank auf eine der folgenden Arten angeben:

  • Geben Sie einen anderen SQLite-Datenbankpfad ein.

  • Wählen Sie eine MSSQL- oder PostgresSQL-Datenbank aus dem Aufklappmenü und geben Sie den entsprechenden Pfad ein.

Wenn Sie die Datenbank ändern, werden Ihre Daten nicht automatisch migriert. Sie müssen die Migration manuell durchführen.

Regex for custom password policy

Definieren Sie eine benutzerdefinierte Passwortrichtlinie für lokal erstellte Benutzer mit einem regulären Ausdruck.

Der Standardwert für den regulären Ausdruck ist .{8,}. Das bedeutet, dass das Passwort mindestens 8 Zeichen lang sein muss.

Wenn Sie einen eigenen regulären Ausdruck verwenden möchten, können Sie den Standardwert ändern.

Maximum number of failed login attempts before account is locked

Definieren Sie die Anzahl der fehlgeschlagenen Anmeldeversuche, bevor ein Konto gesperrt wird. Der Standardwert ist 5.

Account lockout duration in hours

Definieren Sie die Anzahl der Stunden, die ein gesperrtes Konto gesperrt bleibt, bevor es entsperrt wird. Der Standardwert ist 0.

Number of unique passwords before re-use

Geben Sie die Anzahl der eindeutigen Passwörter an, die ein Benutzer verwenden muss, bevor er ein altes Passwort wiederverwenden kann. Der Standardwert ist 10.

Password expiration period (days)

Geben Sie die Anzahl der Tage an, die ein Passwort verwendet werden kann, bevor es abläuft und geändert werden muss. Der Standardwert ist 0 Tage, was bedeutet, dass das Passwort unbegrenzt gültig ist. Wenn Sie das Passwort nicht innerhalb der angegebenen Ablauffrist ändern, wird Ihr Konto gesperrt.

Audit

Enable Audit

Um Audit-Logs zu aktivieren, die die Benutzeraktivitäten in der Tricentis User Administration verfolgen, aktivieren Sie das Kontrollkästchen Enable Audit. Das Kontrollkästchen ist standardmäßig deaktiviert.

File

File path for Audit logs

Wenn Sie die Eigenschaft Audit aktivieren, können Sie die Benutzeraktivität in einer Audit-Log-Datei protokollieren. Geben Sie dazu den Pfad zu dem Verzeichnis an, in dem Sie Audit-Log-Dateien speichern möchten. Der Standarddateipfad für Audit-Logs lautet %PROGRAMDATA%\TRICENTIS\Audit\AuthenticationService\AuthenticationService_Audit_.csv.

Splunk

Full endpoint

Wenn Sie die Eigenschaft Audit aktivieren, können Sie die Benutzeraktivität in der Logging-Plattform von Splunk protokollieren. Geben Sie dazu die Endpunktadresse von Splunk an. Zum Beispiel: http://localhost:6000/splunk.

Weitere Informationen zu Splunk finden Sie in der Splunk-Dokumentation.

Event Collector Token (ECT)

Geben Sie das Token an, das zur Authentifizierung der Ereignisdaten verwendet wird.

Wenn die Ablauffrist des Passworts abläuft, müssen Sie Ihr Passwort zurücksetzen und zusätzlich die Mail-Einstellungen konfigurieren.

Beachten Sie, dass Sie den Standard-Admin-Benutzer nicht zum Zurücksetzen des Passworts verwenden können, da er keine gültige E-Mail-Adresse hat. Stellen Sie sicher, dass Sie ein alternatives Admin-Konto einrichten, bevor Sie diese Eigenschaft konfigurieren.

Inhalt der Protokolldatei

Wenn Sie Überwachungen aktiviert haben, werden die folgenden Ereignisse in der Protokolldatei erfasst:

  • Benutzerereignisse (reguläre Benutzer und Admin-Benutzer):

Kategorie

Ereignisse

Managing users

An-/Abmelden, gesperrter Benutzer, fehlgeschlagene Anmeldungen, Erstellen eines neuen persönlichen Zugriffstokens für einen bestehenden Benutzer, Löschen eines bestehenden persönlichen Zugriffstokens, Zurücksetzen des Passworts, Aktualisieren des Benutzers (Passwort ändern, Benutzer umbenennen)

  • Administratorereignisse (Admin-Benutzer):

Kategorie

Ereignisse

Managing users

Benutzer registrieren, Benutzer einladen, Benutzer aktivieren, Benutzer deaktivieren, Benutzer entfernen

Manage Groups

Gruppe erstellen, Gruppe löschen, Gruppe zu Gruppe hinzufügen, Benutzer zu Gruppe hinzufügen, Gruppe aktualisieren

Manage Connections

Neue LDAP-Verbindung erstellen, LDAP-Verbindung löschen, LDAP-Verbindung aktualisieren

Settings

SSO aktivieren, SSO-Verbindung aktualisieren (Metadatendatei, Adresse, Name festlegen)

Tosca Administration Console konfigurieren

Mit der Tosca Administration Console können Sie Ihre Tricentis Tosca-Projekte migrieren.

Konfigurieren Sie für die Tosca Administration Console die folgenden Eigenschaften:

Eigenschaft

Beschreibung

Administration Console Port

Geben Sie den Port für den Zugriff auf die Tosca Administration Console ein. Der Standardport ist 5010.

Migration Service Port

Geben Sie den Port für den Zugriff auf den Tricentis Migration Service der Tosca Administration Console ein. Der Standardport ist 5011.

Tricentis File Service konfigurieren

Der Tricentis File Service speichert Ausführungs-Logs und Common Repository-Anhänge.

Konfigurieren Sie für den Tricentis File Service die folgenden Eigenschaften:

Eigenschaft

Beschreibung

Storage Directory Path

Geben Sie den Pfad zu dem Verzeichnis an, in dem Sie die Dateien speichern möchten.

Port

Geben Sie den Port ein, über den der Tricentis File Service angesprochen wird. Der Standardport ist 5005.

Database Connection

Standardmäßig erstellt der Tricentis File Service eine SQLite-Datenbank zum Speichern der Metadaten.

  • Wenn Sie die Standarddatenbank verwenden möchten, können Sie diese Einstellung ignorieren oder eine Verbindungszeichenfolge anstelle des Dateipfads verwenden. Mit Verbindungszeichenfolgen können Sie Ihre Verbindung anpassen, z. B. mit Standard-Timeouts. Weitere Informationen finden Sie in der Microsoft-Hilfe.

  • Wenn Sie lieber Ihre eigene, selbst gehostete MS SQL-Datenbank verwenden möchten, geben Sie die Verbindungsdetails unter Database Connection ein und wählen Sie MSSQL aus der Dropdown-Liste aus.

Log Path

Geben Sie den Pfad zu dem Verzeichnis an, in dem Sie die Log-Dateien speichern möchten.

Log Level

Geben Sie den Detailgrad des Logs an, der in die Log-Dateien geschrieben werden soll: Error messages (Fehlermeldungen), Modifications (Änderungen), All service communication (Jegliche Service-Kommunikation).

Enable Authorization

Wenn Sie dieses Feature aktivieren, prüft der Tricentis File Service in der Tricentis User Administration, ob ein Benutzer die erforderlichen Rechte hat, um auf das Projekt zuzugreifen. Dieses Feature ist in keiner Weise mit den SSL-Sicherheitseinstellungen verbunden.

Hinweis: Die Überprüfung der Benutzerautorisierung ist nur in den Arbeitsbereichen des Tricentis Server Repository verfügbar.

Abschnitt Auto-removal.

Die Einstellungen für die automatische Löschung gelten für alle Projekte, bei denen Sie die automatische Löschung aktiviert haben. Sie können keine unterschiedlichen Einstellungen für verschiedene Projekte angeben.

Automatically remove execution log data that's older than a certain number of days

Schalten Sie den Schalter ein oder aus, um die automatische Löschung zu aktivieren oder zu deaktivieren.

Maximum log data age in days

Der Tricentis File Service nimmt den aktuellen Datums-/Zeitstempel, subtrahiert 90 Tage und entfernt alle Ausführungs-Logs, die älter als das Ergebnis sind. Wenn Sie einen anderen Zeitraum festlegen möchten, geben Sie eine neue Anzahl von Tagen ein.

Run frequency

Der Tricentis File Service prüft stündlich, ob Dateien vorhanden sind, die alt genug sind, um entfernt zu werden. Wenn Sie möchten, dass der Service mehr oder weniger häufig ausgeführt wird, geben Sie ein neues Intervall im Format DD:HH:MM:SS ein.

Maximum number of logs that should be processed per run

Der Tricentis File Service verarbeitet maximal 1 500 Logs pro Durchlauf. Wenn weitere Logs zu entfernen sind, entfernt der Tricentis File Service diese zusätzlichen Logs im nächsten Durchlauf. Um mehr oder weniger Logs zu verarbeiten, geben Sie eine neue Zahl ein.

Maximum time allowed to progress logs

Der Tricentis File Service führt die Aufgabe für maximal zwei Minuten aus. Wenn er innerhalb dieses Zeitraums nicht alle Logs entfernen kann, werden die zusätzlichen Logs im nächsten Durchlauf entfernt. Um dem Tricentis File Service mehr oder weniger Zeit für die Verarbeitung von Logs zu geben, geben Sie einen neuen Zeitraum im Format DD:HH:MM:SS ein.

Automation Object Service konfigurieren

Der Automation Object Service (AOS) ist ein zentrales Element der Distributionsarchitektur, wenn Sie die Distributed Execution with AOS oder Tosca Cloud verwenden.

Sie können die folgenden Eigenschaften im Reiter Automation Object Service konfigurieren:

Eigenschaft

Beschreibung

Abschnitt Assigned Workspaces

Workspace Folder

Wählen Sie den Stammordner aus, der die Arbeitsbereiche enthält, die Sie dem Automation Object Service zuweisen möchten. Standardmäßig finden Sie den Arbeitsbereichsstammordner in %TRICENTIS_PROJECTS%Tosca_Workspaces.

Wenn Sie keinen Arbeitsbereich auf Ihrem Tosca Server-Rechner verfügbar haben, können Sie den AOS-Arbeitsbereich erstellen.

Maximum Parallel Workspaces

Geben Sie die maximale Anzahl der Arbeitsbereiche an, mit denen der Automation Object Service parallel arbeiten kann. Der Standardwert ist 10.

Repository Type

Wählen Sie den von Ihnen verwendeten Repository-Typ aus:

  • DB2

  • MS SQL

  • Oracle

  • SQLite

  • Tricentis Server Repository

Project Root Name

Geben Sie den Projektwurzelnamen des AOS-Projekts ein.

Workspace Name

Geben Sie den Namen des AOS-Arbeitsbereichs ein.

Credentials Source

Geben Sie an, wo Sie die Benutzeranmeldedaten für den Benutzer des AOS-Arbeitsbereichs hinterlegt haben. Wählen Sie einen der folgenden Werte aus dem Aufklappmenü:

  • Local, wenn Sie die Anmeldedaten direkt in die Agent-Konfiguration eingeben möchten.

  • HashiCorp Key vault, wenn Sie die Anmeldedaten verwenden möchten, die Sie in Ihrem HashiCorp-Schlüsseltresor speichern.

Username

Geben Sie den Benutzernamen für den Zugriff auf den Arbeitsbereich ein:

  • Wenn Ihre Credentials Source Local ist, geben Sie den Benutzernamen in das Feld ein.

  • Wenn Ihre Credentials Source HashiCorp Key vault ist, geben Sie den Pfad zum Benutzernamen in Ihrem Schlüsseltresor ein: <Pfad zum Geheimnis>[<Feld>]. Zum Beispiel kv/dex/aos_workspace[Benutzername].

Hinweis: Wenn Sie den Repository-Typ Tricentis Server Repository verwenden, müssen Sie die Client ID Ihres API-Zugriffstokens anstelle des Benutzernamens angeben.

Password

Geben Sie das Passwort des Benutzers des AOS-Arbeitsbereichs ein. Geben Sie je nach Credentials Source das Passwort direkt ein oder geben Sie den Pfad zum Passwort in Ihrem Schlüsseltresor ein.

Hinweis: Wenn Sie den Repository-Typ Tricentis Server Repository verwenden, müssen Sie den geheimen Clientschlüssel Ihres API-Zugriffstokens anstelle des Passworts angeben.

Abschnitt Execution Environments

Distributed Execution

Verwenden Sie den Schalter, um die Distributed Execution als eine der Ausführungsumgebungen für den Automation Object Service zu aktivieren oder zu deaktivieren.

Die folgenden Einstellungen für die Distributed Execution sind nur dann verfügbar, wenn der Schalter auf On steht.

Distribution Server Address

Geben Sie die Adresse des Tosca Distribution Server an. Die Standardadresse ist http://localhost:5007.

Distribution Server Call Timeout (ms)

Geben Sie das Timeout für das Abrufen der Testergebnisse vom Tosca Distribution Server an. Das standardmäßige Timeout beträgt 30 000 Sekunden.

Wenn dieses Timeout abläuft und der Tosca Distribution Server keine Antwort erhält, bricht der Automation Object Service die Anfrage ab und protokolliert einen Fehler.

Elastic Execution Grid

Die folgenden Einstellungen gelten nur, wenn Sie die Testausführungsintegration mit Tosca Cloud vornehmen möchten. Elastic Execution Grid ist der Ausführungsservice von Tosca Cloud.

Elastic Execution Grid

Verwenden Sie den Schalter, um Tosca Cloud als eine der Ausführungsumgebungen für den Automation Object Service zu aktivieren oder zu deaktivieren.

Die folgenden Einstellungen für Tosca Cloud sind nur dann verfügbar, wenn der Schalter auf On steht.

Elastic Execution Grid URL

Geben Sie https://<Netzwerkadresse Ihrer Cloud-Instanz>/<Space-Name> ein.

Ersetzen Sie <Space-Name> durch eine der folgenden Optionen:

  • Wenn Sie einen Space für Ihre Cloud-Instanz erstellt haben, geben Sie den Space-Namen ein.

  • Wenn Sie keinen Space erstellt haben, geben Sie default ein.

Zum Beispiel: https://examplecompany.my.tricentis.com/default.

Client ID

Dieses Feld enthält die Client ID Ihrer Cloud-Autorisierung. Es ist vorausgefüllt und Sie brauchen den Wert nicht zu ändern.

  • Wenn Ihre Credentials Source Local ist, geben Sie die Client ID in das Feld ein.

  • Wenn Ihre Credentials Source HashiCorp Key vault ist, geben Sie den Pfad zur Client ID in Ihrem Schlüsseltresor ein: <Pfad zum Geheimnis>[<Feld>]. Zum Beispiel kv/e2g/integration[clientId].

Client Secret

Geben Sie den geheimen Clientschlüssel der Okta-Applikation Tosca Server ein (siehe Kapitel "Testausführungsintegration einrichten").

Geben Sie je nach Credentials Source den geheimen Clientschlüssel direkt ein oder geben Sie den Pfad zum geheimen Clientschlüssel in Ihrem Schlüsseltresor ein.

Abschnitt HTTPS Settings (optional)

Port

Geben Sie den Port ein, über den der Automation Object Service angesprochen wird. Der Standardport ist 5006.

Abschnitt Logging (optional)

Log Path

Geben Sie den vollständigen Pfad der Log-Datei an, einschließlich Dateiname und -endung.

Log Level

Wählen Sie die Log-Ebene des AOS-Logs aus:

  • Error messages

  • Modifications

  • All service communication

Sie müssen die Konfigurationsdateien Consul und Ocelot aktualisieren, wenn Sie Änderungen am Standardport oder an der Endpunktadresse des AOS vornehmen. In den folgenden Abschnitten wird ausführlich erläutert, wo Sie diese Dateien finden und wie Sie die entsprechenden Eigenschaften aktualisieren können.

Consul-Konfigurationsdatei aktualisieren

Aktualisieren Sie die folgenden Eigenschaftswerte in der Consul-Konfigurationsdatei des Service. Diese Datei befindet sich unter C:\Programme (x86)\TRICENTIS\Tosca Server\Gateway\Consul\config\AutomationObjectService.json:

Eigenschaft

Beschreibung

port

Geben Sie den Port ein, über den der AOS adressiert wird.

http

Geben Sie die vollständige Adresse, die vom AOS verwendet wird, einschließlich des Ports ein: <http oder https>://<Name des Hosts>:<Port>

Ocelot-Konfigurationsdatei aktualisieren

Führen Sie die folgenden Schritte aus, um die Ocelot-Konfigurationsdatei des AOS zu aktualisieren:

  1. Öffnen Sie die Datei ocelot.json, die sich unter C:\Programme (x86)\TRICENTIS\Tosca Server\Gateway befindet.

  2. Suchen Sie nach zwei Elementen mit dem ServiceId-Wert ToscaAutomationObjectService.

  3. Aktualisieren Sie die Werte der folgenden Eigenschaften in diesen Elementen:

Eigenschaft

Beschreibung

DownstreamScheme

Geben Sie je nach gewählter Bindung entweder http oder https ein.

Port

Geben Sie den Port des AOS ein.

Änderungen anwenden

Starten Sie die folgenden Services neu, um die Änderungen anzuwenden:

  • Tricentis.ToscaAutomationObjectService

  • Tricentis.GatewayService

  • ConsulService

Tricentis Test Data Service konfigurieren

Konfigurieren Sie für den Tricentis Test Data Service die folgenden Eigenschaften:

Eigenschaft

Beschreibung

Port

Geben Sie den Port ein, über den der Tricentis Test Data Service angesprochen wird. Der Standardport ist 5001.

Enable Authentication

Aktivieren Sie das Kontrollkästchen Enable Authentication, um die Authentifizierung für den Test Data Service über die Tricentis User Administration zu aktivieren.

Enable Diagnostics

Aktivieren Sie das Kontrollkästchen Enable Diagnostics, um anonyme Nutzungsdaten an Tricentis zu senden.

Tricentis Mail Configuration konfigurieren

Nachdem Sie den Tricentis Authentication Service konfiguriert haben, konfigurieren Sie den SMTP-Server (Simple Mail Transfer Protocol) für den Versand von E-Mails aus der Tricentis User Administration.

Konfigurieren Sie für die Tricentis Mail Configuration die folgenden Eigenschaften:

Eigenschaft

Beschreibung

SMTP Mail Server Address

Geben Sie die Adresse Ihres SMTP-Mail-Servers an.

Port

Geben Sie den zugehörigen SMTP-Host-Port ein. Der Standardport ist 587.

Username

Geben Sie den Benutzernamen des SMTP-Servers an.

Password

Geben Sie das Passwort an.

Sender Name

Geben Sie den Namen des Absenders an.

Sender Email

Geben Sie die E-Mail-Adresse an, von der aus E-Mails gesendet werden sollen.

Send test email to

Geben Sie die E-Mail-Adresse an, an die Sie eine Test-E-Mail senden möchten, und klicken Sie auf Test.

Tricentis Notification Service konfigurieren

Der Tricentis Notification Service ist die Datenschnittstelle zwischen Tricentis Tosca und anderen Applikationen. Er ist eine wichtige Komponente, wenn Sie Tricentis Tosca mit qTest oder SAP Solution Manager integrieren.

Sie können diesen Service in der Tricentis Service Configuration nur dann konfigurieren, wenn Sie ihn in der Windows-Dienste-App aktiviert haben (siehe Schritt 2 im Überblick zum Tosca Server-Setup).

Konfigurieren Sie für den Tricentis Notification Service die folgenden Eigenschaften:

Eigenschaft

Beschreibung

Port

Standardport, der vom Notification Service hinter dem Gateway-Proxy verwendet wird. Sie können bei Bedarf einen anderen Port angeben.

Enable Authorization

Wenn Sie dieses Feature aktivieren, prüft der Notification Service in der Tricentis User Administration, ob ein Benutzer die erforderlichen Rechte hat, um auf das Projekt zuzugreifen. Dieses Feature ist in keiner Weise mit den SSL-Sicherheitseinstellungen verbunden.

Hinweis: Die Überprüfung der Benutzerautorisierung ist nur in den Arbeitsbereichen des Tricentis Server Repository verfügbar.

Bereich Database

Database Connection String

Geben Sie eine gültige Verbindungszeichenfolge für Ihre Notification Service-Datenbank ein und wählen Sie den Datenbanktyp aus dem Aufklappmenü aus.

Abschnitt Logging

Log Path

Geben Sie den Pfad zu dem Verzeichnis ein, in dem Sie die Log-Dateien speichern möchten.

Log Level

Definieren Sie die Log-Ebene: Error messages, Modifications oder All service communication.

Abschnitt SAP Solution Manager Integration (optional)

Enabled

Wählen Sie das Kontrollkästchen, um die SAP Solution Manager-Integration zu aktivieren.

Abschnitt qTest Integration (optional)

Enabled

Wählen Sie das Kontrollkästchen, um die qTest-Integration zu aktivieren.

qTest URL

Geben Sie die URL zu Ihrer qTest-Instanz ein.

API Key

Geben Sie Ihren qTest-API-Schlüssel ein.

Um den API-Schlüssel zu erhalten, öffnen Sie qTest und klicken Sie auf Download qTest Resources. Gehen Sie zum Abschnitt Integration with Tosca und kopieren Sie das API-Token.

Tosca License Administration konfigurieren

Die Tosca License Administration ermöglicht es Ihnen, einen oder mehrere On-Premise-Lizenzserver zu überwachen und zu verwalten.

Konfigurieren Sie für die Tosca License Administration die folgende Eigenschaft:

Eigenschaft

Beschreibung

Port

Geben Sie den Port zur Adressierung der Tosca License Administration ein. Der Standardport ist 5030.

Tricentis SAP Solution Manager Service konfigurieren

Sie müssen Tricentis Tosca 2023.1.1 (oder höher) installiert haben, um diese Funktionalität nutzen zu können.

Sie können die folgenden Eigenschaften im Reiter SAP Solution Manager Service konfigurieren:

Eigenschaft

Beschreibung

Abschnitt Assigned Workspaces

Project Root Name

Geben Sie den Projektwurzelnamen des SAP Solution Manager Service-Projekts ein.

Workspace Name

Geben Sie den Namen des SAP Solution Manager Service-Arbeitsbereichs ein.

Username

Geben Sie einen gültigen Benutzernamen für den Zugriff auf den Arbeitsbereich ein:

  • Wenn Ihre Credentials Source Local ist, geben Sie einfach den Benutzernamen ein.

  • Wenn Ihre Credentials Source HashiCorp Key vault ist, geben Sie den Pfad zum Benutzernamen in Ihrem Schlüsseltresor ein: <Pfad zum Geheimnis>[<Feld>]. Zum Beispiel kv/dex/aos_workspace[Benutzername].

Password

Geben Sie das mit dem Benutzernamen verknüpfte Passwort ein.

Geben Sie je nach Credentials Source Ihr Benutzerpasswort direkt ein oder geben Sie den Pfad zum Passwort in Ihrem Schlüsseltresor ein.

Abschnitt HTTPS Settings (optional)

Port

Geben Sie den Port zur Adressierung vom SAP Solution Manager Service ein. Der Standardport ist 5047.

Abschnitt Logging (optional)

Log Path

Geben Sie den vollständigen Pfad der Log-Datei an, einschließlich Dateiname und -endung.

Log Level

Wählen Sie die Log-Ebene des SAP Solution Manager Service-Logs aus:

  • Error messages

  • Modifications

  • All service communication

Nächste Schritte

Wenn Sie eine HTTPS-Bindung für den Tricentis Tosca Server festgelegt haben, nehmen Sie die erforderlichen Änderungen wie in siehe Kapitel "Tosca Server mit einer HTTPS-Bindung verwenden" beschrieben vor.