Skip to content

auth0の導入 - #178

Merged
Justhiro55 merged 5 commits into
developfrom
feature/auth0-integration
Jan 13, 2026
Merged

Justhiro55 merged 5 commits into
developfrom
feature/auth0-integration

Conversation

@Justhiro55

@Justhiro55 Justhiro55 commented Dec 14, 2025 •

Copy link
Copy Markdown
Collaborator

概要

Auth0 JWT認証の実装とユーザー同期エンドポイントの追加

詳細

Auth0導入による変更

1. 認証方式

  • カスタムJWT生成を廃止し、Auth0 JWT検証に移行
  • ユーザー管理: auth0_sub をユニークキーとして使用
  • 新規ユーザー: Auth0認証後、/auth/sync で自動作成

2. エンドポイント構成

  • /auth/sync (POST): Auth0トークン検証のみ(新規ユーザー同期用)
  • その他保護ルート: Auth0トークン検証 + ユーザー存在チェック

3. ユーザー情報管理

  • users テーブルに auth0_sub カラム追加
  • プロフィールフィールド追加: familyName, firstName, grade, course

主な実装内容

Auth0 JWT検証ミドルウェア

  • app/interfaces/middleware/auth0.go を新規作成
  • go-jwt-middleware/v2 を使用してJWT検証
  • Auth0の公開鍵で署名検証、クレーム検証

ユーザー同期エンドポイント

  • POST /auth/sync: Auth0ユーザー情報(sub, email, name, picture)を受け取る
  • auth0_sub で検索 → 存在すれば userID 返却、なければ新規作成

データベース変更

  • マイグレーション: users テーブルに auth0_sub VARCHAR(255) UNIQUE 追加
  • ロールバック対応: down.sql で auth0_sub カラム削除

プロフィール対応

  • userinfo エンティティに FamilyName, FirstName, Grade, Course 追加
  • PUT /userinfo/{userID} でプロフィール更新可能

ルート分離

// Auth0トークンのみ(新規ユーザー同期)
s.Router.Group(func(mux chi.Router) {
    mux.Use(middleware.EnsureValidToken())
    mux.Post("/auth/sync", authHandler.SyncUser)
})

// Auth0トークン + ユーザー存在チェック(既存ユーザー)
s.Router.Group(func(mux chi.Router) {
    mux.Use(middleware.EnsureValidToken())
    mux.Use(middleware.SetUserID(authRepository))
    // ... 保護ルート
})

その他

環境変数

AUTH0_DOMAIN=your-tenant.auth0.com
AUTH0_AUDIENCE=https://funport-api
ENVIRONMENT=development

注意点

  • フロントエンドの Auth0統合PR と合わせて動作
  • 既存の /auth/login, /auth/signup エンドポイントは残存(後で削除予定)
  • auth0_sub は UNIQUE 制約付き(重複登録防止)

@Justhiro55 Justhiro55 self-assigned this Dec 14, 2025
@Justhiro55

Justhiro55 commented Dec 14, 2025 •

Copy link
Copy Markdown
Collaborator Author

Auth0導入によるフロー変更

ユーザー作成・認証

導入前: /auth/signup → バックエンドでJWT生成 → レスポンスでトークン返却

導入後: Auth0で認証 → /auth/sync → auth0_sub で検索(なければ新規作成) → userID 返却

保護ルートへのアクセス

導入前: リクエストヘッダーのトークン → カスタムJWT検証 → ユーザーID取得

導入後: リクエストヘッダーのトークン → Auth0 JWT検証 → auth0_sub 取得 → ユーザー検索

実装詳細

Auth0 JWT検証ミドルウェア

  • go-jwt-middleware/v2 と jwks-rsa を使用
  • Auth0の .well-known/jwks.json から公開鍵を取得
  • RS256アルゴリズムで署名検証
  • Audience(AUTH0_AUDIENCE)とIssuer(https://{AUTH0_DOMAIN}/)を検証

ユーザー同期ロジック

1. auth0_sub で検索
2. 存在する → userID返却
3. 存在しない → 新規ユーザー作成
   - auth0_sub, email, mail(Auth0のemail)を保存
   - name, picture はプロフィール更新時に使用
4. userID返却

データベーススキーマ

ALTER TABLE users ADD COLUMN auth0_sub VARCHAR(255) UNIQUE;
  • UNIQUE 制約で重複防止
  • 既存データは NULL を許可

エンドポイント分離の意図

  • /auth/sync: 新規ユーザーはまだDBに存在しないため、SetUserID ミドルウェアを通さない
  • その他の保護ルート: 既存ユーザーのみアクセス可能

注意点

  • 既存エンドポイント: /auth/login, /auth/signup は削除していない(後で削除予定)
  • auth0_sub の形式: auth0|xxxxx または google-oauth2|xxxxx など
  • マイグレーション: 既存データには auth0_sub が NULL(Auth0移行時に手動で紐付けが必要な場合あり)

@Justhiro55
Justhiro55 merged commit 08c6f6a into develop Jan 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant