# Richtlinie für Signaturschlüssel abrufen

`GET /v1/signing-keys/policy` · Berechtigung `signing-keys:read`

Gibt die Signaturschlüssel-Richtlinie der Umgebung zurück: den Algorithmus neuer Schlüssel, das automatische Rotationsintervall und die Schlüsselspeicherung. Wurde die Richtlinie nie geschrieben, werden die Standardwerte (`RS256`, 180 Tage, `wrapped`) mit `ETag: "0"` und `updated_at: null` zurückgegeben. Der Antwort-Header `ETag` trägt die Version, die beim [Aktualisieren der Richtlinie](/docs/api/management/signing-keys/update-policy) als `If-Match` zu senden ist.

## Anfrage

Diese Operation nimmt keine Pfad-, Query- oder Body-Felder. Die Umgebung stammt aus den Anmeldedaten.

## Antwort

`200 OK` mit der Richtlinie und dem `ETag`-Header. `next_rotation_at` ist die nächste automatische Rotation (Aktivierung des aktiven Schlüssels plus Intervall); ohne aktiven Schlüssel ist der Wert `null`.

```json
{
  "algorithm": "RS256",
  "rotation_interval_days": 180,
  "storage": "wrapped",
  "next_rotation_at": "2027-03-04T09:30:00.123456Z",
  "updated_at": null
}
```

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 401 | `unauthenticated` | Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen. |
| 403 | `insufficient_permissions` | Die Anmeldedaten haben nicht die erforderliche Berechtigung. |
| 429 | `rate_limited` | Die Rate-Grenze wurde überschritten; Wiederhole nach dem `Retry-After`-Zeitraum. |
| 501 | `not_implemented` | Die Operation ist in dieser Bereitstellung noch nicht verfügbar; eine Wiederholung ändert das Ergebnis nicht. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; Wiederhole nach dem `Retry-After`-Zeitraum. |

## Beispiel

```bash
curl -i https://api.eu.keenauth.com/v1/signing-keys/policy \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```