Zum Hauptinhalt springen

Service User

Ein Service User ist ein technischer Benutzer, der Schnittstellen aufrufen und sich mit einem Access Key authentifizieren kann.

Im Gegensatz zu einem normalen Benutzer hat ein Service User kein Passwort und kann sich nicht mit einer Benutzerkennung authentifizieren. Ein Service User kann sich nicht auf der Benutzeroberfläche anmelden oder mit einer Benutzerkennung eine Schnittstelle aufrufen.

Tooltipp

Nur Benutzer mit der Zugriffsstufe Administrator sind berechtigt, Service User anzulegen, zu bearbeiten oder zu löschen.

Service User anlegen

Service User werden im Elementefenster des Mandanten erfasst.

Optionen-Menü

Ein neuer Service User kann durch Klick auf den Reiter "Service User" und auf das Symbol "+" (bzw. durch Auswahl von "Service User anlegen..." im Menü) angelegt werden.

Anlegen

Beim Anlegen müssen die eindeutige ID und der Name verpflichtend angegeben werden. Gegebenenfalls kann die Zugriffsstufe geändert werden.

Hinweis

Im Gegensatz zu einem normalen Benutzer kann ein Service User keiner Person zugewiesen werden. Ein Service User hat kein Passwort, da die Authentifizierung beim Aufruf von Schnittstellen ausschließlich mit einem Access Key möglich ist.

Durch Klick auf "Anlegen" wird der Service User erstellt.

Service User bearbeiten

Ein Service User kann im Elementefenster des Mandanten, durch Klick auf das Bearbeiten-Symbol (bzw. durch Auswahl von "Service User bearbeiten" im Menü) neben dem Service User, bearbeitet werden.

Bearbeiten

Der Bearbeitungsmodus ermöglicht das Editieren der Zugriffsstufe. Gegebenenfalls kann der Name geändert werden.

Bearbeitenansicht

Durch Klick auf "Speichern" werden die Änderungen übernommen.

Service User löschen

Ein Service User kann durch Auswahl von "Service User löschen" im Menü neben dem Service User gelöscht werden.

Access Keys verwalten

Ein Access Key ist eine geheime Zeichenfolge, die eindeutig einem Service User zugewiesen wird. Beim Aufruf einer Schnittstelle kann der Access Key verwendet werden, um den Service User zu identifizieren.

Hinweis

Service User können sich ausschließlich mit einem Access Key authentifizieren, um eine Schnittstelle aufzurufen. Die Authentifizierung mit Benutzerkennung ist für Service User nicht möglich.

Die Access Keys eines Service Users können im Elementefenster des Mandanten, durch Auswahl von "Access Keys verwalten" im Menü neben dem Service User, verwaltet werden.

Hinweis

Service User können sich nicht auf der Benutzeroberfläche anmelden. Nur Benutzer mit der Zugriffsstufe Administrator sind berechtigt, die Access Keys von Service Usern zu verwalten.

Bearbeiten

Im Dialog werden die vorhandenen Access Keys angezeigt.

Bearbeitenansicht

Hinweis

Aus Sicherheitsgründen werden die Werte der vorhandenen Access Keys nicht vollständig angezeigt.

Ein neuer Access Key kann durch Klick auf "Hinzufügen" angelegt werden.

Bearbeitenansicht

Beim Anlegen müssen der eindeutige Name und das Ablaufdatum verpflichtend angegeben werden.

Tooltipp

Ein neuer Access Key kann sofort für Schnittstellenaufrufe verwendet werden. Üblicherweise wird vor dem Ablauf eines vorhandenen Access Keys bereits ein neuer Access Key erzeugt. Schnittstellenaufrufe können schrittweise auf den neuen Access Key umgestellt werden, ohne den laufenden Betrieb zu stören.

Durch Klick auf "Generieren" wird ein neuer Access Key generiert und dem Service User zugeordnet.

Bearbeitenansicht

Achtung

Aus Sicherheitsgründen wird der Access Key nur unmittelbar nach dem Generieren einmalig angezeigt. Der Access Key muss kopiert und an einem sicheren Ort aufbewahrt werden. Sollte der Access Key verloren gehen muss er gelöscht und ein neuer Access Key generiert werden.

Mit Klick auf img wird ein Access Key gelöscht.

Hinweis

Ein Access Key gilt nur in einem einzigen Mandanten. Falls der Service User in mehreren Mandanten existiert, müssen pro Mandant unterschiedliche Access Keys angelegt werden.