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.ftl if 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前提条件