Zum Hauptinhalt springen

Richten Sie Ihre Organisation ein

Diese Anleitung richtet sich an Administratoren von Organisationen. Sie öffnen die Admin-Konsole, fügen Ihre ersten Benutzer hinzu, weisen ihnen Rollen zu, richten die Anmeldeeinstellungen für Google oder SSO ein und überprüfen das Prüfprotokoll. Eine detaillierte Liste aller Felder der Admin-Konsole finden Sie unter Administration.

Übersicht des Menüs der Administratorkonsole: Konto-, Organisations-, Plattform- und Sicherheitsgruppen und deren Elemente

Öffnen Sie die Administratorkonsole.​

  1. Wählen Sie unten in der Seitenleiste Ihren Namen aus, dann Admin console (oder wählen Sie Admin Console in der Gruppe System).
  2. Das Menü der Administratorkonsole wird angezeigt. Seine Gruppen sind Account, Organization, Platform und Security.

Die Elemente „Organisation“, „Plattform“ und „Sicherheit“ werden Ihnen nur angezeigt, wenn Sie ein Organisationsadministrator sind: ein Superuser, ein Benutzer mit der Rolle organization_admin, org_admin oder admin oder ein Benutzer mit einer der Lese-/Verwaltungsberechtigungen für die Organisation oder den Benutzer. Falls Ihnen nur Profile und Appearance angezeigt werden, bitten Sie einen vorhandenen Administrator um die entsprechende Rolle.

Einen Benutzer hinzufügen​

Öffnen Sie zuerst Organization, dann Users Dadurch wird die Seite Access control auf dem Users Tab geöffnet.

Die Seite hat sieben Registerkarten, die in einem Menü auf der linken Seite aufgelistet sind: Users, Groups, Roles & permissions, User roles, Direct grants, Overrides und Audit Die Benutzertabelle zeigt User, Status, Roles, Last login und Actions sowie ein Feld Search members.

Wählen Sie Add user. Der Dialog Add organization user bietet drei Modi:

ModusVerwenden Sie es, wennWas geschieht
Invite userDie Person wählt ihr eigenes Passwort.Der Benutzer wird als inaktiv angelegt. Die Person erhält einen Link, um ein Passwort zu erstellen und das Konto zu aktivieren.
Create password userSie müssen jetzt ein Passwort angeben (Nicht-SSO-Konten).Mit dem von Ihnen eingegebenen Passwort (mindestens 8 Zeichen) wird ein verifizierter, aktiver Benutzer erstellt.
Add existing userDie Person besitzt bereits ein Konto bei einer anderen Organisation.Sie behalten ihr Konto und ihre Heimorganisation und erhalten hier mit den von Ihnen ausgewählten Rollen Zugriff. Sie müssen mindestens eine Rolle auswählen.

In jedem Modus werden Email (erforderlich), Full name und Initial roles (eine Checkliste der Rollen in Ihrer Organisation) abgefragt.

Einen Benutzer einladen​

Einladungssequenz

  1. Wählen Sie Invite user, geben Sie die E-Mail-Adresse und optional den vollständigen Namen und die anfänglichen Rollen ein.
  2. Lassen Sie Send invitation email angekreuzt, um den Link per E-Mail zu versenden, und wählen Sie dann Send invite.
  3. Wenn die E-Mail versendet wurde, erscheint eine Benachrichtigung mit der Meldung „Einladung an <email> gesendet“. Der Benutzer wird mit Status Invited angezeigt.
  4. Der Eingeladene öffnet den Link (eine Activate your account Seite), wählt ein Passwort, das den Passwortrichtlinien entspricht, und das Konto wird aktiviert. Anschließend meldet er sich auf der normalen Anmeldeseite an.

Der Link kann nur einmal verwendet werden und verfällt nach 72 Stunden. Durch das Versenden einer neuen Einladung wird der alte Link ersetzt.

