Hazır bir öznitelik eşleme profilini uygula

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

Kurumsal bir bağlantının sabit hedefli kurallarını (e-posta, adlar, gruplar…) hazır bir profilin kurallarıyla değiştirir: SAML için entra, okta, google, ping, jumpcloud veya keycloak, OIDC için generic. Kaydedilmiş user_metadata.<key> kuralları korunur. SAML konu özniteliği değiştirilmez: konu ayrıca yapılandırılır ve değiştirilmesi bağlı kimlikleri yetim bırakır. Eşleme listesini değiştirme için olduğu gibi If-Match zorunludur. Zaten uygulanmış bir profili yeniden uygulamak hiçbir şey yazmaz. Yazma işlemi, profil adıyla birlikte connection.attribute_mappings_replaced olarak denetlenir.

İstek

Alan Tür Zorunlu Açıklama
connection_id yol evet Kurumsal bağlantı kimliği (conn_…).
If-Match üstbilgi evet Son okumadaki ETag. Eksikse: 428; eskiyse: 412.
profile dize evet entra, okta, google, ping, jumpcloud, keycloak (SAML) veya generic (OIDC).

Yanıt

Kaydedilmiş listeyi (Öznitelik eşlemelerini al bölümüne bakın) ve yeni ETag değerini içeren 200 OK.

Hatalar

HTTP code Ne zaman
404 not_found Bağlantı bu ortamda yok veya kurumsal bir bağlantı değil.
409 conflict Bağlantının protokolünün öznitelik eşlemesi yok (LDAP).
412 precondition_failed If-Match geçerli sürümle eşleşmiyor veya liste eşzamanlı olarak değişti.
422 validation_failed profile eksik, bilinmiyor veya bağlantının protokolünün hazır profili değil (/profile); ya da korunan bir user_metadata kuralı profil özniteliğini farklı bir NameFormat ile okuyor (/profile, conflicts_with_stored_mappings).
428 precondition_required If-Match üstbilgisi eksik.
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinde gerekli izin yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

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…"'