Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Client integration

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

WebAuthnのRP IDはKeycloak RP IDと別に構成します。秘密鍵をGorapeへ送信してはいけません。Attestation formatとtrust anchorは WebAuthn設定を参照してください。