> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Schema

> Das Schema hinter jedem Benutzerprofil: integrierte Felder, die von Ihnen definierten benutzerdefinierten Attribute und wie Attribute in Auto Groups und App-Zuordnungen einfließen.

Jedes Benutzerprofil wird durch Ihr **Schema** geprägt: den Satz von Attributen, die ein Profil
enthalten kann. Das Schema beginnt mit integrierten Feldern, die für alle existieren, und
Sie erweitern es mit **benutzerdefinierten Attributen**, die auf Ihre Organisation zugeschnitten sind. Sie bearbeiten
das Schema unter **Directory → Users → Schema** (das Schema-Steuerelement auf der Seite „Users“ ist eine Symbolschaltfläche, keine Textbeschriftung).

Attribute sind mehr als nur Speicher. Sie sind das Rohmaterial, aus dem
[Auto Groups](/de/identity/directory/auto-groups) ihre Mitgliedschaft berechnen
und das Anwendungen in die empfangenen Identitätsdaten übernehmen. Das Schema,
das Sie hier entwerfen, prägt also Zugriff und Automatisierung in ganz Iru Identity.

<Frame caption="Der User Schema-Editor: integrierte und benutzerdefinierte Attribute mit Slug, Typ und Kennzeichen, gruppiert in Kategorien.">
  <img src="https://mintcdn.com/iru/yv46VZ-WbN1GdStp/assets/media/images/user-schema.webp?fit=max&auto=format&n=yv46VZ-WbN1GdStp&q=85&s=374c27a7f249db7f8fa332ecb1964c26" alt="Die Seite User Schema mit der Kategorie Default und Attributen wie Domain, Username, Iru Role, Name und Email, jeweils mit Slug, Typ und den Spalten Unique, Required und Auto Group." width="2000" height="1137" data-path="assets/media/images/user-schema.webp" />
</Frame>

## Integrierte Felder

Jedes Profil enthält einen Satz integrierter Facetten, die Sie nicht definieren müssen:

* **Name**, verwendet zur Bildung des Anzeigenamens des Benutzers.
* **E-Mail-Adressen**, **Telefonnummern** und **Adressen**, wobei jeder Eintrag eine
  **Bezeichnung** wie geschäftlich oder privat trägt.
* Ein **Benutzername** und eine **Domäne**, die zusammen die Anmeldekennung bilden.
* Eine **Rolle**, ein **Status** und eine **Quelle**. Die **Rolle** gilt für alle Iru-Produkte,
  nicht nur für Identity.

Diese werden zusammen mit dem Rest des Profils unter
[Benutzer](/de/identity/directory/users) beschrieben.

<Note>
  **Unterstützung mehrerer E-Mail-Domänen.** Die **Domäne**, die ein Benutzer haben kann, stammt
  aus einer festen Liste zulässiger Werte im integrierten Domänenfeld. Wenn Ihre
  Organisation mehrere Domänen verwendet (zum Beispiel `example.com` und `example.io`),
  fügen Sie jede davon dieser Liste im Schema hinzu; nur dort definierte Domänen können
  beim Erstellen oder Importieren eines Benutzers gewählt werden.
</Note>

## Benutzerdefinierte Attribute

Ein benutzerdefiniertes Attribut fügt jedem Benutzerprofil ein Feld hinzu. Beim Erstellen
legen Sie Folgendes fest:

| Eigenschaft | Funktion |
| - | - |
| **Display name** | Die für Menschen lesbare Bezeichnung, die im Profil angezeigt wird. |
| **Slug** | Eine stabile, maschinenfreundliche Kennung, die bei der Zuordnung des Attributs in Apps und Regeln verwendet wird. |
| **Type** | Die Art des enthaltenen Werts, ausgewählt aus den unten aufgeführten **Attributtypen**. |
| **Beschreibung** | Optionale Hinweise für Administratoren, die das Profil bearbeiten. |
| **Kategorie** | Der Profilabschnitt, in dem das Attribut erscheint (siehe unten). |
| **Required** | Wenn aktiviert, kann ein Profil nicht ohne einen Wert für dieses Attribut gespeichert werden. |
| **Unique** | Wenn aktiviert, dürfen keine zwei Benutzer denselben Wert für dieses Attribut haben. |

<Frame caption="Hinzufügen eines benutzerdefinierten Attributs.">
  <img src="https://mintcdn.com/iru/yv46VZ-WbN1GdStp/assets/media/images/schema-add-attribute.webp?fit=max&auto=format&n=yv46VZ-WbN1GdStp&q=85&s=d1cd709823941a74f2e097f8f386453f" alt="Der Dialog Add Attribute mit den Feldern Display Name, Slug und Description, den Auswahlfeldern Category und Type sowie den Schaltern Unique und Required." width="2000" height="1135" data-path="assets/media/images/schema-add-attribute.webp" />
</Frame>

<Note>
  Wählen Sie **erforderlich** und **eindeutig** bewusst. Ein erforderliches Attribut muss
  bei jedem Benutzer vorhanden sein, auch bei solchen, die per Import oder HR-Synchronisierung erstellt wurden; ein
  Datensatz ohne dieses Attribut kann daher nicht gespeichert werden. Ein eindeutiges Attribut eignet sich gut für
  Kennungen wie eine Personalnummer.
