#### GitBook のログインエンドポイントを使用する
公開サイトにサインインリンクを置きたい場合は、次にリンクしてください。 `/~gitbook/auth/login`.
このエンドポイントは、サイト用に設定された認証バックエンドへ訪問者をリダイレクトします。また、 `location` というクエリパラメータを追加し、訪問者が開始したページに一致させます。
これは、ヘッダーのリンクや、サインイン後に同じページへ訪問者を戻したいその他の入口に便利です。
ログイン URL にリダイレクトするとき、GitBook は `location` というクエリパラメータをログイン URL に含めます。これをハンドラーで利用して、ユーザーを元の場所にリダイレクトできます。
```javascript
const gitbookVisitorJWT = await new jose.SignJWT({})
.setProtectedHeader({ alg: 'HS256' })
.setIssuedAt()
.setExpirationTime('2h') // 任意の 2 時間の有効期限
.sign(new TextEncoder().encode(GITBOOK_VISITOR_SIGNING_KEY));
// JWT を jwt_token クエリパラメータとして含めた元の GitBook ドキュメント URL にリダイレクトする
// location が提供されている場合、ユーザーは元の目的地に戻される
const redirectURL = `${GITBOOK_DOCS_URL}/${req.query.location || ''}?jwt_token=${gitbookVisitorJWT}`;
res.redirect(redirectURL);
```
{% hint style="warning" %}
GitBook は `location` 検索パラメータに依存しているため、ログイン URL では使用できません。たとえば、 `https://auth.gitbook.com/?location=something` は有効なログイン URL ではありません。
{% endhint %}
#### GitBook のログアウトエンドポイントを使用する
公開サイトにサインアウトリンクを置きたい場合は、次にリンクしてください。 `/~gitbook/auth/logout`.
このエンドポイントは訪問者を GitBook セッションからサインアウトさせます。
### 4. マルチテナントの認証済みアクセスを設定する（任意）
GitBook を複数の顧客にコンテンツを提供するプラットフォームとして使用している場合、マルチテナントの認証済みアクセスを設定する必要があるでしょう。認証バックエンドは、複数の異なるサイトにわたる認証を処理する責任を持つ必要があります。これは、カスタム認証バックエンドのコードに少し手を加えるだけで GitBook で実現できます。
#### 認証サーバーにすべてのテナントを追加する
認証バックエンドは、JWT 署名鍵と、処理対象となるすべての GitBook サイトの URL を把握している必要があります。組織内に Customer A と Customer B 用の 2 つのサイトがある場合、認証コードに次のような対応表を保存すると考えられます。
```typescript
const CUSTOMER_A = {
jwtSigningKey: 'aaa-aaa-aaa-aaa',
url: 'https://mycompany.gitbook.io/customer-a'
};
const CUSTOMER_B = {
jwtSigningKey: 'bbb-bbb-bbb-bbb',
url: 'https://mycompany.gitbook.io/customer-b'
};
```
#### 認証サーバーに追加のコンテキストを与える
GitBook がユーザーの要求を認証できない場合、ログイン URL にリダイレクトします。この URL は認証バックエンドを指し、そこでユーザーを認証して要求されたコンテンツへ戻す役割を担います。
複数のテナントをサポートするには、認証バックエンドがユーザーがどの GitBook サイトにアクセスする予定なのかを知る必要があります。この情報はログイン URL で渡せます。
そのため、たとえば各サイトのログイン URL を次のように設定できます。
認証バックエンドはこの情報を確認し、それに応じて正しいサイトへのリダイレクトを処理できます。
```javascript
const customerInfo = req.query.site === 'customer-a' ? CUSTOMER_A : CUSTOMER_B;
const gitbookVisitorJWT = await new jose.SignJWT({})
.setProtectedHeader({ alg: 'HS256' })
.setIssuedAt()
.setExpirationTime('2h') // 任意の 2 時間の有効期限
.sign(new TextEncoder().encode(customerInfo.jwtSigningKey));
// JWT を jwt_token クエリパラメータとして含めた元の GitBook ドキュメント URL にリダイレクトする
// location が提供されている場合、ユーザーは元の目的地に戻される
const redirectURL = `${customerInfo.url}/${req.query.location || ''}?jwt_token=${gitbookVisitorJWT}`;
res.redirect(redirectURL);
```
### 5. 適応型コンテンツ用にバックエンドを設定する（任意）
認証済みアクセスの設定で Adaptive Content 機能を活用するには、カスタムバックエンドが生成する JWT のペイロードに追加のユーザー属性（クレーム）を含め、サイトへユーザーをリダイレクトする際に URL に含めることができます。
これらのクレームは JWT に含められると、GitBook によって [コンテンツを適応させる](/docs/documentation/ja-gitbook-documentation/suru-1/adaptive-content/adapting-your-content.md) ために使われます。
全体をまとめると、次のコード例は、これらのクレームを JWT に含める方法を示しています。これらは GitBook が訪問者向けにコンテンツを適応させるために使用できます。
{% code title="index.ts" %}
```typescript
import { Request, Response } from 'express';
import * as jose from 'jose';
import { getUserInfo } from '../services/user-info-service';
import { getFeatureFlags } from '../services/feature-flags-service';
const GITBOOK_VISITOR_SIGNING_KEY = process.env.GITBOOK_VISITOR_SIGNING_KEY!;
const GITBOOK_DOCS_URL = 'https://mycompany.gitbook.io/myspace';
export async function handleAppLoginRequest(req: Request, res: Response) {
// ログイン要求を処理するためのビジネスロジック
// たとえば、資格情報を確認してユーザーを認証する
//
// 例:
// const loggedInUser = await authenticateUser(req.body.username, req.body.password);
// この例では、ログイン済みユーザーオブジェクトがあるものとする
const loggedInUser = { id: '12345' }; // 実際の認証ロジックに置き換えてください
// GitBook に渡すユーザー情報を取得する
const userInfo = await getUserInfo(loggedInUser.id);
// 署名付き JWT を生成し、ユーザー属性をクレームとして含める
const gitbookVisitorClaims = {
firstName: userInfo.firstName,
lastName: userInfo.lastName,
isBetaUser: userInfo.isBetaUser,
products: userInfo.products.map((product) => product.name),
featureFlags: await getFeatureFlags({ userId: loggedInUser.id })
};
const gitbookVisitorJWT = await new jose.SignJWT(gitbookVisitorClaims)
.setProtectedHeader({ alg: 'HS256' })
.setIssuedAt()
.setExpirationTime('2h') // 任意の 2 時間の有効期限
.sign(new TextEncoder().encode(GITBOOK_VISITOR_SIGNING_KEY));
// URL に JWT トークンを含めてユーザーを GitBook にリダイレクトする
const redirectURL = `${GITBOOK_DOCS_URL}/?jwt_token=${gitbookVisitorJWT}`;
res.redirect(redirectURL);
}
```
{% endcode %}
GitBook に送る適切なクレームを設定・構成したら、「[コンテンツの適応](/docs/documentation/ja-gitbook-documentation/suru-1/adaptive-content/adapting-your-content.md)」に移動して、サイトの設定を続けてください。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/suru-1/site-audience/authenticated-access/setting-up-a-custom-backend.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
