claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialsecurity

🔐auth0-quickstart

プラグイン
auth0
ライセンス
Apache-2.0

説明

次のような場合に使用: アプリにAuth0認証を追加する際、どのSDKまたはスキルを使用すべきか不明な場合。 プロジェクトのフレームワークを自動検出し、適切なセットアップワークフローへルーティングします。 ユーザーが「アプリにログイン機能を追加したい」や「Auth0をセットアップしたい」とフレームワークを明示せずに言った場合でも、このスキルをエントリーポイントとして使用してください。

原文を表示

Use when adding Auth0 authentication to any app and unsure which SDK or skill to use. Detects the project's framework and routes to the right setup workflow — use this as the entry point even if the user just says "add login to my app" or "set up Auth0" without naming a framework.

ユースケース

  • アプリにAuth0認証を追加する際
  • 使用すべきSDKが不明な場合
  • ログイン機能を追加したいとき
  • Auth0をセットアップするとき

本文(日本語訳)

Auth0 クイックスタート

フレームワークを自動検出して、Auth0 認証をすぐに始めましょう。


ステップ 1: フレームワークの検出

以下のコマンドを実行してフレームワークを特定します:

# package.json の依存関係を確認(Node.js プロジェクト)
cat package.json | grep -E "react|next|vue|nuxt|angular|express|fastify|@nestjs|expo"

# またはプロジェクトファイルを確認
ls -la | grep -E "angular.json|vue.config.js|next.config|app.json|Package.swift|build.gradle"

フレームワーク検出テーブル:

フレームワーク 検出方法 使用する Skill
React (Vite/CRA) package.json に "react" があり、Next.js なし auth0-react
Next.js package.json に "next" がある auth0-nextjs
Vue.js package.json に "vue" があり、Nuxt なし auth0-vue
Nuxt package.json に "nuxt" がある auth0-nuxt
Angular angular.json が存在するか "@angular/core" がある auth0-angular
Express.js package.json に "express" がある auth0-express
Fastify(Web アプリ) package.json に "fastify" があり、@fastify/view を使用 auth0-fastify
Fastify(API) package.json に "fastify" があり、ビューエンジンなし auth0-fastify-api
React Native package.json に "react-native" または "expo" がある auth0-react-native
Flask requirements.txt、Pipfile、または pyproject.toml に "flask" がある auth0-flask
Node.js API package.json に "express-oauth2-jwt-bearer" がある express-oauth2-jwt-bearer
ASP.NET Core Web アプリ *.csproj が存在し、Views/ または Pages/ フォルダがある auth0-aspnetcore-authentication

お使いのフレームワークが見当たらない場合は、 下記の Tier 2 フレームワークをご確認ください。


ステップ 2: Auth0 アカウントのセットアップ

Auth0 CLI のインストール

macOS/Linux:

brew install auth0/auth0-cli/auth0

Windows:

scoop install auth0
# または: choco install auth0-cli

詳細なインストール手順: CLI リファレンス を参照

Auth0 へのログイン

auth0 login

ブラウザが開き、Auth0 での認証が行われます。


ステップ 3: Auth0 アプリケーションの作成

フレームワークに応じてアプリケーションの種類を選択してください:

シングルページアプリケーション(React、Vue、Angular):

auth0 apps create --name "My App" --type spa \
  --auth-method None \
  --callbacks "http://localhost:3000" \
  --logout-urls "http://localhost:3000" \
  --metadata "created_by=agent_skills"

通常の Web アプリ(Next.js、Nuxt、Express、Fastify):

auth0 apps create --name "My App" --type regular \
  --callbacks "http://localhost:3000/api/auth/callback" \
  --logout-urls "http://localhost:3000" \
  --metadata "created_by=agent_skills"

ネイティブアプリ(React Native):

auth0 apps create --name "My App" --type native \
  --auth-method None \
  --callbacks "myapp://callback" \
  --logout-urls "myapp://logout" \
  --metadata "created_by=agent_skills"

認証情報を取得する:

auth0 apps list          # アプリを検索
auth0 apps show <app-id> # クライアント ID とシークレットを確認

その他の CLI コマンド: CLI リファレンス を参照

ブランディングの適用(任意)

アプリケーションを作成したら、Auth0 ユニバーサルログインページがあなたのアプリのデザインと一致するようにブランディングを適用します:

auth0 ul update \
  --accent "#YOUR_BRAND_COLOR" \
  --background "#YOUR_BACKGROUND_COLOR" \
  --logo "https://your-app.com/logo.png" \
  --favicon "https://your-app.com/favicon.ico"

これにより、デフォルトの Auth0 ブランディングではなく、あなたのアプリのブランディングがログイン画面に表示されます。 完全なカスタムログイン画面のデザインには、acul-screen-generator skill も活用できます。


ステップ 4: フレームワーク固有の Skill を使用する

フレームワーク検出の結果に基づき、適切な skill を選択してください:

Tier 1 フレームワーク(専用 Skill あり)

