Org'un oturumlarını iptal et

POST /v1/organizations/{org_id}/sessions:revoke · izin sessions:write

Org bağlamında açılmış bütün etkin oturumları, org'un bütün kullanıcıları için, org'a verilmiş ya da bu oturumlara bağlı refresh token aileleriyle birlikte iptal eder. Org için verilmiş access token'lar o andan itibaren introspection ve iptal denetiminde kabul edilmez. Bir güvenlik olayından sonra ya da bir org'la çalışma sona ererken kullanın; tek kullanıcıyı ya da tek oturumu kapatmak için Kullanıcının oturumlarını iptal et ucunu kullanın.

Gövde reason taşımalıdır. Not yalnız yönetim audit kaydına yazılır; oturumların iptal nedeni admin'dir. Zaten iptal edilmiş ya da süresi dolmuş oturumlar sayılmaz; tekrar çağrı sıfır sayılarla başarılı olur. Yeniden denemeleri güvenli kılmak için Idempotency-Key başlığı gönderin.

İstek

Parametre Yer Zorunlu Açıklama
org_id path evet org_ önekli org kimliği.

Gövde:

Alan Tür Zorunlu Açıklama
reason string evet Audit kaydı için notunuz: 1-256 karakter, kontrol karakteri ya da satır sonu yok.

Yanıt

200 OK.

{
  "revoked_sessions": 42,
  "revoked_token_families": 57
}
Alan Açıklama
revoked_sessions Bu çağrıda iptal edilen oturum sayısı.
revoked_token_families Bu çağrıda iptal edilen refresh token ailesi sayısı.

Hatalar

Her hata, kararlı bir code taşıyan application/problem+json gövdesidir.

HTTP code Ne zaman
400 malformed_request, unknown_field Gövde geçerli JSON değil ya da bilinmeyen alan taşıyor.
415 unsupported_media_type Gövde Content-Type: application/json olmadan gönderildi.
422 validation_failed reason yok ya da boş (required), 256 karakterden uzun (too_long) ya da kontrol karakteri veya satır sonu içeriyor (invalid_value).
404 not_found Org bu ortamda yok.
401 unauthenticated API anahtarı yok, geçersiz ya da iptal edilmiş.
403 insufficient_permissions Anahtarda sessions: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; sonra yeniden deneyin.

Örnek

curl -X POST https://api.eu.keenauth.com/v1/organizations/org_0a1b2c3d4e5f6g7h8j9k0m1n2p/sessions:revoke \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Security incident INC-1042"}'

CLI: keenauth organizations sessions revoke org_0a1b2c3d4e5f6g7h8j9k0m1n2p --reason "Security incident INC-1042" --yes