API endpoints
/healthはpublicです。通常のproject APIはKeycloak access tokenを必要とし、/v1/projectsはissuerからprojectを解決します。Platform provisioningはplatform issuerのadmin roleで保護します。Browser passkey handoffの3 endpointだけはBearer tokenを受け取りません。代わりにoptions callから発行された短期・単回使用challenge IDをcapabilityとして検証します。RouteとmiddlewareはGF-10002で登録されます。Swagger列は該当operationを直接開きます。
| Method | Endpoint | Purpose | Swagger |
|---|---|---|---|
| GET | /health | Liveness (GF-10002) | Open |
| GET | /v1/projects | Token issuerに対応するProject一覧 (GF-10003) | Open |
| POST | /v1/passkeys/browser/options | Capabilityでbrowser ceremony optionsを取得 (GF-10020) | Open |
| POST | /v1/passkeys/browser/registration/verify | Browser registration responseを検証 (GF-10021) | Open |
| POST | /v1/passkeys/browser/authentication/verify | Browser assertionを検証 (GF-10022) | Open |
| GET | /v1/projects/{projectId} | Project取得 | Open |
| POST | /v1/platform/provisioning/plan | Platform admin向けprovisioning plan (GF-10023) | Open |
| POST | /v1/platform/provisioning/apply | Platform admin向けprovisioning適用 (GF-10024) | Open |
| GET | /v1/projects/{projectId}/permissions | Effective permission取得 (GF-10007) | Open |
| GET | /v1/projects/{projectId}/groups | Group一覧 | Open |
| POST | /v1/projects/{projectId}/groups | Group作成 | Open |
| GET | /v1/projects/{projectId}/groups/{groupId} | Group取得 | Open |
| PATCH | /v1/projects/{projectId}/groups/{groupId} | Group更新 | Open |
| DELETE | /v1/projects/{projectId}/groups/{groupId} | Group削除 | Open |
| GET | /v1/projects/{projectId}/devices | Device一覧 | Open |
| GET | /v1/projects/{projectId}/devices/{deviceId} | Device取得 | Open |
| DELETE | /v1/projects/{projectId}/devices/{deviceId} | Device失効 | Open |
| POST | /v1/projects/{projectId}/devices/registration/challenge | 登録Challenge発行 (passkey AMR required, GF-10008) | Open |
| POST | /v1/projects/{projectId}/devices/registration/verify | Attestation検証と登録 (passkey AMR required, GF-10008) | Open |
| POST | /v1/projects/{projectId}/devices/passkeys/registration/options | Gorape RP用WebAuthn registration options (GF-10016) | Open |
| POST | /v1/projects/{projectId}/devices/passkeys/registration/verify | WebAuthn credential/attestation検証と登録 (GF-10017) | Open |
| POST | /v1/projects/{projectId}/devices/{deviceId}/challenge | 鍵保有証明Challenge発行 (passkey AMR required, GF-10008) | Open |
| POST | /v1/projects/{projectId}/devices/{deviceId}/verify | 鍵保有証明検証 (passkey AMR required, GF-10008) | Open |
| POST | /v1/projects/{projectId}/devices/{deviceId}/passkeys/authentication/options | WebAuthn assertion options (GF-10018) | Open |
| POST | /v1/projects/{projectId}/devices/{deviceId}/passkeys/authentication/verify | WebAuthn assertion検証 (GF-10019) | Open |
| POST | /v1/projects/{projectId}/proof-requests | 外部サービス向け操作結合WebAuthn Challenge発行 (GF-10035) | Open |
| POST | /v1/projects/{projectId}/proof-requests/{proofId}/verify | 外部サービス向け操作結合WebAuthn Assertion検証 (GF-10036) | Open |
| GET | /v1/projects/{projectId}/groups/{groupId}/devices | Group Device一覧 | Open |
| POST | /v1/projects/{projectId}/groups/{groupId}/devices | DeviceをGroupへ割当 | Open |
| DELETE | /v1/projects/{projectId}/groups/{groupId}/devices/{deviceId} | Group割当解除 | Open |
| GET | /v1/projects/{projectId}/roles | Project Role binding一覧 | Open |
| POST | /v1/projects/{projectId}/roles | Project Role binding設定 | Open |
| DELETE | /v1/projects/{projectId}/roles/{bindingId} | Project Role binding削除 | Open |
| GET | /v1/projects/{projectId}/groups/{groupId}/roles | Group Role binding一覧 | Open |
| POST | /v1/projects/{projectId}/groups/{groupId}/roles | Group Role binding設定 | Open |
| GET | /v1/projects/{projectId}/role-definitions | Role定義一覧 | Open |
| PUT | /v1/projects/{projectId}/role-definitions/{key} | Role定義作成・更新 | Open |
| DELETE | /v1/projects/{projectId}/role-definitions/{key} | Role定義削除 | Open |
| GET | /v1/projects/{projectId}/attestation/capabilities | Legacy native-key verifier対応状況 | Open |
| GET | /v1/projects/{projectId}/devices/{deviceId}/attestation | Attestation履歴 | Open |