clerk-auth

Clerk 認証

Clerk 認証の実装、ミドルウェア、組織、Webhook、ユーザー同期に関する専門的なパターン

詳細ガイド

このスキルを実行する前に、詳細ガイドをお読みください。手順と参考資料の全体が記載されています。安全性、前提条件、検証要件は必須として扱ってください。特定の作業では関連するセクションを読み、最初から最後まで作業する場合はガイド全体をお読みください。

使用する場面

• ユーザーが認証の追加について言及または示唆している
• ユーザーが Clerk 認証について言及または示唆している
• ユーザーがユーザー認証について言及または示唆している
• ユーザーがサインインについて言及または示唆している
• ユーザーがサインアップについて言及または示唆している
• ユーザーがユーザー管理について言及または示唆している
• ユーザーがマルチテナントについて言及または示唆している
• ユーザーが組織について言及または示唆している
• ユーザーが sso について言及または示唆している
• ユーザーがシングルサインオンについて言及または示唆している

制限事項

• 上記の範囲に明確に当てはまるタスクに限り、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。

ガイドのスニペットは個別の代替例／ファイルであり、そのままデプロイ可能な単一のモジュールではありません。重複するデフォルトエクスポートや省略された Prisma モデル／インポートは、実際のプロジェクトに合わせて解決する必要があります。互換性のある Next.js／Clerk のバージョンを固定し、現在のミドルウェア／プロキシのファイル名を確認してください。各サーバールート／アクションで認証を行い、入力を検証し、組織の権限と個々のリソースへのアクセスを認可してください。クライアント UI や org:admin では、グローバルユーザーへのアクセス権は付与されません。まず Webhook の未加工バイト列を検証してから、Svix ID をキーとする永続的なトランザクショナルイベント受信箱と、ドメイン固有の順序付け／削除済み状態のポリシーを使用してください。upsert だけでは、古いイベントによる削除済みユーザーの再作成や、新しい状態の上書きを防げません。完全削除は、アプリケーションのデータ保持／外部キーのポリシーに従う必要があります。配列の順序ではなく、実際のプライマリメールアドレスを選択し、電話番号のみの ID も許可してください。テストには合成インスタンスを使用し、署名シークレットや未加工の非公開ペイロードを決してログに記録しないでください。Clerk の同期ガイダンスとSvix の未加工ペイロード検証を参照してください。