idp-server Client Instance 管理 API (1.0.0)

テナント内のインスタンスを、クライアントをまたいで検索します。新しく登録したものから順に返します。

条件はすべて任意で、組み合わせられます。取りうる値が決まっている条件（status、revocation_reason、 UUID の user_id、日時の from / to）に合わない値は 400 を返します。空の一覧を返すと「該当なし」と読み違えるためです。

運用側でインスタンスの鍵を登録します。アプリからの登録（client_instance_registration_policy）には縛られず、利用者にも束縛されません。

• client_id は必須で、このテナントのクライアントであること
• id を指定する場合は UUID で、どのインスタンスにも使われていないこと。省略するとサーバーが払い出します
• instance_key は公開鍵の JWK であること（d などの秘密鍵の要素を含むと 400）
• 同じテナントのいずれかのインスタンス（失効したものを含む）にすでに登録されている鍵は登録できません

UUID でない id や、存在しない id は 404 を返します。

インスタンスの記録を消し、そのインスタンスに発行したトークンも削除します。 止めるだけなら失効（POST .../{id}/revoke）を使ってください。削除すると、同じ鍵をもう一度登録できるようになります（別のインスタンスとして扱われ、旧いトークンは引き継ぎません）。

インスタンスの信頼をやめます。記録と証跡は残り（status: revoked、revoked_at、revocation_reason: operator）、 そのインスタンスに発行したトークンは削除します。リフレッシュトークンと、introspection で確かめるアクセストークンはその時点で止まります。 JWT のアクセストークンをリソースサーバーが手元で検証する場合は、有効期限まで通ります。

失効は元に戻せません。 すでに失効しているインスタンスを失効させようとすると 400 を返し、最初の revoked_at を保ちます。 端末をもう一度信頼するときは、アプリが新しい鍵を作って登録し直します（失効した鍵は再登録できません）。

テナント内のインスタンスを、クライアントをまたいで検索します。新しく登録したものから順に返します。

条件はすべて任意で、組み合わせられます。取りうる値が決まっている条件（status、revocation_reason、 UUID の user_id、日時の from / to）に合わない値は 400 を返します。空の一覧を返すと「該当なし」と読み違えるためです。

運用側でインスタンスの鍵を登録します。アプリからの登録（client_instance_registration_policy）には縛られず、利用者にも束縛されません。

• client_id は必須で、このテナントのクライアントであること
• id を指定する場合は UUID で、どのインスタンスにも使われていないこと。省略するとサーバーが払い出します
• instance_key は公開鍵の JWK であること（d などの秘密鍵の要素を含むと 400）
• 同じテナントのいずれかのインスタンス（失効したものを含む）にすでに登録されている鍵は登録できません

UUID でない id や、存在しない id は 404 を返します。

インスタンスの記録を消し、そのインスタンスに発行したトークンも削除します。 止めるだけなら失効（POST .../{id}/revoke）を使ってください。削除すると、同じ鍵をもう一度登録できるようになります（別のインスタンスとして扱われ、旧いトークンは引き継ぎません）。

インスタンスの信頼をやめます。記録と証跡は残り（status: revoked、revoked_at、revocation_reason: operator）、 そのインスタンスに発行したトークンは削除します。リフレッシュトークンと、introspection で確かめるアクセストークンはその時点で止まります。 JWT のアクセストークンをリソースサーバーが手元で検証する場合は、有効期限まで通ります。

失効は元に戻せません。 すでに失効しているインスタンスを失効させようとすると 400 を返し、最初の revoked_at を保ちます。 端末をもう一度信頼するときは、アプリが新しい鍵を作って登録し直します（失効した鍵は再登録できません）。