</Note>

### Attributtypen

Wenn Sie ein benutzerdefiniertes Attribut hinzufügen, wählen Sie einen dieser Typen für den enthaltenen
Wert:

| Typ | Inhalt |
| - | - |
| **String** | Freitext. |
| **Integer** | Eine ganze Zahl. |
| **Decimal** | Eine Zahl, die Nachkommastellen haben kann. |
| **Boolean** | Ein Wahr- oder Falsch-Wert. |
| **Enumeration** | Ein Wert aus einer festen, von Ihnen definierten Liste von Optionen (siehe unten). |
| **Date** | Ein Datumswert. |
| **Binary** | Ein Base64-kodierter Wert. |
| **JSON** | Ein strukturierter JSON-Wert für verschachtelte oder zusammengesetzte Daten. |

<Note>
  Ein Typ wird beim Erstellen des Attributs gewählt und **kann später nicht geändert werden**.
  **Unique** ist für Attribute vom Typ **Boolean** oder **Enumeration** nicht verfügbar, da deren
  Werte sich zwischen Benutzern wiederholen sollen. Ein **Binary**-Wert wird als Base64 gespeichert
  und ist nicht größenbeschränkt. Verwenden Sie ihn für **kleine** Werte wie ein Token oder einen Schlüssel,
  nicht für große Dateien.
</Note>

### Attribute mit festen Auswahlmöglichkeiten

Manche Attribute sollten nur Werte aus einer bekannten Liste akzeptieren (eine Abteilung, ein
Standort, eine Beschäftigungsart. Geben Sie solchen Attributen eine feste Liste
**zulässiger Werte** (Aufzählungsoptionen). Jede Option hat einen eigenen Anzeigenamen
und eine eigene Kennung.

Attribute mit fester Auswahl sind besonders nützlich, weil sie sich natürlich mit
[Auto Groups](/de/identity/directory/auto-groups) kombinieren lassen: Jeder zulässige Wert kann
zu einer eigenen Gruppe werden, deren Mitgliedschaft automatisch berechnet wird.

## Kategorien

Attribute sind in **Kategorien** organisiert, die benannten Abschnitte, in die ein Profil
gegliedert ist, etwa „Employment“ oder „Contact“. Jede Kategorie hat einen Anzeigenamen,
ein Symbol und eine Position, die ihre Reihenfolge im Profil bestimmt. Die Gruppierung
zusammengehöriger Attribute hält lange Profile übersichtlich und erleichtert die Pflege des Schemas.

<Frame caption="Hinzufügen einer Kategorie.">
  <img src="https://mintcdn.com/iru/yv46VZ-WbN1GdStp/assets/media/images/schema-add-category.webp?fit=max&auto=format&n=yv46VZ-WbN1GdStp&q=85&s=7e0973bc1aa36406e83acf65a1f1c572" alt="Der Dialog Add Category mit den Feldern Display Name, Slug, Icon und Description." width="2000" height="1126" data-path="assets/media/images/schema-add-category.webp" />
</Frame>

## Wie Attribute verwendet werden

```mermaid theme={null}
flowchart LR
  attr["Profilattribut"]
  attr -->|"berechnet Mitgliedschaft für"| dyn["Auto Groups"]
  attr -->|"zugeordnet in"| apps["Anwendungsanmeldung<br/>(Assertions und Tokens)"]
  attr -->|"kann Bedingung sein in"| pol["Authentifizierungsrichtlinien"]
```

<CardGroup cols={2}>
  <Card title="Auto Groups steuern" icon="wand-magic-sparkles" href="/de/identity/directory/auto-groups">
    Kennzeichnen Sie ein Attribut, um **Auto Groups** zu steuern, und Iru macht aus seinen Werten
    Gruppen, deren Mitgliedschaft sich aktualisiert, wenn sich Profile ändern.
  </Card>

  <Card title="In Anwendungen zuordnen" icon="grip" href="/de/identity/applications/provisioning">
    Anwendungen ordnen Profilattribute der Assertion oder dem Token zu, die sie
    erhalten, sodass jede App die erwarteten Identitätsdaten bekommt.
  </Card>
</CardGroup>

<Tip>
  Entwerfen Sie das Schema, bevor Sie Benutzer in großem Umfang übernehmen. Wenn Sie vorab festlegen, welche
  Attribute erforderlich, eindeutig und mit fester Auswahl sind, verlaufen Importe und HR-Synchronisierungen
  reibungslos, und Ihre Auto Groups verhalten sich wie erwartet.
</Tip>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Auto Groups erstellen" icon="wand-magic-sparkles" href="/de/identity/directory/auto-groups">
    Machen Sie aus einem Attribut Gruppen, die sich selbst pflegen.
  </Card>

  <Card title="Benutzer verwalten" icon="user" href="/de/identity/directory/users">
    Sehen Sie Attribute in einzelnen Profilen in Aktion.
  </Card>
</CardGroup>
