Für Entwickler

Eine API mit einer Console darüber.

Jede Aktion in der Identify Console ist ein API-Aufruf, den auch Ihre Automatisierung machen kann.

Standardprotokolle

Ihre Apps sprechen OIDC oder SAML 2.0 mit Standard-Endpunkten. Jeder Mandant hat seinen eigenen, festen Issuer-Hostnamen.

Identify basiert auf Keycloak, dem Open-Source-Identity-Server.

API und Zugangsdaten

Die OpenAPI-Beschreibung entsteht aus den laufenden Routen. Als stabil markierte Operationen sind ein Kompatibilitätsversprechen.

API-Zugangsdaten haben dieselben Rollen und Prüfungen wie Personen. Secrets sehen Sie einmal, danach nur noch Rotation.

Token holen, dann beschreibt sich die API selbst

TOKEN=$(curl -s -X POST \
  https://northwind.auth.identify.example/realms/northwind/protocol/openid-connect/token \
  -d grant_type=client_credentials \
  -d client_id=identify-api-ci -d client_secret="$SECRET" | jq -r .access_token)

curl -s -H "Authorization: Bearer $TOKEN" \
  https://northwind.console.identify.example/api/v1/openapi.json

Webhooks

Kleine, signierte Benachrichtigungen mit Kennungen. Den aktuellen Stand lesen Sie über die API zurück.

Ein Endpunkt, der dauerhaft fehlschlägt, pausiert sich selbst und nennt den Grund.

Provisionierung per SCIM 2.0

Identify provisioniert die Apps, die Sie angeben. Es löscht nie Nutzer und deaktiviert niemanden nach einem unvollständigen Lesevorgang.

Audit-Export

Exportieren Sie Ihr vollständiges Audit-Log als NDJSON für Ihr SIEM. Der Stream endet mit einer eof-Zeile, sonst ist er nicht fertig.

Exportieren, dann die letzte Zeile prüfen

curl -s -H "Authorization: Bearer $TOKEN" \
  https://northwind.console.identify.example/api/v1/audit/export -o audit.ndjson

tail -1 audit.ndjson   # {"type":"eof","rows":85,"cursor":"…"}

So funktioniert die Migration

Nutzer melden sich bei Microsoft Entra ID oder Google Workspace an und werden über deren stabile Nutzer-ID verknüpft. Ihr Upstream-Passwort wird nie erfasst.

Der zweite Faktor folgt Ihrer Richtlinie: TOTP, WebAuthn oder ein passwortloser Passkey.

Endpunkte pro Mandant

OIDC-Discovery: https://northwind.auth.identify.example/realms/northwind/.well-known/openid-configuration
SAML-Metadaten: https://northwind.auth.identify.example/realms/northwind/protocol/saml/descriptor
OpenAPI: https://northwind.console.identify.example/api/v1/openapi.json

Gehen wir es gemeinsam durch.

Bringen Sie Ihr Plattform-Team zur Demo mit. Wir beantworten gern auch die tiefen Fragen.

Demo anfragen