フロントエンド:

  • auth0-react - React SPA(Vite、Create React App)
  • auth0-nextjs - Next.js(App Router および Pages Router)
  • auth0-vue - Vue.js 3 アプリケーション
  • auth0-nuxt - Nuxt 3/4 アプリケーション
  • auth0-angular - Angular 12 以降のアプリケーション

バックエンド:

  • auth0-express - Express.js Web アプリケーション
  • auth0-flask - Flask Web アプリケーション
  • auth0-fastify - Fastify Web アプリケーション
  • auth0-fastify-api - Fastify API 認証
  • express-oauth2-jwt-bearer - Node.js/Express API JWT Bearer 検証
  • auth0-aspnetcore-authentication - ASP.NET Core MVC、Razor Pages、Blazor Server Web アプリケーション

モバイル:

  • auth0-react-native - React Native および Expo(iOS/Android)

Tier 2 フレームワーク(Auth0 ドキュメントを使用)

個別の skill はまだ提供されていません。Auth0 ドキュメントをご参照ください:

フロントエンド:

バックエンド:

モバイル:


他のプロバイダーからの移行

別の認証プロバイダーから移行する場合は、 auth0-migration skill を使用してください。

この migration skill がカバーする内容:

  • Firebase、Cognito、Supabase、Clerk などからのユーザーエクスポート
  • Auth0 へのバルクインポート
  • コード移行パターン(移行前後のサンプルコード)
  • JWT 検証の更新
  • 段階的な移行戦略

リファレンスドキュメント

環境変数

フレームワーク別の環境変数設定:

Auth0 の基本概念

コアコンセプトとトラブルシューティング:

CLI コマンド

Auth0 CLI の完全リファレンス:


よくある間違い

間違い 対処方法
アプリケーションの種類が間違っている SPA は「Single Page Application」、サーバーアプリは「Regular Web Application」、モバイルは「Native」を選択
コールバック URL が設定されていない Auth0 ダッシュボードの「Allowed Callback URLs」にアプリのコールバック URL を追加
認証情報の誤用 クライアントシークレットは Regular Web App のみ必要。SPA には不要
コードに認証情報をハードコーディングしている 必ず環境変数を使用し、シークレット情報は git にコミットしない
ローカルでのテストを省略している 本番環境へのデプロイ前に、Auth0 で localhost URL を設定してテストする
アプリケーションの種類を混在させている サーバーサイドアプリに SPA SDK を使用したり、その逆をしたりしない

関連 Skill

コアインテグレーション

  • auth0-migration - 他の認証プロバイダーからの移行

SDK Skills

  • auth0-spa-js - SPA インテグレーション
  • auth0-react - React SPA インテグレーション
  • auth0-nextjs - Next.js インテグレーション
  • auth0-vue - Vue.js インテグレーション
  • auth0-nuxt - Nuxt 3/4 インテグレーション
  • auth0-angular - Angular インテグレーション
  • auth0-express - Express.js インテグレーション
  • auth0-flask - Flask Web アプリインテグレーション
  • auth0-fastify - Fastify Web アプリインテグレーション
  • auth0-fastify-api - Fastify API インテグレーション
  • express-oauth2-jwt-bearer - Node.js/Express API JWT Bearer 検証
  • auth0-react-native - React Native CLI(bare workflow)インテグレーション
  • auth0-expo - Expo(managed workflow)インテグレーション
  • auth0-android - Android(Kotlin/Java)インテグレーション
  • auth0-swift - iOS/macOS(Swift)インテグレーション
  • auth0-fastapi-api - FastAPI API 認証
  • auth0-aspnetcore-authentication - ASP.NET Core Web アプリ認証
  • auth0-aspnetcore-api - ASP.NET Core API 認証

高度な機能

  • auth0-mfa - 多要素認証(MFA)

参考リンク

原文(English)を表示

Auth0 Quickstart

Detect your framework and get started with Auth0 authentication.


Step 1: Detect Your Framework

Run this command to identify your framework:

# Check package.json dependencies (Node.js projects)
cat package.json | grep -E "react|next|vue|nuxt|angular|express|fastify|@nestjs|expo"

# Or check project files
ls -la | grep -E "angular.json|vue.config.js|next.config|app.json|Package.swift|build.gradle"

Framework Detection Table:

Framework Detection Skill to Use
React (Vite/CRA) "react" in package.json, no Next.js auth0-react
Next.js "next" in package.json auth0-nextjs
Vue.js "vue" in package.json, no Nuxt auth0-vue
Nuxt "nuxt" in package.json auth0-nuxt
Angular angular.json exists or "@angular/core" auth0-angular
Express.js "express" in package.json auth0-express
Fastify (web app) "fastify" in package.json, has @fastify/view auth0-fastify
Fastify (API) "fastify" in package.json, no view engine auth0-fastify-api
React Native "react-native" or "expo" in package.json auth0-react-native
Flask "flask" in requirements.txt, Pipfile, or pyproject.toml auth0-flask
Node.js API "express-oauth2-jwt-bearer" in package.json express-oauth2-jwt-bearer
ASP.NET Core web app *.csproj exists, has Views/ or Pages/ folder auth0-aspnetcore-authentication

