Skip to Content

Benutzerprofile & Attribute

Standard-Profilfelder, benutzerdefinierte Profilattribute und Sichtbarkeit.

Das Profil eines Benutzers ist die Menge der Felder, die das Konto beschreiben. Die Plattform bringt eine feste Menge an Standardfeldern mit und erlaubt es, das Profil mit eigenen benutzerdefinierten Attributen zu erweitern, die einmal zentral definiert und den Verzeichnissen zugewiesen werden, die sie verwenden sollen.

Standard-Profilfelder

Jedes Verzeichnis stellt einen gemeinsamen Satz von Standardfeldern bereit. Die wichtigsten sind:

FeldHinweise
EmailPrimärer Kontakt und, in den meisten Verzeichnissen, der Anmeldebezeichner. Kann verifiziert werden.
UsernameOptionaler sekundärer Bezeichner.
Full nameVor-, Nachname und optional ein zweiter Vorname.
MobileTelefonnummer, verwendet für SMS-Faktoren; kann verifiziert werden. Eine optionale zweite Nummer wird unterstützt.
Title, Department, Company nameBerufliche Attribute. Company name ist standardmäßig deaktiviert und teilt sich die Ablage mit dem Wert, den eine Verzeichnissynchronisation liefert.
Office location, employee number, hiring dateWeitere berufliche Attribute, verfügbar, wo das Verzeichnis Profilbearbeitung erlaubt.

Jedes Verzeichnis steuert pro Feld, ob es aktiviert ist, ob es als Anmeldebezeichner dient, ob es erforderlich ist und ob es bei der Registrierung erscheint (off / optional / required). Mindestens ein Bezeichner muss immer aktiv sein. Sie konfigurieren dies am Verzeichnis selbst, siehe Benutzerverzeichnisse → Profilschema.

Welches System ein Feld besitzt

Ob ein Profilfeld in der Konsole bearbeitet werden kann, hängt vom Verzeichnis ab:

  • Lokale Verzeichnisse: Felder sind hier immer bearbeitbar. Die Plattform ist die Quelle der Wahrheit.
  • Synchronisierte Enterprise-Verzeichnisse: Die vorgelagerte Active-Directory-/LDAP-Quelle verantwortet ihre Felder. Sie sind in der Konsole schreibgeschützt, es sei denn, Upstream-Sync (Write-Back) ist für dieses Verzeichnis aktiviert; in diesem Fall werden hier vorgenommene Änderungen an die Quelle zurückgeschrieben. Bei ausgeschaltetem Write-Back werden die Formularfelder angezeigt, sind aber deaktiviert.

Dies hängt direkt mit den Aktiviert-/Erforderlich-Umschaltern pro Feld und der Upstream-Sync-Einstellung des Verzeichnisses zusammen, siehe Benutzerverzeichnisse → Synchronisierung.

Für AD/LDAP-Verzeichnisse stellt das Profil die verzeichniseigenen Bezeichner bereit: common name, organizational unit (aus einem OU-Picker gewählt) und user principal name, anstelle einer freien Bearbeitung von E-Mail und Benutzername.

Profildaten versus zugriffstragende Daten

Ein Profil trägt zwei Arten von Daten, und der Unterschied entscheidet, wer ein Feld bearbeiten darf:

  • Profildaten beschreiben die Person und ändern sich mit ihrem Leben, nicht mit ihrem Zugriff: Anzeigename, Telefonnummer, bevorzugte Sprache, Bürostandort, T-Shirt-Größe für das Onboarding-Paket. Wo ein Verzeichnis Self-Service erlaubt, pflegen Benutzer diese Felder selbst.
  • Zugriffstragende Daten sind alles, was ein System liest, um zu entscheiden, was die Person darf: Gruppenmitgliedschaft, Rollen, Kontostatus, Kostenstelle oder Abteilung, wenn eine App daraus Berechtigungen ableitet, eine Kundennummer, der eine Anwendung vertraut. Ein solches Feld wird niemals für Self-Service geöffnet: Ein Wert, den der Benutzer ändern kann, ist ein Wert, den der Benutzer sich selbst gewähren kann. Halten Sie ihn admin-kontrolliert oder synchronisiert aus dem besitzenden System.

