So fügst du neue Attribute in Okta hinzu

In diesem Artikel wird erläutert, wie du neue Attribute hinzufügst, wenn deine Miro-Okta-Kommunikation für SCIM und/oder SSO bereits erfolgreich konfiguriert ist.

So richtest du Okta SSO ein
So richtest du Okta SCIM ein
Leitfaden zur Okta-Lizenzbereitstellung für FLP (so erstellst du ein Lizenzattribut und weist es zu)
So richtest du ProfilePicture für den SSO-Flow ein (wenn SCIM deaktiviert ist)

Der einzige Wert, den Miro benötigt, ist userName, und das Attribut muss in Form einer E-Mail-Adresse vorliegen. Andere Attribute sind nicht erforderlich, aber einige werden von Miro akzeptiert, wenn sie vorhanden sind. Um die zusätzlichen Attribute dem Miro-Schema zuzuordnen, kannst du die Details in diesem Dokument verwenden und die folgenden Schritte ausführen.

⚠️ Da die Attribute auf Miro-App-Ebene mit den allgemeinen Attributen, die du in Okta hast, synchronisiert werden, müssen einige Attribute, die eventuell eindeutig für Miro sind (oder zumindest nicht bereits in deiner Instanz verwendet wurden), zuerst unter Verzeichnis > Profileeditor > Nutzer (Standard) erstellt werden, bevor du mit den folgenden Anweisungen fortfährst.

Attribute für SCIM erstellen

⚠️ Beachte, dass die Attribute auf Ebene der Miro-App erstellt werden müssen, nicht im Hauptprofileditor im Verzeichnis.

1. Geh zu Anwendungen > öffne Miro > Bereitstellung.
2. Geh in OKTA zu Verzeichnis > Profileditor > scrolle nach unten und klicke auf Zum Profileditor > klicke auf Attribut hinzufügen.
   
   Der Abschnitt „Profileditor“ der Miro-App
   
3. Sieh dir die Liste der unterstützten Attribute an und kopiere Miro attribute namespace (die zweite Spalte) des Attributs, das du hinzufügen möchtest. Füge den kopierten Wert in das Feld External namespace ein.
4. Kopiere das jeweilige Miro attribute und füge es in das Variable name-Feld ein. Okta fügt es automatisch auch zum External name hinzu. Entferne dann das Periodenzeichen aus dem Variable name-Feld, wenn es vorhanden ist.
5. Gib den Attributnamen deiner Wahl in das Display name-Feld ein (wir empfehlen, die vorgeschlagenen Werte aus der Spalte IDP attribute name in unserer Dokumentation zu verwenden).
6. Markiere das User personal-Kästchen am unteren Rand des Dialogfelds.

⚠️ Bei komplexen Attributen wie der Benutzerrolle (roles) und dem Profilbild (photos) solltest du den automatisch ausgefüllten External name nicht behalten. Setze den External name auf den Okta-Ausdruck aus der SCIM-Attributtabelle (zum Beispiel roles.^[primary==true].value). Verwende nicht den SCIM-PATCH-Filterpfad (roles[primary eq true].value) — Okta kann .value entfernen und ungültiges JSON senden.

Dann sollte das ausgefüllte Formular etwa so aussehen:

Das Attribut „Manager Name“ in OKTA hinzufügen

Beispiel: Unternehmens-Admin (roles)

Verwende diese Werte, wenn du das Attribut für Unternehmens-Admin / Nutzerrolle hinzufügst:

• Anzeigename: Unternehmens-Admin
• Variablenname: miro_company_admin
• Externer Name: roles.^[primary==true].value
• Externer Namespace: urn:ietf:params:scim:schemas:core:2.0:User
• Attributtyp: Persönlich (wähle das Kästchen User personal aus)

Unterstützte Rollenwerte: ORGANIZATION_INTERNAL_ADMIN, ORGANIZATION_INTERNAL_USER.

Klicke auf Speichern. Sieh nach, ob das neue Attribut in der Liste auf derselben Seite erscheint. Jetzt ist dein Attribut erstellt, wird aber mit nichts synchronisiert und ist leer.

Zuordnungen einrichten

Dein neues Attribut ist nicht zugeordnet und wird standardmäßig in der Liste der Attribute auf dem Tab Bereitstellung der Miro-App versteckt. Klicke auf Nicht zugeordnete Attribute anzeigen > Bearbeiten, um dein Attribut zu ändern:

• Attributwert: Wähle einen Typ = Map from Okta Profile, ATTRIBUTE_NAME | string
• Wähle Erstellen und aktualisieren:

