Passkey ログイン

目的

リモートブラウザー環境で、サイトの Passkey ログインを準備して使用する方法を説明します。

前提条件

• 対象サイトが Passkey、WebAuthn、またはセキュリティキーによるログインをサポートしている。
• ユーザーが対象サイトで Passkey を登録済みである。
• リモートブラウザーのアクセスフローが必要な認証操作をサポートしている。

手順

1. サイト設定で、サイト URL、ドメイン、ログインフローが正しいことを確認します。
2. ユーザーがポータルから対象サイトを開きます。
3. 対象サイトで Passkey ログインを選択します。
4. ブラウザーの案内に従って認証を完了します。
5. ログイン成功後、リモートブラウザーが対象業務ページに入ったことを確認します。

対象サイト Passkey のローカルテスト

Passkey はブラウザーから見えるドメインに強く紐づきます。対象サイトの Passkey ログインをテストするときは、サーバー IP や一時的な転送アドレスだけでアクセスしてはいけません。ローカルブラウザーが対象サイトのドメインで HTTPS アクセスを開始し、そのドメインがシステムでプロキシ可能な業務ドメインとして認識されている必要があります。

次の手順で準備することを推奨します。

1. 管理プラットフォームで「システム設定 > ドメイン管理」に移動し、「ドメインを追加」をクリックして、login.example.com などの対象サイトドメインを追加します。このページは管理端の Domains.vue に対応し、システムが処理を許可する業務ドメインを管理します。
2. ローカル PC に Caddy ルート証明書をインストールします。イントラネットやテスト環境で Caddy 内部証明書を使う場合、ブラウザーがこのルート証明書を信頼している必要があります。信頼されていない HTTPS では Passkey/WebAuthn 認証を正常に完了できません。方法は内部証明書のインストールを参照してください。
3. ローカルの hosts に対象サイトドメインの名前解決を追加し、デプロイサーバー IP を指すようにします。例:

<SERVER_IP> login.example.com

Windows では通常 C:\Windows\System32\drivers\etc\hosts を、macOS/Linux では通常 /etc/hosts を編集します。変更後はブラウザーを開き直し、必要に応じて DNS キャッシュをクリアしてください。

4. 対象サイトドメインでテストアドレスにアクセスします。

https://<対象サイトドメイン>/?saas=<...>&_d=<対象サイトアドレス>

各値の意味:

パラメーター	説明
<対象サイトドメイン>	「ドメイン管理」に追加済みで、ローカル hosts からデプロイサーバー IP を指すドメイン
saas	システムが生成する、または業務シナリオで必要な SaaS アクセスパラメーター
_d	対象サイトアドレス。通常は実際に開く必要がある対象サイト URL

これらの準備が完了すると、ブラウザーのアドレスバーの origin は対象サイトドメインになり、HTTPS 証明書もローカルで信頼されます。これが対象サイトの Passkey ログインをテストするための基本条件です。

結果確認

• 対象サイトが Passkey ログイン方式を認識する。
• ユーザーが認証を完了し、サイトに入れる。
• 認証に失敗した場合は、サイトの案内とリモートブラウザーログで原因を確認する。

よくある質問

• Passkey はまだ alpha 段階の機能であり、一部のサイトではログインに失敗する場合があります。