Authority Integration

Das ProcessCube® Studio wird mit einer vollständig integrierten Authority ausgeliefert, die eine lokale Benutzerverwaltung und Authentifizierung für die Entwicklung ermöglicht.

Überblick

Die studio-interne Authority erlaubt es, Benutzer einzurichten, mit denen Prozesse auf der studio-internen Engine ausgeführt werden können. Sie ist speziell für Entwicklungs- und Testzwecke konzipiert.

Zugriff auf die Authority

• URL: http://localhost:11235
• Standard-Benutzer: admin
• Standard-Passwort: admin
• Verwendung: Benutzer- und Rechteverwaltung für lokale Entwicklung

Mit einem Benutzer anmelden

Um sich mit einem Benutzer anzumelden, können Sie das Login-Menü in den Engine-Ansichten verwenden.

OAuth-Einstellungen

Über die Schaltfläche Configure OAuth lassen sich die OAuth-Einstellungen des Studios konfigurieren.

Verfügbare Optionen

• Client ID: ID der OAuth-Anwendung (Standard: studio)
• Scopes: Von der Authority anzufragende Berechtigungen
• Response Type: OAuth Response Type (Standard: code)

Diese Werte müssen mit den an der Authority konfigurierten Werten übereinstimmen, damit ein Login möglich ist.

Standard-Scopes

Die Standard-Scopes der Authority umfassen:

openid profile email engine_read engine_observer engine_write engine_admin

Eine vollständige Übersicht über alle verfügbaren Scopes und die damit assoziierten Claims finden Sie in der Authority-Dokumentation.

Authority Dashboard

Die Authority stellt für die Administration eine Web-Oberfläche bereit, in der Sie Accounts, Gruppen, Scopes und Claims verwalten können.

Zugriff auf das Dashboard

Die Web-Oberfläche der studio-internen Authority ist verfügbar unter:

http://localhost:11235

Funktionen des Dashboards

Im Authority Dashboard können Sie:

• Benutzer verwalten: Neue Benutzer anlegen, bearbeiten und löschen
• Gruppen verwalten: Benutzer in Gruppen organisieren
• Scopes konfigurieren: Berechtigungen definieren und zuweisen
• Claims verwalten: Benutzerdaten und Eigenschaften festlegen

Detaillierte Informationen zur Verwendung der Authority finden Sie in der Authority-Dokumentation.

Authority über das Studio ansteuern

Über die Engine Overview

Jede Engine hat eine Authority als ihren OAuth Provider konfiguriert - einschließlich der studio-internen Engine.

Die Engine Overview enthält einen direkten Link zur konfigurierten Authority. Klicken Sie auf den Authority-Link, um direkt zum Authority Dashboard zu gelangen.

Über die Engine Liste

Alternativ können Sie auch den Link aus der Engine-Liste verwenden, um schnell zur Authority zu navigieren.

Konfiguration der studio-internen Authority

Die studio-interne Authority kann über die Launch Script Settings konfiguriert werden.

Konfiguration über User Settings

Die User Settings finden Sie unter View → User Settings im Studio-Menü.

Beispiel-Konfiguration:

"launchScripts.extraScripts": [
  {
    "id": "__internal_studio_authority__",
    "port": 11235,
    "name": "Studio Authority",
    "enabled": true
  }
]

Verfügbare Optionen

Benutzerdaten während der Prozessausführung

Während der Prozessausführung können die Informationen zum ausführenden Benutzer abgefragt werden. Dies gilt auch für Benutzer, die im Studio zum Starten von Prozessen verwendet werden.

Die Engine stellt diese Informationen über das Token bereit, das bei der Authentifizierung ausgestellt wurde.

Weitere Informationen zum Berechtigungskonzept finden Sie in der Engine-Dokumentation.

Fehlerbehebung

Login-Popup schließt sich direkt

Problem: Das Login-Popup schließt sich direkt und es wird eine Fehlermeldung angezeigt.

Ursache: Die OAuth-Konfiguration ist nicht korrekt.

Lösungen:

• Fehlermeldung client is invalid: Die konfigurierte Client ID ist nicht korrekt. Ältere Authority-Versionen verwenden die ID atlas_studio, während neue nur noch studio verwenden.

• Fehlermeldung requested response type is not allowed for this client: Bei älteren Authority-Versionen wurde der Response Type id_token token benötigt, während für neue code verwendet wird.

• Fehlermeldung requested scope is not allowed: Der Scope-Wert stimmt nicht mit der Authority-Konfiguration überein. Nur die in der Authority-Konfiguration erlaubten Scopes dürfen verwendet werden.

Authority startet nicht

Problem: Die Authority startet nicht beim Studio-Start.

Lösungen:

• Prüfen Sie, ob der Port 11235 bereits belegt ist
• Überprüfen Sie die Launch Script Settings
• Starten Sie das Studio neu

Standard-Benutzer funktioniert nicht

Problem: Login mit admin / admin schlägt fehl.

Lösungen:

• Stellen Sie sicher, dass die Authority gestartet ist
• Prüfen Sie, ob der Benutzer im Authority Dashboard existiert
• Versuchen Sie, das Passwort im Authority Dashboard zurückzusetzen

Externe Authority verwenden

Anstelle der studio-internen Authority können Sie auch eine externe Authority-Instanz verwenden.

Weitere Informationen zur Konfiguration externer Authorities finden Sie in der Authority-Dokumentation.

Weitere Informationen

• Authority Dokumentation - Vollständige Authority-Dokumentation
• Engine Integration - Engine-Verbindung konfigurieren
• Getting Started - Erste Schritte mit dem Studio