> ## 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.

# Anwendungszuordnung

> Gestalten Sie die Identitätsaussage, die eine Anwendung erhält (die SAML-Assertion oder das OIDC-Token), indem Sie Profilattribute mit IQL darin abbilden.

Wenn sich jemand über Iru bei einer Anwendung anmeldet, erhält die App eine signierte
**Identitätsaussage** (eine **SAML-Assertion** oder ein **OIDC-ID-Token**), die angibt,
wer die Person ist. Mit der **Anwendungszuordnung** legen Sie fest, was in diese
Aussage aufgenommen wird: Für jedes Feld, das die App erwartet, ordnen Sie einen Wert aus dem
[Profil](/de/identity/directory/schema) des Benutzers zu.

<Info>
  Jeder zugeordnete Wert wird in
  **[IQL](/de/identity/getting-started/iql-expressions)** (Iru Query Language) geschrieben,
  derselben Ausdruckssprache, die für die
  [Attributzuordnung von Directory Sync](/de/identity/directory/attribute-mapping) und
  Regeln für [Auto Group](/de/identity/directory/auto-groups) verwendet wird. Ein Wert kann ein einzelnes
  Profilfeld (`user.email`) oder ein Ausdruck sein, der eines umformt
  (`user.email.lowerAscii()`).
</Info>

<Frame caption="Der Zuordnungseditor: Ein IQL-Ausdruck legt das Subject und jedes Attribut fest, mit dem IQL-Explorer für die verfügbaren Felder und Funktionen.">
  <img src="https://mintcdn.com/iru/Pd7a0-sHKi0jGjE6/assets/media/images/application-mapping.webp?fit=max&auto=format&n=Pd7a0-sHKi0jGjE6&q=85&s=deb4226eee66af9bb5dbd89dcbbd1342" alt="Der Zuordnungseditor einer SAML-App: das Subject, zugeordnet aus dem IQL-Ausdruck user.id mit dem Namensformat Unspecified, und ein Email-Attribut, zugeordnet aus user.primaryEmail.email mit dem Namensformat Basic." width="1130" height="1136" data-path="assets/media/images/application-mapping.webp" />
</Frame>

## Was eine Zuordnung enthält

Jede Anwendung ordnet zwei Dinge in die gesendete Aussage ein:

* **Das Subject:** die primäre Kennung des angemeldeten Benutzers.
* **Attribute oder Claims:** alle zusätzlichen Felder, die die App erwartet.

```mermaid theme={null}
flowchart LR
  profile["Benutzerprofil<br/>Attribute"] --> expr["IQL-Ausdruck"]
  expr --> subject["Subject"]
  expr --> attrs["Attribute / Claims"]
  subject --> stmt["Signierte Assertion / Token"]
  attrs --> stmt
  stmt --> app["Ihre Anwendung"]
```

### Das Subject

Das Subject identifiziert den angemeldeten Benutzer. Der Standardwert hängt vom Protokoll ab:

| Protokoll | Subject | Standardwert |
| - | - | - |
| **SAML** | Die **NameID** | `user.username` |
| **OIDC** | Der Claim **`sub`** | `user.id` |

Sie können den Wert ändern, aus dem es gebildet wird, und für SAML ein **NameID-Format** wählen.
Die protokollspezifischen Optionen finden Sie unter [SAML-Anwendungen](/de/identity/applications/saml-applications) und
[OIDC-Anwendungen](/de/identity/applications/oidc-applications).

### Attribute und Claims

Fügen Sie über das Subject hinaus jedes Feld hinzu, das die App benötigt. Für jedes legen Sie
den **Namen** (was die App erwartet), den **Wert** (den IQL-Ausdruck, der ihn erzeugt),
ein Protokolldetail (ein **Attributnamensformat** für SAML oder einen **Scope** für
OIDC) und fest, ob es **aktiviert** ist.

## So erstellen Sie eine Zuordnung

<Steps>
  <Step title="Zuordnung der App öffnen">
    Die Zuordnung befindet sich im **Entwurf** der Anwendung, neben ihren Protokolleinstellungen.
  </Step>

  <Step title="Pro Feld einen IQL-Ausdruck schreiben">
    Schreiben Sie für das Subject und jedes Attribut bzw. jeden Claim einen
    [IQL](/de/identity/getting-started/iql-expressions)-Ausdruck. Der Editor
    schlägt beim Tippen die verfügbaren `user`-Felder und Funktionen vor und prüft den
    Ausdruck, sodass Fehler vor der Veröffentlichung sichtbar werden.
  </Step>

  <Step title="Ergebnis in der Vorschau anzeigen">
    Eine Live-**Vorschau** zeigt genau die Assertion bzw. das Token, das Iru senden wird, sodass Sie
    die Struktur vor dem Livegang bestätigen können.
  </Step>

  <Step title="Veröffentlichen">
    Legen Sie den Entwurf als **current** fest, um die Zuordnung live zu schalten. Das Versionsmodell
    finden Sie unter [Übersicht über Anwendungen](/de/identity/applications/applications-overview).
  </Step>
</Steps>

<Tip>
  Ordnen Sie nur zu, was die App benötigt. Jede App erhält genau die Attribute, die Sie
  ihr zuordnen, sodass ein bestimmter Dienst nur die Profildetails sieht, die zur Identifizierung
  des Benutzers erforderlich sind.
</Tip>

## Zuordnung für die Bereitstellung

Die Zuordnung betrifft mehr als die Anmeldung. Für Apps mit
[Bereitstellung](/de/identity/applications/provisioning) hat die Zuordnung außerdem eine
**Bereitstellungsansicht**, die steuert, welche Profilattribute Iru sendet, wenn es
das Konto in der App erstellt oder aktualisiert.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Iru-Abfragesprache" icon="brackets-curly" href="/de/identity/getting-started/iql-expressions">
    Die vollständige IQL-Referenz: Felder, Operatoren, Funktionen und Beispiele.
  </Card>

  <Card title="SAML-Anwendungen" icon="file-signature" href="/de/identity/applications/saml-applications">
    NameID-Formate und Attributzuordnung für SAML-Apps.
  </Card>

  <Card title="OIDC-Anwendungen" icon="id-card" href="/de/identity/applications/oidc-applications">
    Subject- und Claim-Zuordnung für OIDC-Apps.
  </Card>

  <Card title="Bereitstellung" icon="arrows-rotate" href="/de/identity/applications/provisioning">
    Ordnen Sie die Attribute zu, die Iru beim Erstellen und Aktualisieren von Konten in einer App sendet.
  </Card>
</CardGroup>