If no email was sent. Es erscheint ein Dialogfeld mit dem Titel Share the invitation link und der Meldung: „Es wurde keine E-Mail an <email> gesendet. Teilen Sie diesen Link mit ihnen, damit sie ihr Passwort erstellen können. Er ist nur einmal verwendbar und läuft am <time> ab.“ Außerdem wird eine Schaltfläche Copy link angezeigt. Dies geschieht, wenn Sie Option Send invitation email deaktivieren, wenn der Authentifizierungsdienst keinen Mail-Relay-Dienst oder keine öffentliche Basis-URL konfiguriert hat oder wenn der Versand fehlschlägt. Kopieren Sie den Link und senden Sie ihn selbst zu.

Um später einen neuen Link zu senden, suchen Sie den Benutzer (Status Invited) und wählen Sie Resend invitation aus. Bei einem Benutzer, dessen Link abgelaufen ist, wird dieselbe Schaltfläche angezeigt.

hinweis

Ob Einladungs-E-Mails funktionieren, hängt von der Konfiguration Ihrer Bereitstellung ab (SMTP-Host, Absender und öffentliche Basis-URL). Diese Einstellungen werden Tietai vom Support oder von Ihrem IT-Team vorgenommen und können nicht in der Administratorkonsole bearbeitet werden.

Erstellen Sie einen Passwortbenutzer​

Wählen Sie Create password user, geben Sie Ihre E-Mail-Adresse, Ihren vollständigen Namen und ein Passwort mit mindestens 8 Zeichen ein, dann Create user. Das Passwort muss den Serverregeln in der Administration entsprechen: mindestens 8 Zeichen, darunter ein Großbuchstabe, ein Kleinbuchstabe und eine Zahl, und darf keine sich wiederholenden Zeichen oder einfache Zeichenfolgen enthalten.

Einen bestehenden Benutzer verwalten​

In der Spalte Actions:

TasteWas es tut
EditÄndern Sie Full Name und Email Address, die zugewiesenen Rollen, und den Status (Activate User, oder setzen Sie ihn auf inaktiv/ausstehend).
Resend invitationNur für Benutzer mit Status Invited.
Set passwordÖffnet Set user password. Geben Sie ein neues Passwort ein und bestätigen Sie es (mindestens 8 Zeichen). Das aktuelle Passwort des Benutzers wird nicht benötigt. Verwenden Sie es für lokale Konten.
ImpersonateWird nur Tietai Mitarbeitern angezeigt.
Rotes MülltonnensymbolDeactivate user. Der Benutzer verliert sofort den Zugriff. Das Konto und seine Datensätze bleiben zu Prüfungszwecken erhalten und können durch Bearbeiten des Benutzers reaktiviert werden. Eine Selbstdeaktivierung ist nicht möglich.

Ein Benutzer aus einer anderen Organisation trägt das Tag Other organization; die einzige Aktion ist Remove access, wodurch seine Rollen und Zugriffsrechte in Ihrer Organisation entfernt werden, ohne dass sein Konto oder seine Heimatorganisation verändert wird.

Die API bietet auch Blockierungs- und Entsperrungsfunktionen (ein blockierter Benutzer wird mit dem Statuscode Blocked rot) angezeigt und kann sich nicht anmelden). Auf der Seite zur Zugriffskontrolle sind dafür keine Schaltflächen vorhanden.

Weisen Sie den Benutzern die richtigen Rollen zu.​

Vordefinierte Rollen​

Die Rollendefinitionen der Plattform beinhalten diese Organisationsrollen (tietai-auth-service/app/schemas/role.py):

Rolle (Anzeigename)Bestimmt fürWichtige Berechtigungen
organization_admin (Organisationsadministrator)Leitung der Organisation.Vollständige Benutzer-, Organisations-, Verbindungs-, Integrations-, FHIR-, Abrechnungs-, Projekt-, Pipeline-, Agenten- und RAG-Berechtigungen.
integration_manager (Integrationsmanager)Integrationsarbeiten.Verbindungen und Integrationen (erstellen, lesen, aktualisieren, löschen, ausführen), HL7, FHIR und X12; Pipelines und Agents lesen und ausführen; Pipelines können nicht erstellt werden.
developer (Entwickler)Aufbau und Test.Projekte, Pipelines und Agents erstellen und aktualisieren sowie ausführen; keine Löschrechte; keine Benutzerverwaltung.
viewer (Zuschauer)Nur Lesezugriff (die Standardrolle).Organisationen, Verbindungen, Integrationen, Projekte, Pipelines und Agenten lesen und auflisten.

