key認証済みアクセス

公開コンテンツ用にカスタム認証を設定する

認証付きアクセスを使用すると、コンテンツを公開しながら、閲覧したい訪問者に認証を求めることができます。有効にすると、GitBook は認証プロバイダーにコンテンツへのアクセス権を持つユーザーの管理を任せます。

A screenshot showing a login screen for docs behind authenticated access
公開済みのドキュメントにサインインを追加します。

ユースケース

認証付きアクセスの一般的なユースケースには次のものがあります:

  • 有料顧客、営業見込み客、またはパートナーのみがアクセスできるべき機密性の高い製品ドキュメントを公開する。

  • 自社の従業員のみがアクセスできるべき社内ナレッジベースのコンテンツを公開する。

仕組み

認証付きアクセスを設定する際に選択できる方法は 2 つあります:

  1. 認証統合のいずれかをインストールする — 現在、Okta、Azure、Auth0 をサポートしています。私たちは 強く推奨します サポート対象の認証プロバイダーを使用している場合は、このオプションを選んでください。

  2. 認証を処理するために独自のサーバーを作成してホストします。さまざまな技術を使用できますが、選択したソリューションの実装と保守はあなた次第です。

組み込みのログインおよびログアウト URL

GitBook は、公開サイトでのサインインおよびサインアウト用の組み込み URL を提供します:

  • <publishedSiteURL>/~gitbook/auth/login

  • <publishedSiteURL>/~gitbook/auth/logout

ログイン URL は、サイトのヘッダーリンクなど、サインインリンクを置きたい場所でどこでも使用できます。

訪問者がログイン URL を開くと、GitBook はそのサイト用に設定された認証バックエンドへリダイレクトします。これは、統合バックエンドとカスタムバックエンドの両方で機能します。

GitBook はまた、 location 訪問者が最初に開いたページに一致するクエリパラメータを追加します。バックエンドはその値を使用して、サインイン後に同じページへ戻すことができます。

ログアウト URL を使用して、訪問者を GitBook セッションからサインアウトさせます。

次へ移動します 認証済みアクセスを有効にする サイトの保護されたアクセスの設定を開始するには

最終更新

役に立ちましたか?