アプリ連携

Docsのログイン状態を確認する

mikaki Docsは、サインインなしで読める公開FAQと連携ガイドです。ログイン状態の例では、専用RPがauth.mikaki.orgへ接続し、パスキーログイン後のセッション再確認とアプリ単位のログアウトを示します。利用にはmikakiに登録済みのパスキーが必要です。新規登録ははじめ方を参照してください。

Docsはサインイン不要です。ログイン例が要求するのはopenidだけで、名前・メール・Vaultの内容は要求しません。問い合わせ本文やメモを投稿する機能もありません。ログインに必要なアプリ別の識別子とセッション情報は、IdPとは別の専用DBに一時保存します。

このページの内容

Docsでサインインする#

  1. https://docs.mikaki.org/sessionで「mikakiでサインイン」を選びます。
  2. 認証画面のdomainがauth.mikaki.orgで、接続先がdocs.mikaki.orgであることを確認します。
  3. 初回の接続確認と、登録済みパスキーの本人確認を行います。
  4. Docsに戻り、「ログイン状態」に「サインイン済み」と表示されることを確認します。

登録とサインインは別の操作です。新しいアカウントを作る場合は、招待を受け取ってはじめ方の登録を先に済ませてください。端末・ブラウザーの対応はパスキーの説明にあります。

セッションを再確認する#

「セッションを再確認」は、RPのサーバーから公開IdPへ現在のセッション状態を問い合わせます。確認が成功するとログイン状態へ戻ります。失効や期限切れが確認された場合は、RPのセッションも削除し、古い確認期限が残っていてもログイン済みとは扱いません。

通常の表示は、前回の確認が有効な期間内で使います。通信障害で再確認できない場合は期限を延ばしません。認証画面へ戻るだけ、または画面上にボタンがあるだけでは、コード交換やセッション確認が成功した証拠にはなりません。

このデモのRPセッションは最長1時間です。IdP側の期限が先に来る場合は、その期限を超えません。日時はUTCで表示します。

Docsからログアウトする#

「Docsからログアウト」を選ぶと、RPのセッションとCookieを削除します。mikakiのSSOは終了しないため、同じブラウザーでの次のログインが短い操作で済む場合があります。

「mikaki側のログアウト確認画面」は、IdPのSSOを終了する別の操作です。確認画面の対象を読み、他の接続アプリへの影響も含めて判断してください。

実装と確認範囲#

Docs RPは専用Worker、HTTPS origin、D1、RP専用ES256鍵、完全一致するcallbackを使います。秘密鍵はWorkerのsecretに保管します。FAQやガイドの閲覧はRPセッションに依存しません。

確認項目範囲
PKCE・state・nonce・ID Token署名・issuer / audience既存RP実装とローカル統合テスト
パスキーログイン、再確認、RPログアウト、失効後の拒否Docs RPのブラウザーテスト。使い捨てローカルOPと仮想認証器
公開IdPへのクライアント登録デモ専用の公開鍵・callback・Back-Channel受信先を管理者手順で登録
公開環境でのパスキー往復と実通知の到達本人操作を伴う試験。登録やローカルの成功だけでは確認済みとしない

この例はOpenID Foundationの認定や第三者監査を示すものではありません。conformance testの結果一覧と区別してください。自分のRPを作るときは、ローカル実行例を参照できます。

次に読む#