Außerhalb von Organisationen existieren zwei Systemrollen: superuser („Systemadministrator“, alle Berechtigungen) und platform_manager („Plattformmanager“, nur agents:manage_base_templates). Es gibt keine vordefinierten Rollen wie „Kliniker“ oder „Administrator“. Die Registerkarte Roles & permissions zeigt die in Ihrer Organisation tatsächlich vorhandenen Rollen an und dient als maßgebliche Instanz. Ihre Organisation kann mehr Rollen enthalten als in dieser Liste aufgeführt.

Rollen zuweisen​

Verwenden Sie den Tab User roles: Wählen Sie einen Benutzer aus, markieren Sie die Rollen und wählen Sie Save user roles. Durch Speichern wird die Rollenliste des Benutzers überschrieben. Sie können Rollen auch beim Hinzufügen oder Bearbeiten eines Benutzers festlegen.

Erstellen Sie eine benutzerdefinierte Rolle​

  1. Öffne Roles & permissions, dann Create role.
  2. Füllen Sie Display Name, Role Name (Internal) (zum Beispiel data_analyst), Description (erforderlich) und die gewünschte Permissions aus.
  3. Wählen Sie eine Rolle aus der Liste aus, um deren Berechtigungen direkt zu bearbeiten. Systemrollen werden mit Read-only system role angezeigt; benutzerdefinierte Rollen Editable custom role und einer Schaltfläche Delete.

Berechtigungen können mit einem Sicherheitssymbol versehen sein. Enforced bedeutet, dass der zugehörige Dienst den Berechtigungsschlüssel prüft. Enforced via role bedeutet, dass eine Rolle die Berechtigung weiterhin gewährt, sodass die alleinige Zuweisung des Schlüssels den Zugriff nicht einschränkt. Declared — not enforced yet bedeutet, dass die Zuweisung aktuell keine Auswirkung hat. Lesen Sie das Sicherheitssymbol, bevor Sie sich auf eine Berechtigung verlassen, um etwas abzusichern.

Gruppen, direkte Zuwendungen und Ausnahmen​

  • Groups: Erstellen Sie eine Gruppe (Name und Beschreibung) und fügen Sie anschließend Mitglieder hinzu oder entfernen Sie diese. Auf der Seite wird angegeben, dass Gruppen derzeit nur Mitgliedschaften und Gruppenmitgliedsrollen unterstützen.
  • Direct grants: Einem Benutzer Berechtigungen für eine Ressource (Ressourcentyp: Organisation, Projekt, Pipeline, Agent, Workflow, Knoten oder Ausführung; eine Ressourcen-ID; Hinweise) erteilen. Diese Option sollte nur verwendet werden, wenn eine Rollenrichtlinie nicht ausreicht.
  • Overrides: Erstellen einer benutzerspezifischen Vererbungsüberschreibung für eine Ressource mit Angabe eines Grundes.
  • Audit: Wählen Sie einen Benutzer aus, um dessen aufgelöste Zugriffsübersicht anzuzeigen.

SSO konfigurieren und zulässige Domänen​

Öffnen Sie Security, dann SSO / SAML (SSO configuration). Diese Seite erfordert einen Organisationsadministrator.

  1. Schalter Enable single sign-on einschalten.
  2. Wählen Sie eine Provider: Google, Microsoft, Okta, Auth0, Custom OIDC oder Custom SAML.
  3. Geben Sie Client ID und Client secret ein. Das Geheimnis wird gespeichert und nie wieder angezeigt; anschließend erscheint die Meldung „Geheimnis ist bereits gespeichert“.
  4. Geben Sie OIDC issuer URL (alle Anbieter außer SAML) oder SAML metadata URL (Custom SAML) ein, optional auch Metadata URL.
  5. Unterhalb von Allowed email domains fügen Sie jede Domäne (zum Beispiel demo-hospital.example) mit Add hinzu. Optional können Sie Validate email domains und Auto-provision users beibehalten.
  6. Wählen Sie Save configuration, dann Test SSO connection (optional kann eine E-Mail-Adresse für einen Testbenutzer angegeben werden). Der Test prüft, ob der Anbieter antwortet (OIDC-Erkennung oder Metadatenabruf) und protokolliert die Last tested Antwort.

