# 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.

```json
{
  "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](delete.md) 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](../connections/import-metadata.md) 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

```bash
curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/certificates" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

```bash
keenauth connections certificates list conn_01j9xp6q0r1s5t7v9w1x3y5z7b
```