Kullanıcıdan bağlı kimliğin bağlantısını kaldırma

DELETE /v1/users/{user_id}/identities/{identity_id} · izin users:write

Bir kullanıcının bağlı kimliklerinden birini kaldırır (parola, sosyal, SAML, OIDC veya eski yöntem). Kullanıcının dahil olduğu bir kuruluş, kimliğin bağlantısı üzerinden tek oturum açmayı zorunlu kılsa bile kaldırma işlemi gerçekleşir: kullanıcı böyle bir kimliği hesap portalından kaldıramaz (409 sso_enforced_by_organization), bunu müşteri bu uç nokta ile kaldırır. Kullanıcının son birincil faktör yöntemi kaldırılamaz (409 last_login_method). Kullanıcıya doğrulanmış her adreste bildirim gönderilir ve işlem, işlemi yapan olarak API anahtarı ile yönetim denetim günlüğüne yazılır.

İstek

Parametre Konum Zorunlu Açıklama
user_id path evet Kullanıcı kimliği, usr_ önekiyle.
identity_id path evet Kimlik kimliği, idn_ önekiyle (GET /v1/users/{user_id}/identities tarafından döndürüldüğü gibi).

İstek gövde almaz.

Yanıt

204 No Content.

Hatalar

Her hata, kararlı bir code içeren bir application/problem+json gövdesidir.

HTTP code Ne zaman
404 not_found Kullanıcı bu ortamda yok, kimlik bu kullanıcıya ait değil veya bilinmiyor ya da bir kimlik hatalı biçimde.
409 last_login_method Bu kimlik kullanıcının son birincil faktör yöntemidir; önce başka bir yöntem ekleyin.
401 unauthenticated API anahtarı eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Anahtarda users:write izni yok.
429 rate_limited Hız sınırı aşıldı; Retry-After değerine uyun.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin.

Örnek

curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/identities/idn_0a1b2c3d4e5f6g7h8j9k0m1n2r \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

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 özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.