Was das heute tatsächlich bewirkt:

  • Google sign-in verwendet die zulässigen Domains. Wenn sich jemand mit Google anmeldet, muss seine E-Mail-Domain in der Liste enthalten sein, und er wird der Organisation zugeordnet, der die Domain gehört. Bei der ersten Google-Anmeldung wird ein nicht existierender Benutzer angelegt. Eine nicht aufgeführte Domain wird mit der Meldung „E-Mail-Domain ist nicht für die OAuth-Anmeldung autorisiert“ abgelehnt.
  • Die Anbietereinstellungen werden gespeichert und die Konnektivität getestet. Der Authentifizierungsdienst verfügt über keinen OIDC- oder SAML-Anmeldeendpunkt, und die Anmeldeseite enthält keine OIDC- oder SAML-Schaltfläche. Daher fügt die Aktivierung von Okta, Auth0, Microsoft, benutzerdefiniertem OIDC oder benutzerdefiniertem SAML an sich keine Anmeldemöglichkeit hinzu.
  • Beim Anmelden werden keine Werte von Validate email domains oder Auto-provision users ausgelesen. Der Google-Ablauf prüft die Domainliste und erstellt Benutzer unabhängig von diesen Einstellungen.

Falls Sie eine OIDC- oder SAML-Anmeldung benötigen, wenden Sie sich bitte an den Tietai Support, bevor Sie eine entsprechende Einführung planen.

warnung

Deaktivieren Sie die Passwort-Anmeldung für den Produktivstart nicht allein aufgrund dieser Seite. Stellen Sie sicher, dass mindestens ein Administrator sich mit einem Passwort oder Google anmelden kann.

Organisationseinstellungen​

Organization, dann General Settings (Organization settings) hat vier Registerkarten: General, Configuration, API Tokens und Agents.

  • Die General zeigt die ausgewählte Organisation, Ihren Benutzer, Ihre Heimatorganisation und alle Organisationen an, auf die Sie Zugriff haben (mit der Kennzeichnung Home). Nur Plattformbetreiber (Superuser und Plattformadministratoren) sehen die Create Organization sowie die Symbole zum Bearbeiten und Löschen.
  • Configuration listet die Konfigurationszeilen der Organisation mit einem Kategoriefilter und einer Suchfunktion auf; jede Zeile zeigt ihren Wert und Status-Badges (Active, Inherits system, Read only) sowie eine Schaltfläche Save für bearbeitbare Werte an. Sensible Werte sind ausgeblendet.
  • API Tokens ist derselbe Token-Manager, der im Abschnitt Administration beschrieben wird.
  • Agents (auch Consulta Agents im Menü) wird ausgewählt, welcher Agent oder welche Pipeline die Tiet · Consult Flows General consult agent und SOAP report agent ausführt, wobei standardmäßig System default eingestellt ist; außerdem enthält es Diagnosis coding Einstellungen.

Die Einstellungen für Sprache, Anzeige und Geschäftszeiten (Zeitzone, Datums- und Zeitformat, Logo-URL, Farben, Geschäftszeiten) befinden sich in einem separaten Abschnitt General der Einstellungsseite unter /settings#general; das Menü der Admin-Konsole verlinkt nicht darauf.

Überprüfen Sie den Prüfpfad​

Öffnen Sie zuerst Security, dann Audit Trail. Die Seite listet Ereignisse mit Timestamp, User, Action und Resource auf, insgesamt 20 pro Seite. Filtern Sie nach Suchtext, Datumsbereich und Aktionstyp (Erstellen, Aktualisieren, Löschen, Ausführen, Anmelden, Abmelden, Anzeigen, Exportieren, Fehler). View Details öffnet ein einzelnes Ereignis. Export Log lädt eine CSV-Datei namens audit_logs_<date>.csv herunter, die die Spalten Zeitstempel, Benutzer-E-Mail, Benutzername, Aktionstyp, Aktionsbeschreibung, Ressourcentyp, Ressourcenname, Status und IP-Adresse enthält. CSV ist das einzige Exportformat.

