パスキー & WebAuthn

パスキーと WebAuthn によるパスワードレス認証。

Authrim は Direct Auth で passkey sign-up、login、認証済みユーザーの追加 passkey 登録をサポートします。browser integration では通常、これらの endpoint を直接呼ばず Web SDK を使います。

Direct Auth エンドポイント

エンドポイント	メソッド	説明
/api/v1/auth/direct/passkey/signup/start	POST	passkey sign-up 開始
/api/v1/auth/direct/passkey/signup/finish	POST	passkey sign-up 完了
/api/v1/auth/direct/passkey/login/start	POST	passkey login 開始
/api/v1/auth/direct/passkey/login/finish	POST	passkey login 完了
/api/v1/auth/direct/passkey/register/start	POST	認証済みユーザーの追加 passkey 登録開始
/api/v1/auth/direct/passkey/register/finish	POST	追加 passkey 登録完了

Web SDK

const authrim = createAuthrim({
  issuer: 'https://auth.example.com',
  clientId: 'web-client',
});

await authrim.passkey.signUp({
  email: 'user@example.com',
  displayName: 'User Example',
});

await authrim.passkey.login({
  conditional: true,
});

option shape、conditional UI、error handling は Web SDK passkey guide を参照してください。

Admin passkeys

Admin setup と admin console login は、end-user passkey とは別の admin passkey endpoint を使います：

• /api/admin/setup-token/passkey/options
• /api/admin/setup-token/passkey/complete
• /api/admin/auth/passkey/options
• /api/admin/auth/passkey/verify