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. の下の アプリケーションの種類を選択し、 選択 通常の Web アプリケーション.

5. の中で クイックスタート 新しく作成したアプリの画面で、 Node.js (Express) と定義し、その後 自分のアプリを統合したい.

6. すると、以下のような設定画面が表示されます。次に、 設定を保存して続行.

   
7. サイト設定の右上にある 設定 タブをクリックします。

8. 次をコピーして控えておいてください。 ドメイン, クライアント ID 、 クライアント シークレット.

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

2. Auth0 インテグレーションをインストールして設定する

Auth0 アプリケーションを作成したら、次の手順として GitBook に Auth0 インテグレーションをインストールし、以前に生成した認証情報を使って Auth0 アプリケーションとリンクします。

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

2. サイト設定の右上にある 連携 ボタンをクリックします。

   
3. クリックします 認証済みアクセス サイドバーのカテゴリから

4. Azure Auth0 を選択します。

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

   
6. サイトに連携をインストールすると、連携の設定画面が表示されます。

   
7. 次の値を入力します ドメイン, クライアント ID 、 クライアント シークレット 以前に Auth0 アプリケーションを作成したときにコピーした値。Auth0 ドメインには、Auth0 からコピーしたドメインを入力します（先頭に https://).

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

9. 次をコピーして控えておいてください。 コールバック URL をコピーして ダイアログの下部に表示される.

10. クリック 保存.

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

12. 次へ移動します アプリケーション > アプリケーション をサイドバーで開き、 設定 タブをクリックします。

13. 下にスクロールして アプリケーション URI 設定セクションを開きます

14. 次を貼り付けます コールバック URL 以前 GitBook インテグレーションのダイアログからコピーしたものを 許可されたコールバック URL 入力欄に貼り付けます。

15. クリック 保存します。

16. 次へ戻ります Auth0 インテグレーション インストール画面へ GitBook で.

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

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

19. 選択してください Auth0 ドロップダウンから 認証バックエンド セクション内で選択します。

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

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

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

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

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

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

これらのクレームはキーと値のペアとして表され、GitBook に渡され、次の用途に使用できます。 コンテンツを適応させる ために、サイト訪問者向けに動的に使用されます。