Der Authentifizierungsdienst protokolliert Ereignisse für Benutzereinladungen (gesendet und angenommen), Passwortzurücksetzungsanfragen und -abschlüsse, Sperrungen und Entsperrungen, Rollenzuweisungen und -entfernungen, Gruppen, Organisations- und Mitgliederänderungen, Umgebungen, SSO-Konfigurationen, Signaturschlüssel, Verbindungen und Identitätswechsel. Der Dienst protokolliert keine Anmeldungen, Abmeldungen oder die Erstellung von API-Tokens. Verwenden Sie diese Seite daher nicht als Anmeldeprotokoll.

Geheimnisse und Umgebungen​

  • Platform, dann Secrets (/organization-secrets) speichert benannte Geheimnisse nach Typ, Umgebung, Dienstbeschränkungen und Rotationstagen. Die Authentifizierungsdienstquelle listet Geheimnisse auf und prüft nur die Rotation; das Erstellen, Bearbeiten, Rotieren und Anzeigen eines Wertes ist dort als aufgeschoben markiert. Wenn Add Secret fehlschlägt, ist dies wahrscheinlich die Ursache. Siehe Administration.
  • Platform, dann Environments verwaltet benannte Umgebungen mit Variablen. Siehe Administration. Umgebungen für die Übertragung zwischen Bereitstellungen werden unter Umgebungen und Übertragung beschrieben.

Welchen Authentifizierungsdienst ruft die Benutzeroberfläche auf?​

Die Admin-Konsole ruft die Gateway-Pfade /admin/users, /admin/groups, /admin/audit-logs, /admin/environments, /organizations/{id}/sso und /api-tokens auf, die das Gateway dem Authentifizierungsdienst zuordnet. Im Repository befinden sich zwei Implementierungen: der Go-Dienst tietai-auth-service-go (beschrieben als Ersatz für den Python-Dienst) und die ursprüngliche Python-Implementierung tietai-auth-service. Die Gateway-Kommentare und die Paritätshinweise des Go-Dienstes zeigen, dass der Go-Dienst das Ziel des aktuellen Gateways ist. Diese Anleitung folgt diesem (Branch dev). Vordefinierte Rollendefinitionen sind nur im Quellcode des Python-Dienstes vorhanden. Das Gateway leitet Anfragen an eine feste Adresse weiter, die im Repository keiner bestimmten Implementierung zugeordnet ist. Sollte sich Ihre Bereitstellung anders verhalten als in dieser Anleitung beschrieben, fragen Sie bitte Tietai nach, welche Version Sie verwenden.

Fehlerbehebung​

ProblemUrsache und Lösung
Keine Organization, Platform oder Security Artikel im MenüIhr Konto ist kein Organisationsadministrator. Fordern Sie die Rolle organization_admin an.
In der Benutzertabelle wird die Meldung "Benutzer konnten nicht vom Authentifizierungsdienst geladen werden" angezeigt.Die Anfrage ist fehlgeschlagen oder Sie verfügen nicht über die Berechtigung zur Benutzerverwaltung. Bitte laden Sie die Seite neu und überprüfen Sie Ihre Rolle.
Eingeladener Nutzer sagt: „Diese Einladung ist nicht mehr gültig.“Der Link wurde verwendet, durch einen neueren ersetzt oder ist älter als 72 Stunden. Wählen Sie Resend invitation.
Failed to create user ToastDie Servermeldung wird angezeigt. Ein Passwort, das gegen die Richtlinien verstößt, liefert die Liste der nicht erfüllten Regeln; eine doppelte E-Mail-Adresse wird ebenfalls abgelehnt.
"Passwort konnte nicht aktualisiert werden"Das neue Passwort entspricht nicht den Richtlinien. Verwenden Sie mindestens 8 Zeichen, darunter Großbuchstaben, Kleinbuchstaben und eine Zahl.
Bei der Google-Anmeldung wird die Meldung angezeigt: „E-Mail-Domäne ist für die OAuth-Anmeldung nicht autorisiert.“Fügen Sie die Domäne unter Allowed email domains auf der SSO-Seite hinzu.
Es kommt keine Einladungs-E-Mail an.Prüfen Sie, ob das Dialogfeld Share the invitation link angezeigt wird; falls E-Mail nicht konfiguriert ist, übermitteln Sie den Link selbst oder verwenden Sie Create password user.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..