Kimliğin bağlantısını kaldırın
DELETE /fapi/v1/me/identities/{identity_id} · ortamın giriş yap ana makinesinden çağrılır
Sosyal veya kurumsal bir kimliğin bağlantısını, kimliği doğrulanmış kullanıcının hesabından kaldırır. Kullanıcının son giriş yöntemi kaldırılamaz. Kullanıcının kuruluşu bu bağlantıda SSO'yu zorunlu kılıyorsa, kimlik yalnızca müşteri yönetim API'si üzerinden kaldırılabilir. Kaldırma başarıyla tamamlandıktan sonra, kullanıcının doğrulanmış tüm e-posta adreslerine bir güvenlik bildirimi gönderilir. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gereklidir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse 401 unauthenticated döner. Farklı bir kökendeki birinci taraf bir uygulama bunun yerine ön yüz API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Ön yüz API erişim belirteci).
Oturumun son 5 dakika içinde doğrulanmış olması gerekir. Kullanıcının ikinci bir faktörü varsa, oturumun ayrıca ikinci bir faktörle açılmış olması gerekir (urn:idp:acr:mfa).
İstek
Başlıklar:
| Başlık | Zorunlu | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Origin |
evet | Tam olarak https://<giriş yap ana makinesi> olmalıdır. |
identity_id: bağlı kimliğin idn_… biçimindeki kimliği.
Gövde yok.
Yanıt
204 No Content.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 401 | unauthenticated |
Geçerli bir oturum çerezi yok. |
| 401 | step_up_required |
Oturum son 5 dakikada doğrulanmadı veya ikinci bir faktör gerekli; WWW-Authenticate başlığında max_age=300 (ve uygunsa acr_values) ile yeniden doğrulayın. |
| 403 | origin_not_allowed |
Origin eksik veya yanlış. |
| 404 | not_found |
Bu kullanıcı için böyle bir kimlik yok. |
| 409 | last_login_method |
Bu kimlik kullanıcının son giriş yöntemi. |
| 409 | sso_enforced_by_organization |
Kullanıcının kuruluşu bu bağlantıda SSO'yu zorunlu kılıyor. |
Örnek
curl -X DELETE https://example.keenauth.app/fapi/v1/me/identities/idn_01j9zzzzzzzzzzzzzzzzzzzzzz \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
Kişisel veriler
Bu uç nokta kişisel veri içerir: bağlı kimlikler. KeenAuth API'lerinde kişisel veriler, neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda kişisel verilerin özel kategorilerini (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.