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

# Rollen und Rollen-Bundles

> Übermitteln Sie in Iru Identity einer Anwendung eine Rolle auf Grundlage der Gruppenmitgliedschaft und steuern Sie Sitzungsdauer und Risiko pro Rolle mithilfe von Rollen-Bundles.

Viele Anwendungen müssen wissen, **welche Rolle** ein Benutzer hat (Administrator,
Mitglied, Betrachter usw.), nicht nur, wer er ist. Iru kann einer
Anwendung bei der Anmeldung eine Rolle übermitteln, die durch die Gruppenmitgliedschaft des Benutzers bestimmt wird, und
**Sitzungsdauer** und **Risiko** je nach Rolle variieren.

Sie konfigurieren dies auf der Registerkarte **Roles** einer Anwendung. Wie den Rest einer App
bearbeiten Sie dies in einem Entwurf und veröffentlichen ihn; siehe
[Übersicht über Anwendungen](/de/identity/applications/applications-overview).

## Wie eine Rolle die Anwendung erreicht

```mermaid theme={null}
flowchart LR
  group["Gruppenmitgliedschaft"] --> role["Rolle"]
  role -->|"Rollenkennung"| method["Rollenübermittlungsmethode"]
  method --> app["Anwendung"]
```

Eine **Rolle** wird einer oder mehreren [Gruppen](/de/identity/directory/groups) gewährt. Wenn
sich jemand aus diesen Gruppen anmeldet, übermittelt Iru die **Kennung** der Rolle an die
Anwendung, und zwar mit der von Ihnen gewählten Methode.

## Rollenübermittlungsmethode

Diese legt fest, wie (oder ob) die Rolle an die Anwendung gesendet wird.

| Methode | Funktion |
| - | - |
| **Keine** | Die Anwendung erhält über Single Sign-On keine Rolle. Rollen-Bundles sind deaktiviert. Auf der Registerkarte **Zuweisungen** kann Gruppen nur die Rolle **Default** zugewiesen werden. |
| **Gruppen** | Die Rollenkennung(en) werden als Werte in den Gruppen gesendet, die die Anwendung erhält. |
| **Custom attribute** | Die Rollenkennung(en) werden in einem von Ihnen benannten benutzerdefinierten Attribut oder Claim gesendet, als Einzelwert oder Array. Für SAML-Apps wählen Sie zusätzlich das Attributnamensformat. |

## Rollen-Bundles

Rollen befinden sich in **Rollen-Bundles**, die zusammengehörige Rollen gruppieren und festlegen, ob ein
Benutzer mehrere davon gleichzeitig innehaben kann.

| Bundle-Einstellung | Funktion |
| - | - |
| **Display name** | Der Name des Bundles im Dashboard. |
| **Bundle identifier** | Eine eindeutige Kennung, die nur zur Organisation zusammengehöriger Rollen dient. Sie wird **nicht** als Rollenwert an die Anwendung gesendet. |
| **Exclusivity mode** | **Include all** übermittelt jede Rolle im Bundle, für die der Benutzer infrage kommt. **Priority** übermittelt nur die eine Rolle mit der höchsten Priorität, sodass sich die Rollen gegenseitig ausschließen. |

Im Modus **Priority** trägt jede Rolle eine eindeutige **Prioritäts**nummer, und die
Rolle mit der besten Priorität gewinnt, wenn jemand für mehrere infrage kommt.

## Was eine Rolle enthält

<AccordionGroup>
  <Accordion title="Anzeigename und Kennung" icon="tag">
    Der Name der Rolle im Dashboard und die **Rollenkennung**, die an
    die Anwendung übermittelt wird (der Wert, den die App für diese Rolle erhält).
  </Accordion>

  <Accordion title="Gruppen" icon="users">
    Die [Gruppen](/de/identity/directory/groups), deren Mitglieder die Rolle erhalten.
    Wenn Rollen auf Gruppen basieren, folgt die Rollenzuweisung Ihrem Verzeichnis.
  </Accordion>

  <Accordion title="Sitzungsdauer" icon="clock">
    Wie lange eine über diese Rolle gewährte Sitzung dauert, in Minuten. Verschiedene
    Rollen können unterschiedliche Sitzungsdauern haben. Setzen Sie den Wert auf **0**, um auf
    den Anwendungsstandard zurückzugreifen (**60 Minuten**, sofern Sie ihn in der App nicht ändern).
  </Accordion>

  <Accordion title="Risikostufe" icon="gauge-high">
    Eine optionale Klassifizierung der [Risikostufe](/de/identity/authentication/risk-based-access)
    für die Rolle, damit Sie sensiblere Rollen einheitlich
    kennzeichnen können.
  </Accordion>
</AccordionGroup>

<Note>
  Jede Anwendung beginnt mit einem Bundle und einer Rolle **Default**, sodass der Zugriff sofort
  funktioniert. Fügen Sie Bundles und Rollen nur hinzu, wenn eine Anwendung rollenbasierten
  Zugriff benötigt.
</Note>

## Rollen für eine Anwendung konfigurieren

<Steps>
  <Step title="Rollenübermittlungsmethode wählen">
    Legen Sie auf der Registerkarte **Roles** der App fest, wie Rollen die Anwendung erreichen sollen:
    **Gruppen** oder **Custom attribute** oder **Keine**, wenn die App über Single Sign-On keine
    Rolle übernimmt.
  </Step>

  <Step title="Rollen-Bundle erstellen">
    Fügen Sie ein Bundle hinzu, geben Sie ihm einen Namen und eine Kennung und wählen Sie die Exklusivität **Include all** oder
    **Priority**.
  </Step>

  <Step title="Rollen hinzufügen">
    Legen Sie für jede Rolle die Kennung fest, weisen Sie die Gruppen zu, die sie erhalten sollen,
    und legen Sie die Sitzungsdauer und (optional) eine Risikostufe fest. Geben Sie in **Priority**-Bundles
    jeder Rolle eine Prioritätsnummer.
  </Step>

  <Step title="Veröffentlichen">
    Legen Sie den Entwurf als current fest. Ab dann übermittelt die Anmeldung die Rolle jedes Benutzers
    gemäß Ihren Bundles.
  </Step>
</Steps>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Zugriff zuweisen" icon="user-check" href="/de/identity/applications/assigning-access">
    Festlegen, wer die App überhaupt erreichen kann.
  </Card>

  <Card title="Gruppen" icon="users" href="/de/identity/directory/groups">
    Rollen werden Gruppen gewährt; organisieren Sie die Mitgliedschaft dort.
  </Card>

  <Card title="SAML-Anwendungen" icon="file-signature" href="/de/identity/applications/saml-applications">
    Wo das Namensformat des benutzerdefinierten Attributs für die SAML-Rollenübermittlung festgelegt wird.
  </Card>

  <Card title="OIDC-Anwendungen" icon="id-card" href="/de/identity/applications/oidc-applications">
    Wo Rollen bei OIDC-Apps als Claim mitgesendet werden.
  </Card>
</CardGroup>
