Bağlantının IdP imza sertifikalarını listele

GET /v1/connections/{connection_id}/certificates · izin connections:read

Kurumsal SAML bağlantısında kimlik sağlayıcının etkin imza sertifikalarını döndürür: kimlik, SHA-256 parmak izi, geçerlilik aralığı ve kaynak. Sertifikanın kendisi ve konusu (kişi adı ya da e-posta adresi taşıyabilir) döndürülmez. Bir bağlantının en çok 3 etkin sertifikası olduğundan liste sayfalanmaz: limit, after, before ya da order parametresi yoktur ve list_metadata imleç taşımaz. Silinmiş sertifikalar listelenmez. Okumalar audit'e yazılmaz.

İstek

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

Yanıt

200 OK. SAML yapılandırması olmayan SAML bağlantısı boş liste döner.

{
  "data": [
    {"id": "conncert_01j9xq2m4n6p8r0s2t4v6w8y0a", "sha256_fingerprint": "3b0c…", "not_before": "2026-01-01T00:00:00Z", "not_after": "2028-01-01T00:00:00Z", "source": "metadata"}
  ],
  "list_metadata": {"before": null, "after": null}
}
Alan Açıklama
id Sertifika kimliği (conncert_…); sertifikayı silmek için kullanın.
sha256_fingerprint DER kodlamasının küçük harf onaltılık SHA-256 özeti. Kimlik sağlayıcınızın gösterdiği parmak iziyle karşılaştırın.
not_before, not_after Geçerlilik aralığı. Bu aralığın dışındaki sertifika hiçbir imzayı doğrulamaz.
source metadata: metadata URL'si yenilemesi ekledi; manual: yüklendi ya da içe aktarılan metadata belgesinden alındı.

Hatalar

HTTP code Ne zaman
404 not_found Bağlantı bu ortamda yok ya da kurumsal bağlantı değil.
409 conflict Bağlantı SAML bağlantısı 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 "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/certificates" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth connections certificates list conn_01j9xp6q0r1s5t7v9w1x3y5z7b