Ob ein Attribut die Plattform verlässt, wird pro Anwendung im Reiter Attribute der Anwendung entschieden: Eine OIDC-Anwendung wählt aus, welche benutzerdefinierten Attribute sie als Claims erhält, eine SAML- oder WS-Federation-Anwendung bildet sie in ihren Attribut-Statements ab. Ein Attribut zu definieren gibt es also für sich genommen nie preis. Behandeln Sie alles, was in einem Token oder einer Assertion landet, als operative Daten: Geben Sie nur aus, was die empfangende App benötigt, und legen Sie niemals interne oder sensible Werte auf diesem Weg offen.

Benutzerdefinierte Profilattribute

Hinweis: Benutzerdefinierte Profilattribute sind Teil der Funktion profile metadata, verfügbar ab der Advanced-Stufe (und während der Testphase).

Wenn die Standardfelder nicht ausreichen, definieren Sie ein benutzerdefiniertes Attribut. Benutzerdefinierte Attribute werden einmal in einem zentralen Katalog erstellt und dann jedem Verzeichnis zugewiesen, das sie erfassen soll. Dieses zweistufige Modell hält eine einzige Definition über Verzeichnisse hinweg konsistent und lässt gleichzeitig jedes Verzeichnis entscheiden, ob das Feld erforderlich ist und ob es bei der Registrierung erscheint.

Ein benutzerdefiniertes Attribut definieren

Benutzerdefinierte Attribute werden im Verzeichnisbereich auf der Seite Attributes verwaltet.

  1. Öffnen Sie Attributes und wählen Sie, ein neues Attribut hinzuzufügen.

  2. Geben Sie ihm einen Namen (den stabilen Bezeichner) und ein Label (das, was Benutzer und Admins sehen). Die Namen der Standard-Profilfelder sowie die Namen von Claims in ausgestellten Tokens (zum Beispiel email, title, mobile, groups oder sub) sind unabhängig von der Groß- und Kleinschreibung reserviert: Ein benutzerdefiniertes Attribut mit einem solchen Namen sähe aus wie das Standardfeld, enthielte aber separate Daten, daher wird die Anlage abgelehnt. Wählen Sie stattdessen einen eigenen Namen, etwa jobRole statt title.

  3. Wählen Sie einen Typ:

    TypVerwendung für
    TextFreien kurzen Text.
    NumberNumerische Werte.
    DateKalenderdaten.
    Select / ChoiceEine feste Liste von Optionen, die Sie definieren (Wert und Label).
    PasswordEinen geheimen Wert.
  4. Konfigurieren Sie optional:

    • Description: Freitext, der als Hinweis unter dem Feld angezeigt wird, bei der Registrierung und im Profil, genau wie eingegeben (nicht übersetzt).
    • Multiple values: Erlaubt dem Feld, eine Liste zu halten.
    • Default value.
    • Uniqueness: Standardmäßig muss der Wert eines Attributs kontenübergreifend eindeutig sein (keine zwei Benutzer dürfen ihn teilen, zum Beispiel eine Personalnummer). Aktivieren Sie Allow duplicates, um diese Einschränkung aufzuheben und mehreren Konten denselben Wert zu erlauben. Die Eindeutigkeit steht neben der Validierungseigenschaft unten.
    • Pflege nur über die API: Der Wert wird angezeigt, ist aber weder im Benutzerprofil noch in der Admin Console manuell bearbeitbar; nur die Management-API (eine Integration oder Synchronisation) schreibt ihn. Ein solches Attribut wird auch nie bei der Registrierung erfasst.
  5. Legen Sie die Sichtbarkeit fest (siehe unten) und speichern Sie.

Jedes benutzerdefinierte Attribut kann über die Management-API gefiltert werden; der Index, der diese Abfragen stützt, wird automatisch gepflegt.

Mit einer Vorlage beginnen

Vorlagen decken Attribute ab, die ohnehin fast jeder Mandant benötigt, etwa Unternehmensgröße, Kostenstelle, Beschäftigungsart oder Eintrittsdatum. Wählen Sie eine unter Attribute template, und Name, Typ und Optionen werden vorbelegt, dazu ein Label. Mit der Vorlage bleibt nichts verknüpft: Jeder Wert ist änderbar, und das Ergebnis verhält sich genau wie ein selbst definiertes Attribut.

