SAML SSO Okta: Benutzer- & Gruppenbereitstellung
Kurz gesagt
Richten Sie die SCIM-Bereitstellung ein, um Wrike-Benutzer und ‑Gruppen automatisch aus Okta zu erstellen, zu aktualisieren und zu deaktivieren. Fügen Sie zugelassene Domains hinzu, holen Sie Ihre Wrike-SCIM-URL und Ihr OAuth-Token, aktivieren Sie die API-Integration in Okta und konfigurieren Sie anschließend Attributzuordnungen, benutzerdefinierte Felder und Group Push. Hinweis: Aktivieren Sie „Import Groups“ nicht; über SCIM bereitgestellte Mitglieder sind sofort kostenpflichtig.
| Availability: Legacy Enterprise.; Unavailability: Legacy Free, Legacy Professional, Legacy Business.; |
| Availability: Pinnacle, Apex. ; Unavailability: Free, Team, Business; |
Mit dem SCIM-Protokoll können Administratoren die automatische Benutzer- und Gruppenbereitstellung sowie -aufhebung für Wrike mit Okta einrichten.
Richten Sie Wrike mit dem System for Cross-domain Identity Management (SCIM) ein, um Benutzer automatisch zu provisionieren oder zu deprovisionieren, unterstützte Benutzerattribute zu synchronisieren, Benutzergruppen bereitzustellen und Gruppenmitgliedschaftsänderungen basierend auf ihrem Status in Okta zu verwalten.
Wrike unterstützt derzeit die folgenden SCIM-Bereitstellungsfunktionen mit Okta:
- Automatische Bereitstellung: Okta-Benutzer werden automatisch für Wrike bereitgestellt.
- Synchronisierte Benutzerattribute: Unterstützte Benutzerattribute werden automatisch in Wrike aktualisiert, wenn sie in Okta aktualisiert werden.
- Bereitstellung benutzerdefinierter Benutzerattribute: Unterstützte benutzerdefinierte Benutzerattribute können von Okta auf Wrike-Benutzerdefinierte Felder abgebildet werden.
- Automatische Deaktivierung: Wrike-Benutzer werden automatisch in Wrike deaktiviert, wenn sie in Okta deaktiviert werden.
- Gruppenbereitstellung: Okta-Gruppen können als Wrike-Benutzergruppen bereitgestellt werden, einschließlich Aktualisierung der Mitgliedschaften.
Anmerkung
Um Benutzerattribute von Kontoadministratoren erfolgreich zu aktualisieren, muss der Kontoadministrator, der das API-Token ausgegeben hat, das Recht zum Gewähren/Entziehen von Admin-Rechten aktiviert haben.
Wrike unterstützt die folgende Okta-Bereitstellungsfunktion nicht:
- Gruppen importieren
Anmerkung
Aktivieren Sie beim Konfigurieren der Wrike-Anwendung in Okta nicht das Kontrollkästchen „Import Groups“.
Diese Seite behandelt die Integration von Wrike mit Okta SCIM. Wir haben eine separate Seite zum Einrichten von SAML SSO für Wrike über Okta.
Anmerkung
Über SCIM hinzugefügte Mitglieder sind sofort kostenpflichtig.
Sie müssen in Wrike über die Berechtigung verfügen, Erweiterte Sicherheitseinstellungen zu konfigurieren, und Okta-Admin sein, um Wrike mit Okta SCIM einzurichten. Wir empfehlen, zuerst SAML SSO mit Okta einzurichten.
Nur Benutzer aus zugelassenen Domains werden automatisch in Wrike bereitgestellt.
- Öffnen Sie Ihren Wrike Workspace.
- Klicken Sie auf Ihr Profilbild in der rechten oberen Ecke der Ansicht.
- Wählen Sie Apps & Integrationen.
- Suchen Sie in der Liste der Apps nach Okta (stellen Sie sicher, dass Sie Identity management and single sign-on via Okta und nicht Okta via Wrike Integrate auswählen), klicken Sie auf die App und wechseln Sie zum SCIM-Tab.
- Scrollen Sie nach unten und kopieren Sie die SCIM-URL. Sie werden sie in einigen Schritten verwenden.
- Schließen Sie das Okta-Popup (bleiben Sie jedoch in Wrike) und fahren Sie mit Schritt 3 fort.
- Klicken Sie auf der Seite Apps & Integrationen links auf API.
- Geben Sie im Feld App-Name einen Namen ein (wir empfehlen Okta SCIM).
- Klicken Sie auf Neu erstellen.
- (Optional) Eine App-Beschreibung hinzufügen.
- Scrollen Sie an das Seitenende und klicken Sie auf Token erstellen.
- Geben Sie Ihr Passwort ein und klicken Sie auf Token abrufen.
-
Kopieren Sie das Token und speichern Sie es an einem sicheren Ort. Sie müssen diese Informationen in Okta eingeben.
Wichtig
Ihr Token wird nur einmal angezeigt. Stellen Sie daher sicher, dass Sie es speichern, bevor Sie zu den nächsten Schritten übergehen.
- Auf Speichern klicken.
- Melden Sie sich bei Ihrer Okta-Domain unter <yourorganization>.okta.com an.
- Klicken Sie auf Admin.
- Klicken Sie auf Applications.
- Suchen Sie Wrike und wählen Sie es aus.
- Wechseln Sie zum Tab Provisioning.
- Wählen Sie im linken Panel Integration.
- Klicken Sie rechts neben der Bezeichnung Integration auf Edit.
- Aktivieren Sie das Kontrollkästchen neben Enable API integration.
-
Informationen hinzufügen:
- Fügen Sie im Feld Base URL die URL aus Schritt 2 ein.
- Fügen Sie im Feld API Token das Token aus Schritt 3 ein.
- Klicken Sie auf Test API Credentials, um zu überprüfen, dass der Zugriff funktioniert.
- Auf Speichern klicken.
- Wählen Sie im linken Panel To app.
- Klicken Sie rechts neben der Bezeichnung Provisioning to app auf Edit.
- Aktivieren Sie alle oder einige der Synchronisierungen: Create Users, Update User Attributes und Deactivate Users.
- Auf Speichern klicken.
- Wechseln Sie zum Tab Assignments.
- Aktivieren Sie Wrike für ausgewählte Personen oder Gruppen oder für alle Benutzer.
Die folgenden Attribute werden von Okta zu Wrike synchronisiert:
- Benutzername
- Vorname
- Nachname
-
Primäre E-Mail-Adresse
Anmerkung
Die primäre E-Mail-Adresse in Wrike wird nicht geändert, wenn dieses Attribut aus Okta synchronisiert wird.
- Titel
- Primäre Telefonnummer
- Organisation
- Abteilung
- Wrike-Nutzer-Typ
Anmerkung
Die Angabe des Wrike-Nutzer-Typs (Regular Users, External Users, Collaborators, Contributors oder Viewers) ist ein benutzerdefiniertes Attribut. Standardmäßig werden Regular Users erstellt.
Wenn bestimmte Benutzerattribute (z. B. Telefonnummer, Abteilung oder sekundäre E-Mails) in Wrike ausgefüllt sind, aber in Okta fehlen, bleiben diese Informationen in Wrike erhalten, selbst nach der Benutzerbereitstellung.
Wenn ein Benutzer nicht bereitgestellt oder aufgehoben wird:
-
Überprüfen Sie das System Log im Okta-Verwaltungsportal, um zu sehen, ob dort ein SCIM-Bereitstellungsversuch aufgeführt ist.
- Wenn kein Bereitstellungsversuch angezeigt wird, stellen Sie sicher, dass die Benutzer der Wrike-Anwendung in Okta korrekt zugewiesen sind.
- Wenn ein Fehler aufgeführt ist, kontaktieren Sie bitte unser Support-Team und geben Sie die Fehlerinformationen an.
Schritt 1: Benutzerdefiniertes Nutzerfeld in Wrike erstellen
- Gehen Sie zu:https://www.wrike.com/accounts.htm#account/groups
- Klicken Sie auf +, um ein neues benutzerdefiniertes Nutzerfeld zu erstellen.
- Speichern Sie das Feld.
Schritt 2: ID des benutzerdefinierten Felds abrufen
Wrike Public API aufrufen:
curl --location --globoff \ 'https://www.wrike.com/api/v4/customfields?applicableEntityTypes=[User]' \ --header 'Authorization: Bearer YOUR_TOKEN'
Beispiel einer Antwort:
{
"data": [
{
"id": "IEAGWMBBJUAK4G7J",
"title": "Completed Induction"
...
}
]
}
Hinweis:
- id
- titel
Titel normalisieren:
- Leerzeichen durch _ ersetzen
- Sonderzeichen entfernen
- Melden Sie sich in der Okta-Admin-Konsole an.
- Navigieren Sie zu: Applications → Applications
- Wählen Sie die Wrike-Anwendung aus.
- Gehen Sie zum Tab Provisioning.
- Klicken Sie unter To App auf Go to Profile Editor.
- Klicken Sie im Abschnitt Attributes auf Add Attribute.
-
Attribut konfigurieren:
- Anzeigename: Completed Induction
- Variablenname: IEAGWMBBJUAK4G7J_Completed_Induction
- Externer Name: urn:ietf:params:scim:schemas:extension:wrike:2.0:User:IEAGWMBBJUAK4G7J_Completed_Induction
- Datentyp: String (oder Wrike-Feldtyp entsprechend)
- Klicken Sie auf Speichern.
Okta erfordert, dass benutzerdefinierte SCIM-Attribute manuell im Anwendungsprofil hinzugefügt werden, bevor sie zugeordnet und bereitgestellt werden können. (developer.okta.com)
- Navigieren Sie zu: Applications → Wrike → Provisioning
- Wählen Sie den Tab To App.
- Scrollen Sie zu Attribute Mappings → Okta to Wrike
- Klicken Sie neben dem Attribut auf Edit.
-
Zuordnung konfigurieren:
-
Mappen vom Okta-Profil: Wählen Sie das Okta-Attribut, das dieses Feld ausfüllen soll.
- Beispiel: user.employeeType
- Zielattribut: urn:ietf:params:scim:schemas:extension:wrike:2.0:User:IEAGWMBBJUAK4G7J_Completed_Induction
-
- Klicken Sie auf Save Mappings.
Attributzuordnungen bestimmen, welche Benutzerprofilattribute während der Bereitstellung ausgetauscht werden. (help.okta.com)
Okta stellt Gruppen mittels Group Push bereit, wodurch Gruppen zwischen Okta und der Zielanwendung erstellt und synchronisiert werden.
Group Push konfigurieren
- Navigieren Sie zu: Applications → Wrike
- Wählen Sie den Tab Push Groups.
- Klicken Sie auf Push Groups.
-
Wählen Sie eine der folgenden Optionen:
- Gruppen nach Name pushen
- Gruppen nach Regel pushen
- Wählen Sie die Okta-Gruppen aus, die bereitgestellt werden sollen.
- Auf Speichern klicken.
Verhalten der Gruppensynchronisierung
Nach der Konfiguration synchronisiert Okta Gruppen und Mitgliedschaften automatisch.
Typisches Verhalten:
| Aktion in Okta | Ergebnis in Wrike |
| Gruppe gepusht | Gruppe in Wrike erstellt |
| Benutzer zur Gruppe hinzugefügt | Mitgliedschaft hinzugefügt |
| Benutzer aus Gruppe entfernt | Mitgliedschaft entfernt |
| Gruppe getrennt | Gruppe entfernt oder deaktiviert |
Die Bereitstellung wird automatisch im nächsten Bereitstellungszyklus ausgeführt.