クイックスタート

Setup から最初の OIDC ログインまでを確認します。所要時間はリソース作成、ビルド、DNS、有効にする機能によって変わります。

1. ソースを準備する

Node.js 22.18 以降の 22.x または 24.11 以降、pnpm 9、Git、必要な権限を持つ Cloudflare アカウントを用意し、評価するリリースのソースを使います。

git clone https://github.com/sgrastar/authrim.git
cd authrim
pnpm install
pnpm exec wrangler login

2. Setup を実行する

pnpm run setup init --env dev --lang ja

ターミナルだけで操作する場合は --cli を追加します。ドメイン、リソース、メール、管理者アクセスを設定し、デプロイまで進めてください。生成された環境設定と鍵は保持します。

ここでは Cloudflare 上に評価環境を作成します。利用するために、その後 pnpm run dev を起動する必要はありません。ローカル開発はインストールで説明する別の手順です。

3. Discovery を確認する

対象テナントの実際の issuer URL を使用します。次の例を置き換えてください。Admin UI の URL とは異なります。

AUTHRIM_ISSUER='https://auth.example.com'
curl --fail --silent --show-error \
  "$AUTHRIM_ISSUER/.well-known/openid-configuration"

issuer、authorization_endpoint、token_endpoint、userinfo_endpoint、jwks_uri を確認します。返された jwks_uri にアクセスして、署名用の公開鍵も確認してください。アプリには Discovery が返すエンドポイントを設定し、ドメインやパスを推測して組み立てないようにします。

4. アプリケーションを登録する

Setup が表示した Admin UI を開き、初期管理者の設定を完了します。対象テナントで、次のように OIDC クライアントを作成します。

設定	例
アプリの種類	実装に合わせて SPA・モバイル・サーバーアプリを選択
グラント	Authorization Code
リダイレクト URI	アプリの正確なコールバック。ローカル評価なら http://localhost:3000/callback など
スコープ	openid。必要に応じて profile・email を追加
PKCE	S256
クライアント認証	公開クライアントにはシークレットを埋め込まず、サーバークライアントでは設定した認証方式を使用

発行されたクライアント ID を使います。test-client が自動的に用意されるわけではありません。利用可能な認証方法を設定し、メールコードの場合は実際に配信できることも確認します。

5. アプリからログインする

OIDC ライブラリまたは Authrim SDK に issuer、クライアント ID、コールバックを設定します。毎回新しい verifier/challenge と state・nonce を生成して、Authorization Code + PKCE を開始します。戻ってきたレスポンスを検証し、同じリダイレクト URI と verifier でコードを交換します。

仮のクライアント ID と固定の state を埋め込んだ URL だけでは、ログインの確認は完結しません。正常なログインに加えて、アプリが state やリダイレクト URI の不一致を拒否することも確認してください。

うまく動かない場合

pnpm run setup status --env dev
pnpm run setup info --env dev

テナントの issuer、デプロイ状態、リダイレクト URI、クライアントの種類、メール・プロバイダー設定を確認します。詳しい導入・更新手順はインストールを参照してください。