Client integration
- ProjectのKeycloak RealmへAuthorization Code + PKCEでログインします。
- Signed access tokenを
Authorization: Bearer ...で送信します。ID tokenはAPI認証に使いません。Gorapeはissuer/subjectでPrincipalを解決します(GF-10003, GF-10005, GF-10006)。 - Device登録とproofには、署名検証済みtokenの
amrにpasskeyが必要です(GF-10008)。パスワードだけのログインではDevice操作を許可しません。 - Android/iOS/macOS/WebではGorape RPのcreation optionsを取得し、OS/browser credential providerの完全なWebAuthn responseをregistration verify endpointへ送ります(GF-10016, GF-10017)。
- 継続的なproofではDevice IDに紐づいたassertion optionsを取得し、providerにchallengeを署名させます(GF-10018, GF-10019)。
- LinuxはブラウザにOIDC tokenを渡さず、短期・単回使用capabilityによるbrowser handoffを利用します(GF-10020, GF-10021, GF-10022)。
- 旧Android Keystore登録APIは互換性用に残っていますが、WebAuthn passkeyと混同しないでください。
WebAuthnのRP IDはKeycloak RP IDと別に構成します。秘密鍵をGorapeへ送信してはいけません。Attestation formatとtrust anchorは WebAuthn設定を参照してください。