Auth0の設定

ドキュメント訪問者向けのAuth0ログイン画面を設定します

ガイドを見て、 詳細な手順 Auth0 を使用した認証付きアクセスとアダプティブ コンテンツの設定について。

このガイドでは、ドキュメント用の保護されたサインイン画面の設定方法を説明します。このガイドに進む前に、まず次の手順を完了していることを確認してください 認証済みアクセスを有効にする.

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

1

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

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

2

Auth0 連携をインストールして設定する

Auth0 連携をインストールし、必要な設定を GitBook サイトに追加します。

3

アダプティブ コンテンツ用に Auth0 を設定する（任意）

GitBook のアダプティブ コンテンツで動作するように Auth0 を設定します。

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

まず、Auth0 プラットフォームのダッシュボードで新しいアプリケーションを作成します。このアプリケーションにより、GitBook Auth0 連携は、サイトへのアクセスを許可する前にユーザーの本人確認を行うためのトークンを要求することができます。

1. Auth0 にサインインする ダッシュボード.
2. に移動します アプリケーション > アプリケーション を左サイドバーから開きます。
3. 次をクリックします + アプリケーションを作成 ボタンをクリックし、アプリに名前を付けます。
4. の下の アプリケーションの種類を選択し、 選択して Regular Web Applications.
5. 次の場所で クイックスタート 新しく作成したアプリの画面で、 Node.js（Express） を選び、次に 自分のアプリを統合したい.
6. その後、下のような設定画面が表示されます。 設定を保存して続行.

   
7. 次をクリックします 設定 タブから選択することで、セクション内のどこでも参照できます。
8. コピーして以下を控えてください ドメイン, クライアント ID 、 クライアント シークレット.

次の点を確認してください： 少なくとも 1 つの接続が有効になっていること Auth0 アプリケーションの 接続 タブから選択することで、セクション内のどこでも参照できます。

2. Auth0 連携をインストールして設定する

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

1. 認証付きアクセスを有効にし、ID プロバイダーとして Auth0 を使用したいサイトに移動します。
2. 次をクリックします 統合 サイト設定の右上にあるボタン。

   
3. をクリックします 認証済みアクセス サイドバーのカテゴリから。
4. 次を選択します Auth0 連携。
5. クリックして このサイトにインストール.

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

   
7. 次を入力します ドメイン, クライアント ID 、 クライアント シークレット 先ほど Auth0 アプリケーションを作成した際にコピーした値。Auth0 Domain には、Auth0 からコピーした Domain を入力します（先頭に https://).
8. （任意） 次の項目を有効にします： JWT トークンにクレームを含める サイトで次を有効にしている場合は、ダイアログ下部のオプションを アダプティブコンテンツ.
9. コピーして以下を控えてください Callback URL 表示されている ダイアログの下部にある.
10. クリックして 保存.
11. Auth0 ダッシュボードで先ほど作成した Auth0 アプリケーションに戻ります。
12. 次へ移動します アプリケーション > アプリケーション をサイドバーで開き、 設定 タブから選択することで、セクション内のどこでも参照できます。
13. までスクロールし、 Application URIs 設定セクションを表示します
14. 次の項目を貼り付けます： Callback URL 先ほど GitBook 連携ダイアログからコピーしたものを、 Allowed Callback URL 入力欄に。
15. クリックして 保存します。
16. 次に戻ります Auth0 連携 インストール画面 GitBook の.
17. 統合ダイアログを閉じ、次をクリックします 設定 サイドバーのタブ。
18. 次へ移動します 対象 をクリックして、次を選択します 認証アクセス （まだ選択されていない場合）。
19. を選択します Auth0 のドロップダウンから 認証バックエンド セクションを選択します。
20. クリックして 対象を更新.
21. サイトの概要画面に移動し、次をクリックします 公開 まだ公開されていない場合。

これで、ID プロバイダーとして Auth0 を使用した認証付きアクセスの背後でサイトが公開されました。

動作を確認するには、次をクリックします： 訪れて。Auth0 でのサインインを求められ、これにより、サイトが Auth0 を使用した認証付きアクセスの背後で公開されていることが確認されます。

3. アダプティブ コンテンツ用に Auth0 を設定する（任意）

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

これらのクレームはキーとバリューのペアとして表され、GitBook に渡されて、次の用途に使用できます コンテンツを適応させる ために使われます。