Bağlantının öznitelik eşlemelerini getir

GET /v1/connections/{connection_id}/attribute-mappings · izin connections:read

Kurumsal (SAML ya da OIDC) bağlantının öznitelik eşleme kurallarını hedefe göre sıralı döndürür. Her kural kimlik sağlayıcının gönderdiği bir özniteliği ya da claim'i (source_name) bir kullanıcı alanına (target) eşler. ETag başlığı listenin sürümünü taşır; listeyi değiştirirken ya da hazır profil uygularken bu değeri If-Match olarak gönderin. Kayıtlı kuralı olmayan bağlantıda liste boştur: girişte şablon varsayılanı uygulanır (OIDC'de generic profili; SAML'de hiçbir şey eşlenmez). Okumalar audit'e yazılmaz.

İstek

Alan	Tür	Zorunlu	Açıklama
`connection_id`	yol	evet	Kurumsal bağlantı kimliği (`conn_…`).

Yanıt

200 OK; liste ve ETag.

{
  "attribute_mappings": [
    {
      "target": "email",
      "source_name": "email",
      "source_name_format": null,
      "overwrite": "always",
      "profile": "okta"
    },
    {
      "target": "user_metadata.department",
      "source_name": "department",
      "source_name_format": "urn:oasis:names:tc:SAML:2.0:attrname-format:basic",
      "overwrite": "if_empty",
      "profile": "generic"
    }
  ]
}

Alan	Açıklama
`target`	`email`, `given_name`, `family_name`, `name`, `locale`, `zoneinfo`, `phone`, `groups` ya da `user_metadata.<anahtar>`.
`source_name`	SAML öznitelik `Name` değeri ya da OIDC claim adı (nokta yollu, derinlik ≤ 3).
`source_name_format`	Özniteliğin okunduğu SAML `NameFormat`; `null` yalnız adla eşler.
`overwrite`	`always` (her girişte), `if_empty` (yalnız alan boşsa) ya da `never` (yalnız oluşturmada).
`profile`	Kuralın geldiği hazır profil; elle yazılan kurallarda `generic`.

Hatalar

HTTP	code	Ne zaman
404	`not_found`	Bağlantı bu ortamda yok ya da kurumsal bağlantı değil.
401	`unauthenticated`	Kimlik bilgisi yok, geçersiz ya da 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 -i "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/attribute-mappings" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth connections attribute-mappings get conn_01j9xp6q0r1s5t7v9w1x3y5z7b