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

# Attribute Mapping

Das Attribute Mapping ist nur in Kombination mit einem aktiven Single-Sign-On (SSO) möglich. Nach der Aktivierung des SSO können gewünschte Attribute/ Gruppe über die SSO Anwendung (z.B. Entra ID, Shibboleth, SAML2) freigegeben werden. Bei der Anmeldung des User erhalten wir dann zusätzlich zum Namen und Mailadresse noch die Angabe zum Attribute.

Beispiele: Attribute: Department 01, Gruppe: IT-DEV, Status: Student / Staff

Teste, welche Attribute und Gruppen über deine SSO Anmeldung mitgegeben werden, dies kannst du unter [*SSO & Sicherheit*](https://app.anny.co/organization/settings/sso?o=) im Abschnitt Attribute Mapping über den Button **Meine Attribute** einsehen.

# Was ist Attribute Mapping?

Durch das Attribute Mapping kannst du Benutzer-Eigenschaften aus deinem IDP (Usermanagement) zu anny Communities zuweisen. So können Mitglieder automatisch (Auto-Join) in die jeweiligen internen Buchungsbereiche (Communities) zugeordnet werden. Außerdem kannst du Profildaten wie Firma oder Abteilung und deine [eigenen Kundendaten](#eigene-kundendaten-befüllen) automatisch aus dem IDP befüllen.

**Wo nehme ich die Einstellung vor?**

1. Öffne hierzu im linken Menü **Account** > **Einstellungen**
2. Wähle den Punkt ***SSO & Sicherheit*** aus
3. Scroll runter zu ***Attribute Mapping***
4. Klicke auf ***Attribut zuordnen***

Du kannst diese Attribute zuordnen, am meisten wird die Zuordnung zur Community verwendet:

* Communities
* Rollen
* Profilbild
* Sprache
* Anmeldung erlaubt
* Identifikator
* Email
* Nachname
* Vorname
* Anzeigename
* Firma
* Titel
* Berufsbezeichnung
* Abteilung
* deine Felder unter **Eigene Kundendaten**, z.B. **Eigene Kundendaten: Personalnummer**

![Attribute Mapping Übersicht](https://downloads.intercomcdn.eu/i/o/niegcmk9/65658098/5da1ec4e09d062591f7cb8487671/SCR-20250919-kgsx.png?expires=1784813400\&signature=bda10c40857823648185294eef4fff9d7c3d6770d5c41df7aa158cbe9dc5bd93\&req=1tBpwFD6pT9k2hL085ZhoafkGK8xoK5aheyceWhdHfmXcFwmEqmYml5LFQ0t%0A9Ls3q8AIZTAfySfH%0A)

## Regel erstellen

1. Klicke auf **Attribut zuordnen** und wähle im Feld Attribute Mapping **Communities** aus
2. Klicke auf **Regel hinzufügen**, um eine neue Regel zu erstellen
3. Trage in die Bedingung den Wert der Gruppe oder des Attributes ein und lege die Community fest, zu welche die User hinzugefügt werden sollen Beispiel M365 Entra ID-Gruppen: Wenn [http://schemas.microsoft.com/......../identity/claims/\*\*groups](http://schemas.microsoft.com/......../identity/claims/**groups)\*\* enthält (Array): **gruppe\_dev** Dann anny Community **Dev Team Office** Beispiel Shibboleth: Wenn: **urn:oid:xxxx** enthält (Array): **Student** Dann anny Community **Studierende Wave University**
4. Klicke auf **Anwenden** und speichere deine Eingaben mit **Speichern**

> [!WARNING]
>
> Die Eingabe der Werte für Gruppen Bezeichnungen und Wert ist case sensitiv und muss exakt der Schreibweise entsprechen, die von dem IDP übergeben wird. Die genaue Schreibweise kann unter **Meine Attribute** eingesehen werden.

Gibt es **mehrere Werte,** die zu einer bestimmten Personengruppe gehören? Das **System durchläuft alle Regeln**. Immer wenn eine Regel zutrifft, wird dieser Wert übernommen.

> **Beispiel Unternehmen**
>
> Eine Person gehört einer Abteilung (z.B. Sales) innerhalb eines Unternehmens an. Sie soll daher als Nutzer:in bei anny automatisch in die Community "Sales and Marketing", "Retail" und auch "Company" hinzugefügt werden.

> **Beispiel Universität**
>
> Eine Person gehört einem bestimmten Studiengang (z.B. Lehramt Philosophie) innerhalb einer Hochschule an. Sie soll daher als Nutzer:in bei anny automatisch in die Community "Lehramt Philosophie", aber auch in die Community "Philosophische Fakultät" und "Hochschule Teststadt" hinzugefügt werden.

![Regel Beispiel](https://downloads.intercomcdn.eu/i/o/3054005/1505363c191d0ba34aa62888/liad.png?expires=1784813400\&signature=67b7d817bb64f8eebf3f79cb5d3e226c9f6716b70d10f63f2d6e6c585dccebfb\&req=09VqwVj6qXsp0xr0v9tnrjNBr9YDj3Tb67qpq5K8j70YxWtDzrNqnOLT4MUQ%0ANPiFP5VwiedljlI%3D%0A)

## Alle User deines Unternehmens (SSO) hinzufügen

Erstelle eine neue Regel zum Community Mapping und lösche als nächstes die Bedingung. Wähle die gewünschte Community aus, zu der alle User deines Unternehmens zugeordnet werden sollen.

![Alle User hinzufügen](https://downloads.intercomcdn.eu/i/o/11354975/5af9cdb4276c591a47318f1c/chrome-capture-2024-2-11.gif?expires=1784813400\&signature=df2e8335119fd072dbe1604fe3b2d1713b2886a6037b3bad5be7b35e952652e2\&req=0dRswFzzqzJk2hL085ZhoavwFlgBjEn3V0Q2IPnm90a7GWUkeWQm%2FN2j55OH%0AlQi%2FOTVepD9CHI%2BL%0A)

Nun werden alle User deines SSO ohne Filter zu der gewünschten Community hinzugefügt.

## Eigene Kundendaten befüllen

Mit dem Attribute Mapping kannst du auch die Felder deiner **Eigenen Kundendaten** aus dem IDP befüllen, z.B. eine Personalnummer, eine Kostenstelle oder einen Standort.

Voraussetzung: Das Feld ist in den [Account-Einstellungen](https://docs.anny.co/account-settings.md) unter **Datenfelder** → **Eigene Kundendaten** angelegt.

**1. Feld auswählen**

Klicke unter ***Attribute Mapping*** auf ***Attribut zuordnen*** und wähle **Eigene Kundendaten: *Feldname***.

**2. Regel festlegen**

Die Regel liest standardmäßig ein **Attribut** aus. Trage den Namen ein, unter dem dein IDP den Wert überträgt, z.B. `employeeNumber`. Wie bei den Communities kannst du Bedingungen ergänzen oder mit **Explizit** einen festen Wert setzen.

**3. Übernehmen**

Klicke auf ***Anwenden*** und danach auf ***Speichern***.

Bei jeder Anmeldung über SSO überträgt anny den Wert in die Kundendaten des Users in deiner Organisation. Du siehst ihn im Kundenprofil. Ist der User noch kein Kunde deiner Organisation, wird der Wert beim ersten Checkout vorausgefüllt. Wenn du ein Mapping speicherst, wendet anny es auch auf bereits bekannte SSO-User an, mit den Attributen ihrer letzten Anmeldung.

* **Leere Werte** überschreiben keine vorhandenen Daten. Liefert der IDP nichts, bleibt der bisherige Wert stehen.
* **Auswahlfelder:** Der Wert muss genau einer Option des Feldes entsprechen. Weicht die Schreibweise im IDP ab, setze den passenden Wert mit einer Bedingung und **Explizit**.
* **Mehrfachauswahl:** Liefert der IDP mehrere Werte (z.B. Gruppen), werden alle übernommen.
* Felder vom Typ **Datei hochladen** stehen nicht zur Auswahl, weil ein IDP keine Dateien überträgt.
* Benennst du ein Feld um, bleibt das Mapping bestehen. Löschst du ein Feld, erscheint das Mapping als **Gelöschtes Kundendatenfeld**. Entferne es dann.

## Technische Daten der Zuordnung

| Begriff | Erklärung | Beispiel |
| - | - | - |
| Ist gleich | Eine exakte Übereinstimmung von Werten zwischen zwei Elementen oder Attributen. | Wenn der Name "John" genau mit "John" übereinstimmt. |
| Ist nicht gleich | Die Werte zweier Elemente oder Attribute sind nicht identisch. | |
| Ist leer | Ein bestimmtes Attribut oder eine Gruppe hat keinen zugewiesenen oder vorhandenen Wert. | Wenn das Attribut "Team" keinen Wert hat. |
| Ist nicht leer | Ein bestimmtes Attribut oder eine Gruppe hat einen zugewiesenen oder vorhandenen Wert. | |
| Enthält (String) | Eine bestimmte Zeichenfolge (String) ist in einem größeren Textfeld oder einer größeren Zeichenkette vorhanden. | Wenn das Wort "Sales" in "Marketing Operations and Sales Team Analytics" enthalten ist. |
| Enthält nicht (String) | Eine bestimmte Zeichenfolge (String) ist nicht in einem größeren Textfeld oder einer größeren Zeichenkette vorhanden. | |
| Enthält (Array) | Ein spezifisches Element oder ein spezifischer Wert ist in einem Array (einer geordneten Gruppe oder Liste von Werten) vorhanden. | Wenn die Nummer "3" in dem Array \[1,2,3,4,5] enthalten ist. |
| Enthält nicht (Array) | Ein spezifisches Element oder ein spezifischer Wert ist nicht in einem Array (einer geordneten Gruppe oder Liste von Werten) vorhanden. | |

> [!TIP]
>
> **Pro Tipp:** Wenn es Nutzer gibt, die mehreren Gruppen in M365 angehören, handelt es sich bei dem ***Attribut*** ***Gruppe*** um ein ***Array,*** das bedeutet, dass der Operator "***enthält (Array)***" anstelle von "***ist gleich"*** verwendet werden soll.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.