Voraussetzungen & Einrichtung
Voraussetzungen & Einrichtung
Bevor Sie Ihren Identitätsanbieter konfigurieren, erfüllen Sie die folgenden Voraussetzungen. Ihr Deque-Ansprechpartner kann Ihnen bei der Bereitstellung des SCIM-Abonnements und der Generierung Ihres API-Schlüssels helfen.
Voraussetzungen
SCIM-Abonnement
Ihr axe Account Unternehmen muss über ein aktives SCIM-Abonnement verfügen. Ohne dieses geben SCIM-Anfragen zurück:
402 "Subscription required"Kontaktieren Sie Ihren Deque-Ansprechpartner, um das SCIM-Abonnement zu Ihrem Unternehmen hinzuzufügen.
SCIM arbeitet neben der Einmalanmeldung. Wenn SCIM einen neu-Benutzer bereitstellt, wird das Konto mit dem Identitätsanbieter Ihrer Organisation verknüpft, sodass sich der Benutzer anmelden kann.
Generierung eines SCIM-API-Schlüssels
Ihr Identitätsanbieter authentifiziert sich bei axe mit einem SCIM-API-Schlüssel, der auf Ihr Unternehmen beschränkt ist.
- Melden Sie sich als Administrator beim axe Account Portal an.
- Navigieren Sie zu Einstellungen > API-Schlüssel verwalten.
- Generieren Sie einen SCIM-API-Schlüssel.
- Kopieren Sie den Schlüssel und speichern Sie ihn sicher — Sie werden ihn in den SCIM-Connector Ihres Identitätsanbieters eingeben.
Behandeln Sie den API-Schlüssel wie ein Passwort. Teilen Sie ihn nur über einen sicheren Kanal (zum Beispiel den Secrets Manager Ihrer Organisation), niemals in einer einfachen E-Mail oder im Chat. Wenn ein Schlüssel offengelegt wird, widerrufen Sie ihn und generieren Sie einen neuen.
Basis-URL
Verwenden Sie die Basis-URL für Ihre Region oder private Instanz:
| Umgebung | Basis-URL |
|---|---|
| USA (SaaS) | https://axe.deque.com |
| Paris (SaaS) | https://axe-eu.deque.com |
| Australien (SaaS) | https://axe-au.deque.com |
| Frankfurt (SaaS) | https://axe-frankfurt.deque.com |
| Private Cloud / vor Ort | Ihre dedizierte Instanz-URL |
Die SCIM-Endpunkte werden unter dem /api/scim/v2-Pfad bereitgestellt — zum Beispiel:
https://axe.deque.com/api/scim/v2/UsersAuthentifizierung
Fügen Sie den API-Schlüssel zu jeder Anfrage hinzu. Beide der folgenden Optionen werden akzeptiert:
# Preferred
-H "X-API-Key: <API_KEY>"
# Also accepted (with or without a "Bearer " prefix)
-H "Authorization: <API_KEY>"Weiter
Sobald die Voraussetzungen erfüllt sind und Sie Ihren API-Schlüssel und die Basis-URL haben, fahren Sie mit Konfiguration Ihres Identitätsanbieters fort.