> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/org/sso/sso-cloudflare-access.md).

# Cloudflare Access 連携

Cloudflare Zero Trust を利用する組織では、メンバーが Cloudflare Access の認証を経て MaiAgent にログインできます。設定項目（Team Name、AUD Tag、メールドメイン、メンバーの自動作成）、ログインの流れ、エラーメッセージについて説明します。

社内システムへのアクセス管理に Cloudflare Zero Trust Access を利用している場合は、Cloudflare Access を MaiAgent の外部ログイン方法として設定できます。メンバーがログインリンクを開くと、まず Cloudflare Access（および Access に接続されている社内の ID プロバイダー）で認証を行い、その後 MaiAgent に自動的にログインします。

**対象**：Cloudflare Zero Trust Access をすでに利用しており、同じログインポリシーとアクセスポリシーを引き続き使用したい企業です。

## 利用条件 <a href="#requirements" id="requirements"></a>

* 組織がエンタープライズプランを利用している必要があります。それ以外のプランでは、<mark style="color:blue;">管理操作</mark>に<mark style="color:blue;">外部ログイン設定</mark>は表示されません。
* 認証設定を保存できるのは組織のオーナーのみです。
* 各組織で同時に使用できる認証タイプは 1 つだけです。切り替えによる影響については、[認証タイプの切り替え](https://docs.maiagent.ai/maiagent-user-guide/ja/org/sso.md#switch-auth-type)をご覧ください。

## 仕組み <a href="#how-it-works" id="how-it-works"></a>

1. メンバーが MaiAgent で生成されたログインリンクを開きます。
2. MaiAgent は、設定された<mark style="color:blue;">サーバー URL</mark>、つまり Cloudflare Access で保護された入口 URL にメンバーをリダイレクトします。
3. Cloudflare Access がリクエストを受け止め、社内の Access ポリシーに従ってメンバーにログインを求めます。
4. 認証が成功すると、Cloudflare は ID トークンを付けたリクエストを MaiAgent に転送します。MaiAgent は <mark style="color:blue;">Team Name</mark> を使って Cloudflare の公開鍵を取得し、署名を検証するとともに、<mark style="color:blue;">Application Audience (AUD) Tag</mark> を照合します。
5. MaiAgent はトークン内のメールアドレスに対応するアカウントを検索し（設定に応じて自動作成し）、メンバーを MaiAgent にログインさせます。

## 事前準備 <a href="#prerequisites" id="prerequisites"></a>

Cloudflare Zero Trust 側で、以下の情報を準備してください。

| 項目                 | 説明                                                                                                                                        |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Team Name          | Zero Trust のチーム名です。チームドメインが `acme.cloudflareaccess.com` の場合、チーム名は `acme` です                                                               |
| Access Application | 入口 URL を保護する Access アプリケーションです。ログインのコールバックパスは `/api/auth/cloudflare/<認證來源名稱>/callback/` です。このパスをアプリケーションで保護し、リクエストを MaiAgent に転送する必要があります |
| AUD Tag            | 上記の Access Application の Application Audience (AUD) Tag です                                                                                |

{% hint style="warning" %}
入口 URL から MaiAgent にリクエストを転送する方法は、組織のデプロイ構成によって異なります。設定前に、入口 URL と転送方法を MaiAgent の担当者に確認してください。
{% endhint %}

## MaiAgent での設定 <a href="#configure-in-maiagent" id="configure-in-maiagent"></a>

1. 左側のメニューで<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概要</mark>をクリックし、<mark style="color:blue;">管理操作</mark>セクションの<mark style="color:blue;">外部ログイン設定</mark>をクリックします。
2. 認証タイプのカードから <mark style="color:blue;">Cloudflare Access</mark> を選択すると、その下に <mark style="color:blue;">Cloudflare Access 設定</mark>が表示されます。
3. 下表の項目を入力して<mark style="color:blue;">保存</mark>をクリックすると、<mark style="color:blue;">認証方法の変更確認</mark>が表示されます。注意事項を確認してから、<mark style="color:blue;">変更を確定</mark>をクリックします。

| 項目                                                              | 必須  | 説明                                                                                                                                                                                                                          |
| --------------------------------------------------------------- | --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">認証ソース名</mark>                         | はい  | 認証ソースを識別する一意の名前で、ログインリンクの一部になります。使用できるのは英小文字、数字、ハイフン（-）のみで、最大 31 文字です。`maiagent` は使用できません。他の認証タイプと同じルールが適用されます。詳しくは[認証ソース名のルール](https://docs.maiagent.ai/maiagent-user-guide/ja/org/sso.md#auth-source-naming-rules)をご覧ください |
| <mark style="color:blue;">サーバー URL</mark>                       | はい  | Cloudflare Access で保護された入口 URL です。例：`https://portal.acme.com`                                                                                                                                                               |
| <mark style="color:blue;">Team Name</mark>                      | はい  | Cloudflare Zero Trust のチーム名です。例：`acme`                                                                                                                                                                                      |
| <mark style="color:blue;">Application Audience (AUD) Tag</mark> | はい  | Access Application の AUD Tag です                                                                                                                                                                                             |
| <mark style="color:blue;">メールドメイン</mark>                        | いいえ | 設定すると、このドメインのメールアドレスのみがこの認証ソース経由でログインできます。例：`acme.com`。同じドメインを他の組織の認証ソースで同時に使用することはできません                                                                                                                                    |
| <mark style="color:blue;">メンバーを自動作成</mark>                      | いいえ | デフォルトではオフです。動作については[アカウントの照合](#account-matching)をご覧ください                                                                                                                                                                     |

## ログインリンク <a href="#login-url" id="login-url"></a>

保存すると、<mark style="color:blue;">ログインリンク</mark>セクションに<mark style="color:blue;">ログイン URL</mark> が生成されます。コピーしてメンバーに共有してください。メンバーはこのリンクを開くと Cloudflare Access 経由でログインできます。保存前は「先に設定を保存してください。ログインリンクが自動的に生成されます」と表示されます。

{% hint style="info" %}
ログインページでメールアドレスを入力した後にシングルサインオンへ自動的にリダイレクトする機能は、SAML のみに対応しています。Cloudflare Access を利用するメンバーは、ログインリンクを直接使用してください。社内ポータルへの掲載やブックマークへの登録などで共有できます。
{% endhint %}

## アカウントの照合 <a href="#account-matching" id="account-matching"></a>

MaiAgent は Cloudflare で認証されたメールアドレスでアカウントを照合し、<mark style="color:blue;">メンバーを自動作成</mark>の設定に基づいてログインを許可するか判断します。

| 状況                                    | メンバーを自動作成：オフ | メンバーを自動作成：オン                                               |
| ------------------------------------- | ------------ | ---------------------------------------------------------- |
| すでにこの組織のメンバーです                        | ログインします      | ログインします                                                    |
| MaiAgent アカウントはありますが、この組織のメンバーではありません | ログインを拒否します   | この組織に追加してからログインします                                         |
| MaiAgent アカウントがまだありません                | ログインを拒否します   | アカウントを作成し、この組織に追加してからログインします。表示名のデフォルトはメールアドレスの @ より前の部分です |
| メールアドレスが設定されたメールドメインに属していません          | ログインを拒否します   | ログインを拒否します                                                 |

MaiAgent アカウントをすでに持っているメンバーは、アカウントとパスワードなど、従来のログイン方法も引き続き使用できます。Cloudflare Access はログインの入口を追加するものです。

## ログイン失敗時のメッセージ <a href="#error-messages" id="error-messages"></a>

| 画面のメッセージ                     | 主な原因                                                                             | 対処方法                                                                             |
| ---------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| 認証に失敗しました。再度ログインしてください       | リクエストに Cloudflare の ID トークンが含まれていないか、トークンの検証に失敗しています（Team Name または AUD Tag の不一致） | コールバックパスが Access Application で保護されていることと、両方の項目が Cloudflare 側の値と一致していることを確認してください |
| このアカウントには、この組織へのアクセス権限がありません | アカウントがこの組織のメンバーではなく、メンバーの自動作成もオフになっているか、メールアドレスが設定されたドメインに属していません                | 事前にメンバーを組織に追加するか、<mark style="color:blue;">メンバーを自動作成</mark>をオンにしてください            |
| このログイン方法は現在無効です              | この認証ソース経由のログインが無効になっています                                                         | MaiAgent の担当者にお問い合わせください                                                         |
| ログインがタイムアウトしました。再度ログインしてください | ワンタイムログインコードが使用済みか、有効期限が切れています。ログイン中のページを再読み込みした場合などに発生します                       | <mark style="color:blue;">再ログイン</mark>をクリックして、もう一度お試しください                        |
| ログイン処理が完了していません。再度ログインしてください | Cloudflare 認証を経ずにコールバックページを直接開いたか、処理が途中で中断されました                                  | ログインリンクカードの URL からやり直してください                                                      |

## よくある質問 <a href="#faq" id="faq"></a>

#### Q：MaiAgent からログアウトすると、Cloudflare Access からもログアウトしますか？ <a href="#faq-logout" id="faq-logout"></a>

いいえ。ログアウトで終了するのは MaiAgent のログイン状態のみです。Cloudflare Access のログイン状態は、社内で設定された Cloudflare のセッション設定に従います。

#### Q：特定のドメインの社員だけがログインできるようにできますか？ <a href="#faq-restrict-domain" id="faq-restrict-domain"></a>

はい。<mark style="color:blue;">メールドメイン</mark>を設定すると、他のドメインのメールアドレスは Cloudflare の認証に成功しても拒否されます。特定の部署のみにアクセスを許可するなど、より詳細なアクセスルールは Cloudflare Access のポリシーで設定してください。

#### Q：保存時に「このメールドメインはすでに使用されています」と表示される場合は？ <a href="#faq-domain-in-use" id="faq-domain-in-use"></a>

このドメインは別の認証ソースですでに使用されています。1 つのドメインに対応できる認証ソースは 1 つだけです。別のドメインを使用するか、空欄にしてドメインを制限しない設定にしてください。

## 関連ドキュメント <a href="#further-reading" id="further-reading"></a>

* [外部ログイン（SSO）](https://docs.maiagent.ai/maiagent-user-guide/ja/org/sso.md)：認証タイプの概要と切り替えによる影響を説明します
* [メンバー管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/member.md)：事前にメンバーを組織に追加する方法を説明します
* [ロールと権限の管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/org/sso/sso-cloudflare-access.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
