Eine voreingestellte Attributzuordnungs-Vorlage anwenden

POST /v1/connections/{connection_id}/attribute-mappings:apply-profile · Berechtigung connections:write

Ersetzt die Regeln mit festem Ziel (E-Mail, Namen, Gruppen …) einer Unternehmensverbindung durch die Regeln einer voreingestellten Vorlage: entra, okta, google, ping, jumpcloud oder keycloak für SAML, generic für OIDC. Gespeicherte Regeln user_metadata.<key> bleiben erhalten. Das SAML-Subjekt-Attribut wird nicht geändert: Das Subjekt wird separat konfiguriert, und eine Änderung würde verknüpfte Identitäten verwaisen lassen. If-Match ist erforderlich, wie beim Ersetzen der Liste. Eine Vorlage, die bereits angewendet ist, erneut anzuwenden, schreibt nichts. Der Schreibvorgang wird als connection.attribute_mappings_replaced mit dem Namen der Vorlage protokolliert.

Anfrage

Feld Typ Erforderlich Beschreibung
connection_id path ja ID der Unternehmensverbindung (conn_…).
If-Match header ja Das ETag aus dem letzten Lesevorgang. Fehlt es: 428; veraltet: 412.
profile string ja entra, okta, google, ping, jumpcloud, keycloak (SAML) oder generic (OIDC).

Antwort

200 OK mit der gespeicherten Liste (siehe Attributzuordnungen abrufen) und dem neuen ETag.

Fehler

HTTP code Wann
404 not_found Die Verbindung existiert in dieser Umgebung nicht oder ist keine Unternehmensverbindung.
409 conflict Das Protokoll der Verbindung kennt keine Attributzuordnungen (LDAP).
412 precondition_failed If-Match stimmt nicht mit der aktuellen Version überein, oder die Liste wurde parallel geändert.
422 validation_failed profile fehlt, ist unbekannt oder ist keine Vorlage für das Protokoll der Verbindung (/profile), oder eine beibehaltene Regel user_metadata liest ein Vorlagenattribut mit einem anderen NameFormat (/profile, conflicts_with_stored_mappings).
428 precondition_required Der Header If-Match fehlt.
401 unauthenticated Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen.
403 insufficient_permissions Den Anmeldedaten fehlt die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach dem Zeitraum aus Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach dem Zeitraum aus Retry-After.

Beispiel

curl -X POST "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/attribute-mappings:apply-profile" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "6f1c…"' \
  -d '{"profile":"entra"}'

keenauth connections attribute-mappings apply-profile conn_01j9xp6q0r1s5t7v9w1x3y5z7b --profile entra --if-match '"6f1c…"'