Klicke zum Speichern. Jetzt wird dein Attribut in der Liste als Mapped (zugeordnet) angezeigt, aber dieses Mapping synchronisiert die Daten auf der Okta-Seite (Okta weiß jetzt, woher es den Wert für das Attribut holen soll). Jetzt musst du die Daten zwischen Miro und Okta synchronisieren.

Klicke auf die Schaltfläche Mappings auf derselben Seite:

Der Abschnitt „Profileditor“ in der Miro-App

Klicke auf den Abschnitt Okta User to Miro. Auf der rechten Seite siehst du das Attribut. Wähle auf der linken Seite das Okta-Attribut, das du synchronisieren möchtest, und lege die Verbindung auf Apply mapping on user create and update. fest.

Mapping des Attributs „Manager Name“ zu Miro

Danach wird das Attribut für alle neuen und bestehenden Nutzer an Miro gesendet.

Klicke auf Mappings speichern und dann auf Updates jetzt anwenden.

Fertig!

⚠️ Beachte, dass Attributdaten nur für Nutzer angezeigt werden, die einen Attributwert in ihrem Profil haben. 
Um das Attribut auf Gruppenebene zuzuweisen, folge den Anweisungen hier ab p.2.3 (der Leitfaden wurde für die Lizenzzuweisung erstellt, kann aber für jedes Attribut verwendet werden).

Die neuen Attribute werden sofort in Miro angezeigt (sobald sie von Okta gesendet werden). Die Attribute werden in den Miro-Einstellungen für Admins am unteren Rand der Informationskarte des Nutzers angezeigt.

Informationskarte des Nutzers

Profilbild-Attribut für SSO erstellen

So richtest du ProfilePicture für den SSO-Flow-Leitfaden ein (wenn SCIM deaktiviert ist)

Wenn du SCIM aktivierst, empfehlen wir, diesen Teil zu überspringen und das Profilbild-Attribut auf standardmäßige Weise zu konfigurieren. Dieser Teil kann als Workaround verwendet werden, wenn du nur SSO verwendest.

Das Profilbild-Attribut kann im Gegensatz zu anderen auch während der SSO-Authentifizierung übertragen werden – wenn du es in deinen Miro-SSO-Einstellungen aktivierst – nicht während SCIM-Pushes. Aus diesem Grund kann sein Erstellungsablauf abweichen, und trotz des Hinweises am Anfang dieses Artikels sollte es in diesem Fall im Haupt Profil-Editor erstellt werden.

1. Gehe zu Verzeichnis > Profileditor > Attribut hinzufügen
2. Lege den Anzeigenamen als „Profilbild“ fest
3. Lege den Variablen-Namen als „profilePhotoUrl“ fest
   
   Das Ergebnis sollte Folgendes sein:Hinzufügen des Profilbild-Attributs im Haupt-Profileditor von Okta
4. Klicke auf Speichern und fülle dann das benutzerdefinierte Attribut Profilbild für jeden Nutzer in Okta (im Nutzerprofil) mit der Bild-URL als Wert aus.

⚠️ Okta unterstützt derzeit keine native Speicherung von Bildern in seiner Plattform. Die Bilder müssen auf einem Server eines Drittanbieters gehostet werden, der über eine URL öffentlich zugänglich ist.
Es gibt keine Größenbeschränkung für Bilder; solche, die größer als 400 x 400 px sind, können jedoch nach erneuter Authentifizierung des Nutzers länger zum Laden brauchen.

✏️ Alternativ kannst du das Attribut über die Okta-API ausfüllen oder aktualisieren.

Profilbild-Attribut aktivieren

Aktiviere schließlich das Attribut im Abschnitt Sign On der Miro-App.

1. Geh zu Anwendungen > wähle deine Miro-App aus > Anmelden Tab > klicke, um zu bearbeiten
   
   Abschnitt „Anmelden“ in der Miro-App**
   
2. Klicke auf den Pfeil neben Attribute (optional) und füge die folgenden Werte hinzu:
   
   • Name: "ProfilePicture"
     
   • Wert: "user.ProfilePhotoUrl"
     Dein Ergebnis sollte so aussehen: 
     
     Aktivierung des Profilbild-Attributs im Abschnitt „Anmelden“ der Miro-App
3. Überprüfe, ob die Attributbezeichnungen überall identisch sind (wir empfehlen, alle Werte aus unseren Anweisungen zu kopieren), ansonsten kann Okta womöglich nicht synchronisieren.
4. Scrolle nach unten und klicke auf Speichern.

Das Profilbild wird nach der erfolgreichen Authentifizierung eines neuen Nutzers mit Single Sign-on (SSO) bei Miro angezeigt.