For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 をすでに利用しており、同じログインポリシーとアクセスポリシーを引き続き使用したい企業です。

利用条件

  • 組織がエンタープライズプランを利用している必要があります。それ以外のプランでは、管理操作に外部ログイン設定は表示されません。

  • 認証設定を保存できるのは組織のオーナーのみです。

  • 各組織で同時に使用できる認証タイプは 1 つだけです。切り替えによる影響については、認証タイプの切り替えをご覧ください。

仕組み

  1. メンバーが MaiAgent で生成されたログインリンクを開きます。

  2. MaiAgent は、設定されたサーバー URL、つまり Cloudflare Access で保護された入口 URL にメンバーをリダイレクトします。

  3. Cloudflare Access がリクエストを受け止め、社内の Access ポリシーに従ってメンバーにログインを求めます。

  4. 認証が成功すると、Cloudflare は ID トークンを付けたリクエストを MaiAgent に転送します。MaiAgent は Team Name を使って Cloudflare の公開鍵を取得し、署名を検証するとともに、Application Audience (AUD) Tag を照合します。

  5. MaiAgent はトークン内のメールアドレスに対応するアカウントを検索し(設定に応じて自動作成し)、メンバーを MaiAgent にログインさせます。

事前準備

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 です

MaiAgent での設定

  1. 左側のメニューで組織設定 → 組織概要をクリックし、管理操作セクションの外部ログイン設定をクリックします。

  2. 認証タイプのカードから Cloudflare Access を選択すると、その下に Cloudflare Access 設定が表示されます。

  3. 下表の項目を入力して保存をクリックすると、認証方法の変更確認が表示されます。注意事項を確認してから、変更を確定をクリックします。

項目
必須
説明

認証ソース名

はい

認証ソースを識別する一意の名前で、ログインリンクの一部になります。使用できるのは英小文字、数字、ハイフン(-)のみで、最大 31 文字です。maiagent は使用できません。他の認証タイプと同じルールが適用されます。詳しくは認証ソース名のルールをご覧ください

サーバー URL

はい

Cloudflare Access で保護された入口 URL です。例:https://portal.acme.com

Team Name

はい

Cloudflare Zero Trust のチーム名です。例:acme

Application Audience (AUD) Tag

はい

Access Application の AUD Tag です

メールドメイン

いいえ

設定すると、このドメインのメールアドレスのみがこの認証ソース経由でログインできます。例:acme.com。同じドメインを他の組織の認証ソースで同時に使用することはできません

メンバーを自動作成

いいえ

デフォルトではオフです。動作についてはアカウントの照合をご覧ください

ログインリンク

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

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

アカウントの照合

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

状況
メンバーを自動作成:オフ
メンバーを自動作成:オン

すでにこの組織のメンバーです

ログインします

ログインします

MaiAgent アカウントはありますが、この組織のメンバーではありません

ログインを拒否します

この組織に追加してからログインします

MaiAgent アカウントがまだありません

ログインを拒否します

アカウントを作成し、この組織に追加してからログインします。表示名のデフォルトはメールアドレスの @ より前の部分です

メールアドレスが設定されたメールドメインに属していません

ログインを拒否します

ログインを拒否します

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

ログイン失敗時のメッセージ

画面のメッセージ
主な原因
対処方法

認証に失敗しました。再度ログインしてください

リクエストに Cloudflare の ID トークンが含まれていないか、トークンの検証に失敗しています(Team Name または AUD Tag の不一致)

コールバックパスが Access Application で保護されていることと、両方の項目が Cloudflare 側の値と一致していることを確認してください

このアカウントには、この組織へのアクセス権限がありません

アカウントがこの組織のメンバーではなく、メンバーの自動作成もオフになっているか、メールアドレスが設定されたドメインに属していません

事前にメンバーを組織に追加するか、メンバーを自動作成をオンにしてください

このログイン方法は現在無効です

この認証ソース経由のログインが無効になっています

MaiAgent の担当者にお問い合わせください

ログインがタイムアウトしました。再度ログインしてください

ワンタイムログインコードが使用済みか、有効期限が切れています。ログイン中のページを再読み込みした場合などに発生します

再ログインをクリックして、もう一度お試しください

ログイン処理が完了していません。再度ログインしてください

Cloudflare 認証を経ずにコールバックページを直接開いたか、処理が途中で中断されました

ログインリンクカードの URL からやり直してください

よくある質問

Q:MaiAgent からログアウトすると、Cloudflare Access からもログアウトしますか?

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

Q:特定のドメインの社員だけがログインできるようにできますか?

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

Q:保存時に「このメールドメインはすでに使用されています」と表示される場合は?

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

関連ドキュメント

最終更新

役に立ちましたか?