The 2026 State of Docs survey is live 📝 Whether you write, edit, or just rely on docs, we want to hear from you!
Take the survey
PricingLog inSign up

Auth0 の設定

訪問者向けにAuth0のログイン画面を設定する

適応コンテンツの設定についてはガイドをご覧ください、 完全な手順 Auth0 を使用して認証付きアクセスとアダプティブコンテンツを設定する方法について。

このガイドでは、ドキュメント用の保護されたサインイン画面を設定する手順を説明します。このガイドを進める前に、まず以下を確認してください。 認証付きアクセスの有効化.

Auth0 を使用して GitBook サイトに認証付きアクセスを設定する手順は次のとおりです：

1

Auth0 に新しいアプリケーションを作成する

Auth0 ダッシュボードで Auth0 アプリケーションを作成します。

2

Auth0 統合をインストールして構成する

Auth0 統合をインストールし、必要な構成を GitBook サイトに追加します。

3

アダプティブコンテンツ用に Auth0 を構成する（オプション）

Auth0 を構成して GitBook のアダプティブコンテンツと連携させます。

1. Auth0 に新しいアプリケーションを作成する

まず、Auth0 プラットフォームのダッシュボードで新しいアプリケーションを作成します。このアプリケーションにより、GitBook の Auth0 統合がトークンを要求してユーザーの身元を検証し、サイトへのアクセスを許可できます。

  1. Auth0 にサインインする ダッシュボード.

  2. へ移動してください Applications > Applications 左サイドバーのセクション。

  3. クリックしてください + Create Application ボタンをクリックして、アプリに名前を付けます。

  4. の下で、 アプリケーションタイプを選択します、 選択 Regular Web Applications.

  5. で、 Quickstart 新しく作成したアプリの画面で、選択してください Node.js (Express) と定義し、次に アプリを統合したい.

  6. すると以下のような構成画面が表示されます。 クリックしてください Save Settings And Continue.

  7. クリックしてください 設定 タブを選択して確認できます。

  8. をクリックします。 Domain, クライアント ID および クライアント シークレット.

次のことを確認してください 少なくとも1つの接続が有効になっている Auth0 アプリケーションの Connections タブを選択して確認できます。

2. Auth0 統合をインストールして構成する

Auth0 アプリケーションを作成したら、次のステップは GitBook に Auth0 統合をインストールし、先ほど生成した資格情報を使ってそれを Auth0 アプリケーションにリンクすることです：

  1. 認証付きアクセスを有効にし、Auth0 を ID プロバイダーとして使用したいサイトに移動します。

  2. クリックしてください 統合 サイト設定の右上にあるボタンをクリックします。

  3. クリックしてください 認証されたアクセス サイドバーのカテゴリから。

  4. を選択します Auth0 統合。

  5. クリック このサイトにインストール.

  6. 統合をサイトにインストールした後、統合の構成画面が表示されます：

  7. 次の項目を入力します Domain, クライアント ID および クライアント シークレット 前に Auth0 アプリケーションを作成したときにコピーした値を入力します。Auth0 Domain には Auth0 からコピーした Domain を入力してください（必ずプレフィックスに https://).

  8. （オプション） を有効にする JWT トークンにクレームを含める サイトを有効にしている場合は、ダイアログ下部のオプションを有効にしてください 適応コンテンツ.

  9. をクリックします。 Callback URL をコピーしてください ダイアログの下部に表示されています.

  10. クリック 保存.

  11. 先ほど Auth0 ダッシュボードで作成した Auth0 アプリケーションに戻ります。

  12. 次へ移動してください Applications > Applications サイドバーの中の を選択し、 設定 タブを選択して確認できます。

  13. 下にスクロールして Application URIs 設定のセクション

  14. 貼り付ける Callback URL 先ほど GitBook 統合ダイアログからコピーしたものを Allowed Callback URL 入力欄に貼り付けます。

  15. クリック 保存。

  16. GitBook の Auth0 統合 インストール画面に戻ります 。.

  17. 統合ダイアログを閉じ、サイト画面の 設定 タブをクリックします。

  18. 次へ移動してください オーディエンス をクリックし、 認証付きアクセス （まだ選択されていない場合）。

  19. を開きます Auth0 ドロップダウンの 認証バックエンド セクションから選択します。

  20. クリック オーディエンスを更新.

  21. サイトの概要画面に移動し、サイトがまだ公開されていない場合は 公開 をクリックしてください。

あなたのサイトは現在、Auth0 を ID プロバイダーとして使用した認証付きアクセスの背後に公開されています。

動作を確認するには、をクリックしてください で定義された視覚スタイルを使用します。Auth0 でサインインするよう求められます。これは、あなたのサイトが Auth0 を使った認証付きアクセスの背後に公開されていることを確認するものです。

3. アダプティブコンテンツ用に Auth0 を構成する（オプション）

認証付きアクセスサイトでアダプティブコンテンツ機能を活用するには、 Auth0 アプリケーションを構成して 認証トークンに追加のユーザー情報をクレームとして含めるようにします。

これらのクレームはキーと値のペアとして表され、GitBook に渡されて次のように使用できます： コンテンツを適応させる ために動的に使用されます。

最終更新

役に立ちましたか？