Auth0 の設定

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

circle-info

ガイドを確認して、 完全な手順arrow-up-right Auth0 を使って認証済みアクセスとアダプティブコンテンツを設定する方法。

circle-exclamation

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

1

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

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

2

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

Auth0 インテグレーションをインストールし、必要な設定を GitBook サイトに追加します。

3

Auth0 をアダプティブコンテンツ用に設定する(オプション)

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

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

まず、Auth0 プラットフォームのダッシュボードで新しいアプリケーションを作成します。このアプリケーションにより、GitBook の Auth0 インテグレーションは、サイトへのアクセスを許可する前にユーザーの身元を検証するためのトークンを要求できるようになります。

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

  2. 次へ移動します アプリケーション > アプリケーション セクションを左サイドバーから開きます。

  3. 次をクリックします + アプリケーションを作成 ボタンをクリックし、アプリに名前を付けます。

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

  5. 内で、 クイックスタート 新しく作成したアプリの画面で、 Node.js (Express) に定義し、さらに I want to integrated my app.

  6. その後、以下のような設定画面が表示されます。 クリックしてください Save Settings And Continue.

  7. 次をクリックします 設定 タブを選択することで見つけて再度開くことができます。

  8. 次の項目をコピーして控えておいてください Domain, Client IDClient Secret.

circle-exclamation

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

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

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

  2. 次をクリックします Integrations ボタンをサイト設定の右上にあるものから。

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

  4. 次を選択します Auth0 連携。

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

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

  7. 次を入力します Domain, Client IDClient Secret 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. 次へ移動します Audience をクリックし、開いたパネルで 認証付きアクセス (まだ選択されていない場合)。

  19. 選択 Auth0 ドロップダウンから Authentication backend セクションを選択します。

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

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

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

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

3. Auth0 をアダプティブコンテンツ用に設定する(オプション)

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

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

最終更新

役に立ちましたか?