OfficialSPIMFA / PasswordlessActive
keycloak-extension-qr-code-execution
HadleySo/keycloak-extension-qr-code-execution ↗
Sign in from another device by scanning a QR code.QRコードで別端末からサインイン
- ★
- 14
- Forks
- 4
- Contributors
- 2
- Updated
- 2026-06-13
- KC
- —
- License
- AGPL-3.0
What it can doできること5
- Sign in on one device by scanning a QR code and authenticating on another (e.g. a phone) — no password typed on untrusted devices.QRコードを読み取り、別の端末(スマホなど)で認証して元の端末にサインインできる。信頼できない端末でパスワードを入力せずに済む
- Use passkeys on devices without Bluetooth by completing authentication on a passkey-enabled device.Bluetoothのない端末でも、パスキー対応の端末で認証を完了させることでパスキーが使える
- Show session, user-agent and origin device details on the confirmation page so the user can approve or reject.確認画面にセッション・User-Agent・発信元端末の情報を表示し、ユーザーが承認か拒否を選べる
- Transfer the required ACR (step-up level) and credential types between sessions.要求されるACR(ステップアップのレベル)やクレデンシャル種別をセッション間で引き継げる
- Offer a 6-digit short code when the other device cannot scan a QR code.QRコードを読めない端末向けに、6桁の短縮コードも使える
What it cannot do / limitsできないこと・制約4
- The QR code exposes the public FQDN, realm name, session ID and tab ID to anyone who sees it.QRコードには公開FQDN・realm名・セッションID・タブIDが含まれ、見た人なら誰でも読み取れる
- The "Username Password Form with Optional QR Code" execution needs a custom
qr-login.ftlif your realm uses a custom theme.「Username Password Form with Optional QR Code」を使う場合、realmで独自テーマを使っているならqr-login.ftlを用意する必要がある - Messages are provided only in English and German.メッセージは英語とドイツ語のみ
- Licensed under AGPL-3.0.ライセンスはAGPL-3.0
Requirements前提条件
- Copy the JAR to
providers/, runkc.sh build, and add an execution to a browser flow; short codes add a database table.JARをproviders/に置いてkc.sh buildし、ブラウザフローにExecutionを追加。短縮コードを使う場合はDBにテーブルが追加される