Vorlagen sind zudem übersetzt. Ein Label aus einer Vorlage wird jedem Benutzer in seiner Sprache angezeigt, ein deutscher Benutzer liest also "Unternehmensgröße", wo ein englischer Benutzer "Company size" liest. Nach der Auswahl einer Vorlage zeigt das Feld Label selbst den englischen Referenztext, denn über diesen Text wird die Übersetzung gefunden. Lassen Sie ihn unverändert, um die Übersetzungen zu behalten.

Ein selbst eingegebenes Label wird allen Benutzern genau so angezeigt, wie Sie es eingetragen haben, in jeder Sprache. Dasselbe gilt für ein nachträglich geändertes Vorlagen-Label, ändern Sie es also nur, wenn Ihnen die eigene Formulierung wichtiger ist als die Übersetzungen. Für die Options-Labels eines Select-Attributs gilt dieselbe Regel.

Sichtbarkeit

Die Sichtbarkeit steuert, wo das Attribut angezeigt wird und wer es bearbeiten kann:

SichtbarkeitVerhalten
Nur APIWird nicht im Profil und nicht in der Admin Console angezeigt. Wird über die API gesetzt oder einmalig bei der Registrierung erfasst, wenn ein Verzeichnis danach fragt.
Admin ConsoleSichtbar und bearbeitbar in der Admin Console, nicht für den Endbenutzer.
Admin Console + BenutzerprofilWird dem Benutzer zusätzlich in seinem Profil angezeigt, wo er den Wert selbst bearbeiten kann.

Hinweis: Sobald ein Attribut einem beliebigen Verzeichnis zugewiesen ist, wird seine Sichtbarkeit gesperrt und das Attribut kann nicht gelöscht werden, bis es überall wieder entfernt ist. Dies schützt bestehende Benutzerdatensätze sowie die Registrierungs-/Profildarstellung davor, aus dem Takt mit der Definition zu geraten.

Einem Verzeichnis zuweisen

Jedes benutzerdefinierte Attribut kann einem Verzeichnis zugewiesen werden, wodurch es bei den Benutzern dieses Verzeichnisses verfügbar wird. Wo der Wert gesetzt wird, hängt von der Sichtbarkeit ab:

  • ein Attribut mit Admin Console + Benutzerprofil erscheint im Profil des Benutzers und, sofern aktiviert, bei der Registrierung; der Benutzer kann es ausfüllen;
  • ein Admin Console-Attribut erscheint bei diesen Benutzern in der Admin Console, wo Sie es setzen; es wird dem Benutzer nicht angezeigt;
  • ein Nur API-Attribut wird über die API gesetzt und weder im Profil noch in der Admin Console angezeigt. Verwenden Sie dies für einen Wert, den eine vertrauende Anwendung nutzt (zum Beispiel ein SAML-Attribut) und der von einer Integration statt von einer Person gepflegt wird.

In der Attributkonfiguration des Verzeichnisses wählen Sie pro Attribut, ob es bei der Registrierung erscheint (dort optional oder erforderlich) und ob es im Profil erforderlich ist. Die Erfassung bei der Registrierung ist unabhängig von der Sichtbarkeit: Ein Admin Console- oder Nur API-Attribut, das bei der Registrierung abgefragt wird, füllt die registrierende Person einmalig aus und ist danach nur dort lesbar, wo die Sichtbarkeit es zulässt. Nutzen Sie das für Daten, die Sie bei der Registrierung benötigen, die der Benutzer aber nicht erneut aufrufen soll, etwa einen Empfehlungscode oder eine Kostenstelle. Ein Attribut mit Pflege nur über die API kann nicht bei der Registrierung erfasst werden, da die registrierende Person sein Feld nie ausfüllen könnte. Die Einstellung erforderlich gilt dort, wo das Attribut zum Bearbeiten angezeigt wird.

Auch die Definition selbst ist in diesem Tab bearbeitbar: Add attribute → Create new attribute legt ein neues Attribut an und weist es dem Verzeichnis sofort zu, und Edit attribute im Aktionsmenü einer Zeile öffnet den Definitionsdialog (Beschriftung, Typ, Optionen, Einstellungen). Configure bleibt der Ort für die oben beschriebenen Erfassungseinstellungen pro Verzeichnis.

Die Listenreihenfolge ist die Anzeigereihenfolge: Registrierung, Benutzerprofil und die Benutzer-Detailseite zeigen die Attribute genau so wie hier angeordnet. Ziehen Sie den Anfasser rechts in einer Zeile, um die Reihenfolge zu ändern.

Siehe auch

Auf dieser Seite