Files
Q-A_test/apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/02-developer-guide/03-oauth-integration.md
T
SDI 12e4f17b62
CI / typecheck (push) Successful in 1m8s
CI / format (push) Failing after 1m6s
CI / lint (push) Failing after 49s
CI / test (push) Failing after 1m8s
first commit
2026-07-15 18:05:12 +09:00

7.5 KiB
Raw Blame History

sidebar_position, title, description
sidebar_position title description
3 OAuth統合 Google OAuthおよびカスタムOAuthプロバイダーによるシングルサインオン(SSO)統合方法を案内します。

OAuth統合

ABC User FeedbackでOAuth 2.0ベースのシングルサインオン(SSO)を設定すると、ユーザーは別のアカウント作成なしで既存のアカウント(Google、Microsoft、GitHubなど)でログインできます。これはユーザーの利便性を向上させ、企業環境で統合認証を実装するために不可欠です。


OAuth統合の概要

ABC User FeedbackでサポートされるOAuth方式:

1. Google OAuth

  • 追加設定なしでデフォルト提供
  • Googleアカウントによる簡単なログイン

2. カスタムOAuthプロバイダー

  • 社内認証システム
  • その他のOAuth 2.0/OpenID Connect互換サービス

OAuthを設定すると、既存のメールログインと並行して使用でき、組織ポリシーに応じてOAuthのみを許可するように制限することもできます。


Google OAuth統合設定

Google Cloud Consoleでの設定

1. Google Cloud Consoleにアクセス

Google Cloud Consoleにアクセスしてプロジェクトを作成するか、既存のプロジェクトを選択します。

2. OAuth 2.0クライアントID作成

  1. APIとサービス > 認証情報メニューに移動
  2. + 認証情報を作成 > OAuthクライアントIDを選択
  3. アプリケーションタイプをウェブアプリケーションとして選択

3. 承認済みリダイレクトURI設定

承認済みリダイレクトURIに次のURLを追加します:

https://your-domain.com/auth/oauth-callback

例:

  • https://feedback.company.com/auth/oauth-callback
  • http://localhost:3000/auth/oauth-callback(開発環境)

4. クライアント情報確認

作成完了後、次の情報を確認してコピーしておきます:

  • クライアントID: 1234567890-abc123def456.apps.googleusercontent.com
  • クライアントシークレット: GOCSPX-abcdef123456

ABC User FeedbackでのGoogle OAuth設定

Google OAuthを使用するには、次の手順に従って設定する必要があります:

1. Google OAuth設定有効化

Settings > Login Managementで:

  1. OAuth2.0 Loginトグルを有効化
  2. Login Button Typeを"Google Login"として選択
  3. Google Cloud Consoleで取得した情報を入力:
    • Client ID: Google Cloud Consoleで作成したクライアントID
    • Client Secret: Google Cloud Consoleで作成したクライアントシークレット
    • Authorization Code Request URL: https://accounts.google.com/o/oauth2/v2/auth
    • Scope: openid email profile
    • Access Token URL: https://oauth2.googleapis.com/token
    • User Profile Request URL: https://www.googleapis.com/oauth2/v2/userinfo
    • Email Key: email

2. リダイレクトURI登録

Google Cloud Consoleで次のURLを承認済みリダイレクトURIに追加:

https://your-domain.com/auth/oauth-callback

開発環境の場合:

http://localhost:3000/auth/oauth-callback

カスタムOAuthプロバイダー統合

社内認証システム統合

ABC User Feedbackは、企業環境で使用される社内認証システムと統合できます。ほとんどの社内認証システムはOAuth 2.0またはOpenID Connect標準をサポートしているため、標準OAuthフローを通じて統合が可能です。

社内認証システム設定要件

社内認証システムと統合するには、次の情報が必要です:

  1. OAuthクライアント登録

    • クライアントID
    • クライアントシークレット
    • リダイレクトURI: https://your-domain.com/auth/oauth-callback
  2. OAuthエンドポイント情報

    • Authorization URL(認証リクエストURL
    • Token URL(トークン交換URL
    • User Info URL(ユーザー情報照会URL)
  3. 権限範囲(Scope

    • ユーザープロフィール情報アクセス権限
    • メールアドレスアクセス権限

一般的な社内認証システム例

項目 説明 社内システム例
Login Button Type ログインボタンタイプ CUSTOM
Login Button Name ログインボタンに表示される名前 社内アカウントでログイン
Client ID OAuthクライアントID company-auth-client-123
Client Secret クライアントシークレット company-secret-abc123
Authorization Code Request URL ユーザー認証リクエストURL https://auth.company.com/oauth/authorize
Scope リクエストする権限範囲 openid email profile
Access Token URL トークンリクエストURL https://auth.company.com/oauth/token
User Profile Request URL ユーザー情報照会API https://auth.company.com/api/user
Email Key ユーザー情報JSONのメールフィールド名 emailまたはmail

その他のOAuth 2.0/OpenID Connect互換サービス

ABC User Feedbackは、OAuth 2.0またはOpenID Connect標準に準拠するすべての認証サービスと統合できます。

サポート可能なサービスタイプ

  • OpenID Connectプロバイダー: 標準OpenID Connectプロトコルをサポートするサービス
  • OAuth 2.0プロバイダー: OAuth 2.0 Authorization Codeフローをサポートするサービス
  • カスタム認証サーバー: 標準OAuthエンドポイントを提供する自己構築サービス

統合設定方法

Settings > Login ManagementでカスタムOAuthを設定します:

  1. 管理者アカウントでログイン後、Settings > Login Managementメニューに移動
  2. OAuth2.0 Loginトグルを有効化
  3. Login Button TypeCUSTOMとして選択
  4. 認証サービスプロバイダーから受け取った情報を入力:
    • Login Button Name: ログインボタンに表示されるテキスト(例:「社内アカウントでログイン」)
    • Client ID: OAuthクライアント識別子
    • Client Secret: クライアント認証シークレット
    • Authorization Code Request URL: ユーザー認証リクエストURL
    • Scope: リクエストする権限範囲(スペース区切り、例:「openid email profile」)
    • Access Token URL: アクセストークンリクエストURL
    • User Profile Request URL: ユーザープロフィール情報照会URL
    • Email Key: ユーザー情報JSONのメールフィールド名(例:「email」または「mail」)

関連ドキュメント