署名鍵ポリシーを取得

GET /v1/signing-keys/policy · 権限 signing-keys:read

環境の署名鍵ポリシーを返します。新しい鍵のアルゴリズム、自動ローテーション間隔、鍵の保管方式です。ポリシーが一度も書き込まれていない場合は、デフォルト値 (RS256、180 日、wrapped) が ETag: "0" と updated_at: null とともに返されます。ETag レスポンスヘッダーは、ポリシーを更新するときに If-Match として送るバージョンを示します。

リクエスト

この操作はパス、クエリ、ボディのフィールドを受け取りません。環境は認証情報から決まります。

レスポンス

200 OK とポリシー、ETag ヘッダー。next_rotation_at は次の自動ローテーション (有効な鍵の有効化時刻 + 間隔) で、有効な鍵がない場合は null です。

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

エラー

HTTP	コード	概要
401	`unauthenticated`	認証情報が見つからない、無効、または取り消されています。
403	`insufficient_permissions`	認証情報に必要な権限がありません。
429	`rate_limited`	レート制限を超えました。`Retry-After` 期間後に再試行してください。
501	`not_implemented`	この操作はこのデプロイではまだ利用できません。再試行しても結果は変わりません。
503	`service_unavailable`	依存関係が一時的に利用できません。`Retry-After` 期間後に再試行してください。

例

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