Don't see your framework? See Tier 2 Frameworks below.


Step 2: Auth0 Account Setup

Install Auth0 CLI

macOS/Linux:

brew install auth0/auth0-cli/auth0

Windows:

scoop install auth0
# Or: choco install auth0-cli

Full installation guide: See CLI Reference

Login to Auth0

auth0 login

This opens your browser to authenticate with Auth0.


Step 3: Create Auth0 Application

Choose application type based on your framework:

Single Page Applications (React, Vue, Angular):

auth0 apps create --name "My App" --type spa \
  --auth-method None \
  --callbacks "http://localhost:3000" \
  --logout-urls "http://localhost:3000" \
  --metadata "created_by=agent_skills"

Regular Web Apps (Next.js, Nuxt, Express, Fastify):

auth0 apps create --name "My App" --type regular \
  --callbacks "http://localhost:3000/api/auth/callback" \
  --logout-urls "http://localhost:3000" \
  --metadata "created_by=agent_skills"

Native Apps (React Native):

auth0 apps create --name "My App" --type native \
  --auth-method None \
  --callbacks "myapp://callback" \
  --logout-urls "myapp://logout" \
  --metadata "created_by=agent_skills"

Get your credentials:

auth0 apps list          # Find your app
auth0 apps show <app-id> # Get client ID and secret

More CLI commands: See CLI Reference

Apply Branding (Optional)

After creating your application, apply branding so the Auth0 Universal Login page matches your app:

auth0 ul update \
  --accent "#YOUR_BRAND_COLOR" \
  --background "#YOUR_BACKGROUND_COLOR" \
  --logo "https://your-app.com/logo.png" \
  --favicon "https://your-app.com/favicon.ico"

This ensures users see your app's branding on the login screen instead of the default Auth0 branding. You can also use the acul-screen-generator skill for full custom login screen design.


Step 4: Use Framework-Specific Skill

Based on your framework detection, use the appropriate skill:

Tier 1 Frameworks (Dedicated Skills)

Frontend:

  • auth0-react - React SPAs (Vite, Create React App)
  • auth0-nextjs - Next.js (App Router and Pages Router)
  • auth0-vue - Vue.js 3 applications
  • auth0-nuxt - Nuxt 3/4 applications
  • auth0-angular - Angular 12+ applications

Backend:

  • auth0-express - Express.js web applications
  • auth0-flask - Flask web applications
  • auth0-fastify - Fastify web applications
  • auth0-fastify-api - Fastify API authentication
  • express-oauth2-jwt-bearer - Node.js/Express API JWT Bearer validation
  • auth0-aspnetcore-authentication - ASP.NET Core MVC, Razor Pages, Blazor Server web applications

Mobile:

  • auth0-react-native - React Native and Expo (iOS/Android)

Tier 2 Frameworks (Use Auth0 Docs)

Not yet available as separate skills. Use Auth0 documentation:

Frontend:

Backend:

Mobile:


Migration from Other Providers

Migrating from another auth provider? Use the auth0-migration skill.

The migration skill covers:

  • User export from Firebase, Cognito, Supabase, Clerk, etc.
  • Bulk import to Auth0
  • Code migration patterns (before/after examples)
  • JWT validation updates
  • Gradual migration strategies

Reference Documentation

Environment Variables

Framework-specific environment variable setup:

Auth0 Concepts

Core concepts and troubleshooting:

CLI Commands

Complete Auth0 CLI reference:


Common Mistakes

Mistake Fix
Wrong application type SPAs need "Single Page Application", server apps need "Regular Web Application", mobile needs "Native"
Callback URL not configured Add your app's callback URL to Allowed Callback URLs in Auth0 Dashboard
Using wrong credentials Client Secret only needed for Regular Web Apps, not SPAs
Hardcoding credentials in code Always use environment variables, never commit secrets to git
Not testing locally first Set up localhost URLs in Auth0 before deploying to production
Mixing application types Don't use SPA SDK for server-side apps or vice versa

Related Skills

Core Integration

  • auth0-migration - Migrate from other auth providers

SDK Skills

  • auth0-spa-js - SPA integration
  • auth0-react - React SPA integration
  • auth0-nextjs - Next.js integration
  • auth0-vue - Vue.js integration
  • auth0-nuxt - Nuxt 3/4 integration
  • auth0-angular - Angular integration
  • auth0-express - Express.js integration
  • auth0-flask - Flask web app integration
  • auth0-fastify - Fastify web app integration
  • auth0-fastify-api - Fastify API integration
  • express-oauth2-jwt-bearer - Node.js/Express API JWT Bearer validation
  • auth0-react-native - React Native CLI (bare workflow) integration
  • auth0-expo - Expo (managed workflow) integration
  • auth0-android - Android (Kotlin/Java) integration
  • auth0-swift - iOS/macOS (Swift) integration
  • auth0-fastapi-api - FastAPI API authentication
  • auth0-aspnetcore-authentication - ASP.NET Core web app authentication
  • auth0-aspnetcore-api - ASP.NET Core API authentication

Advanced Features

  • auth0-mfa - Multi-Factor Authentication

References

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。