> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 権限とアクセス制御

> Connect AI のアクセス制御は、ロール、権限、認証パターン（共有認証またはユーザーごとの認証）によって実現されます。

Connect AI のデータガバナンスでは、ロールベースアクセス制御（RBAC）を使用して権限を一括管理できます。リソースへのアクセスは、個々のユーザーに直接付与するか、認証されたユーザーが所属する 1 つ以上のロールを通じて付与できます。ロールは権限（エンティティに対するデータおよび実行アクセス）と特権（請求、設定、ユーザー管理などの管理タスク）を決定します。

各データソースへの接続方法は、認証パターンを選択することでさらに制御できます。すべてのユーザーが単一のサービスアカウントを使用してデータソースにアクセスする共有認証と、各ユーザーが自身の認証情報で認証するユーザーごとの認証のいずれかを選択できます。

## ユーザー

Administrator またはUser Administrator が、E メールで新規ユーザーを招待します。Workspace Administrator はユーザーを招待できませんが、既存のユーザーを自身のワークスペースに追加できます。ユーザーは、ユーザー名とパスワード（または、アカウントで有効になっている場合は自社のSSO）でConnect AI にサインインします。Administrator は、新規ユーザーに適切なロールを割り当てることができます。

Just-in-Time（JIT）プロビジョニングが有効になっている場合、ユーザーが初めてSSO 経由でサインインしたときに、手動の招待なしでユーザーアカウントが自動的に作成されます。新規ユーザーにはデフォルトのQuery システムロールと、デフォルトのコネクションおよび仮想スキーマ権限が付与されます。これらは後からAdministrator、Workspace Administrator、またはUser Administrator が変更できます。詳しくは [JIT User Provisioning](https://docs.cloud.cdata.com/ja/SCIM/SSO.md) を参照してください。

## ロール

ロールとは、管理権限とリソースへのアクセス権限の集合体です。ロールは以下のガイドラインに従います：

* 任意のロールを任意のユーザーに割り当てることができます。
* 各ロールには固有の権限があります。
* ロールがユーザーに割り当てられると、そのユーザーはロールに関連付けられたすべての権限を取得します。複数のロールを持つユーザーは、それぞれのロールに関連付けられたすべての権限を持ちます。権限は **加算的** です。ユーザーのアクセス権は、割り当てられたすべてのロールから付与される権限の和集合となり、常に最も寛大な付与が適用されます。あるロールが別のロールから付与されたアクセスを削除または上書きすることはありません。

  例えば、ユーザーがrole\_1 とrole\_2 を持ち、role\_1 にはデータコネクションに対するSelect 権限があり、role\_2 にはそのデータコネクションへのアクセス権がない場合、権限は加算的であるため、ユーザーはデータコネクションにアクセスできます。

Connect AI には、Administrator、Workspace Administrator、Connection Administrator、User Administrator、Query の 5 つの事前定義されたシステムロールが用意されています。

アカウント全体に適用されるのはAdministrator ロールのみです。User Administrator を含む、その他のシステムロールはすべてワークスペースに限定されます。これらのロールを持つユーザーは、割り当てられたワークスペース内でのみ、そのロールのアクセス権を持ちます。User Administrator ロールはユーザー管理に限定されます。同じユーザーでも、所属するワークスペースごとに異なるシステムロールおよびアクセスロールを持つことができます。

### システムロールマトリクス

以下の表は、Connect AI の各システムロールで実行できる操作を示しています。アカウントレベルで機能するのはAdministrator のみです。その他のロールは、ユーザーが割り当てられたワークスペース内でのみ適用されます。

| 機能 | Administrator | Workspace Administrator | Connection Administrator | User Administrator | Query |
| - | - | - | - | - | - |
| **スコープ** | | | | | |
| ロールが機能するレベル | アカウント全体 | 割り当てられたワークスペース | 割り当てられたワークスペース | 割り当てられたワークスペース | 割り当てられたワークスペース |
| **コネクション** | | | | | |
| コネクションの参照 | はい | はい | はい | はい（読み取り専用） | 権限が付与されている場合 |
| コネクションの作成 | はい | はい | はい | いいえ | いいえ |
| コネクションの編集 | はい | はい | はい | いいえ | いいえ |
| コネクションの削除 | はい | はい | はい | いいえ | いいえ |
| コネクションへのクエリ実行 | すべて | ワークスペース内のすべて | ワークスペース内のすべて | 権限が付与されている場合のみ | 権限が付与されている場合のみ |
| コネクション権限の割り当て | はい | はい | はい | いいえ | いいえ |

| 機能 | Administrator | Workspace Administrator | Connection Administrator | User Administrator | Query |
| - | - | - | - | - | - |
| **仮想スキーマ** | | | | | |
| 仮想スキーマの参照 | はい | はい | はい | はい（読み取り専用） | 権限が付与されている場合 |
| 仮想スキーマの作成 | はい | はい | はい | いいえ | いいえ |
| 仮想スキーマの編集 | はい | はい | はい | いいえ | いいえ |
| 仮想スキーマの削除 | はい | はい | はい | いいえ | いいえ |
| 仮想スキーマ権限の割り当て | はい | はい | はい | いいえ | いいえ |
| **ジョブとデータウェアハウス** | | | | | |
| ジョブの管理 | はい | はい | はい | いいえ | いいえ |
| データウェアハウスの管理 | はい | はい | はい | いいえ | いいえ |

| 機能 | Administrator | Workspace Administrator | Connection Administrator | User Administrator | Query |
| - | - | - | - | - | - |
| **ユーザー** | | | | | |
| ユーザーの参照 | はい | いいえ | はい（読み取り専用） | はい（所属するワークスペース） | いいえ |
| ユーザーの作成 | はい | いいえ | いいえ | はい（General ワークスペース内） | いいえ |
| ユーザーの招待 | はい | いいえ | いいえ | はい（General ワークスペース内） | いいえ |
| ユーザーの編集 | はい | いいえ | いいえ | はい（ワークスペース内） | いいえ |
| ユーザーの無効化 | はい | いいえ | いいえ | はい（ワークスペース内） | いいえ |
| ワークスペースへのユーザーの追加 | はい | はい | いいえ | はい（ワークスペース内） | いいえ |
| ワークスペースからのユーザーの削除 | はい | はい | いいえ | はい（ワークスペース内） | いいえ |

| 機能 | Administrator | Workspace Administrator | Connection Administrator | User Administrator | Query |
| - | - | - | - | - | - |
| **ロールの割り当て** | | | | | |
| Administrator の割り当て | はい | いいえ | いいえ | いいえ | いいえ |
| Workspace Administrator の割り当て | はい | いいえ | いいえ | いいえ | いいえ |
| Connection Administrator の割り当て | はい | はい（ワークスペース内） | いいえ | いいえ | いいえ |
| User Administrator の割り当て | はい | いいえ | いいえ | はい（ワークスペース内、対象はQuery とUser Administrator のみ） | いいえ |
| Query の割り当て | はい | はい（ワークスペース内） | いいえ | はい（ワークスペース内、対象はQuery とUser Administrator のみ） | いいえ |

| 機能 | Administrator | Workspace Administrator | Connection Administrator | User Administrator | Query |
| - | - | - | - | - | - |
| **Gateway** | | | | | |
| LLM Gateway の管理 | はい | はい（割り当てられたワークスペースのみ） | いいえ | いいえ | いいえ |
| MCP Gateway の管理 | はい | はい（割り当てられたワークスペースのみ） | いいえ | いいえ | いいえ |
| LLM プロバイダーの更新 | はい | いいえ | いいえ | いいえ | いいえ |
| **コンテキスト** | | | | | |
| コンテキストの作成 | はい | はい（割り当てられたワークスペースのみ） | はい | いいえ | いいえ |
| コンテキストの更新 | はい | はい（割り当てられたワークスペースのみ） | はい | いいえ | いいえ |
| コンテキストの削除 | はい | はい（割り当てられたワークスペースのみ） | はい | いいえ | いいえ |

| 機能 | Administrator | Workspace Administrator | Connection Administrator | User Administrator | Query |
| - | - | - | - | - | - |
| **ワークスペースとアカウント** | | | | | |
| ワークスペースの作成 | はい | いいえ | いいえ | いいえ | いいえ |
| 請求の管理 | はい | いいえ | いいえ | いいえ | いいえ |
| アカウント設定の管理 | はい | いいえ | いいえ | いいえ | いいえ |
| **ログ** | | | | | |
| クエリログの参照 | すべて | ワークスペース内のすべて | ワークスペース内のすべて | 自身のみ | 自身のみ |
| 監査イベントの参照 | すべて | コネクション関連およびユーザー関連のイベント | コネクション関連のイベントのみ | ユーザー関連のイベントのみ | なし |

詳細については、[Roles](https://docs.cloud.cdata.com/ja/Identities/Roles.md) を参照してください。

## 権限

権限とは、ロールを構成するよりきめ細かいアクセスレベルです。以下のエンティティ権限を割り当てることができます：

> [!NOTE]
>
> 権限の文脈では、*エンティティ* とはデータコネクション（例：Salesforce1）または仮想スキーマ（例：MyVirtualSchema）を指します。エンティティはコネクションのロゴで表示され、仮想スキーマはフォルダアイコンで表示されます。

* **Select:** ユーザーがエンティティ内のテーブルから行を選択できるようにします。
* **Insert:** ユーザーがエンティティのテーブルに行を挿入できるようにします。
* **Update:** ユーザーがエンティティのテーブルの行を更新できるようにします。
* **Delete:** ユーザーがエンティティ内のテーブルから行を削除できるようにします。
* **Execute:** ユーザーがエンティティ内のストアドプロシージャを実行できるようにします。

Connect AI では、これらの権限を割り当てる方法として、ユーザー単位（1 人のユーザーに対して複数のエンティティ）またはエンティティ単位（1 つのエンティティに対して複数のユーザー）の 2 つを提供します。

### ユーザー単位で権限を割り当てる

エンティティ権限は、**Edit User** ページからユーザー単位で付与できます。または**Edit Role** ページでアクセスロールを定義することにより、複数のユーザーに対して一度に付与できます。権限は加算的に共存します。つまり、ユーザーをロールに割り当てても、そのユーザーに直接付与されている権限が削除されることはありません。

![Assign permissions by user](https://mintcdn.com/cdata/I5roYo0ySHhjIrdj/ja/images/edit_role.png?fit=max\&auto=format\&n=I5roYo0ySHhjIrdj\&q=85\&s=02e7c29343d362fa666cf46f93f6726b)

テーブル内の個別のボックスをクリックして、単一のエンティティに対する権限を切り替えるか、テーブルカラムの上部にあるボックスをクリックして、すべてのエンティティに対してその権限を切り替えます。

### エンティティ単位で権限を割り当てる

権限は、**Edit/Add Connection** ページまたは**Virtual Schema** ページからエンティティ単位で割り当てることもできます。例えば、**Edit Acumatica Connection** ページの**Permissions** タブでは、コネクションに対する権限を複数のユーザーに一度に付与できます。以下の例では、すべてのユーザーがデータを選択できますが、データを挿入できるのは 3 人のユーザーだけです：

![Assign permissions by entity](https://mintcdn.com/cdata/mmcavCCBLcQ1zoEC/ja/images/entity_permissions.png?fit=max\&auto=format\&n=mmcavCCBLcQ1zoEC\&q=85\&s=b0eb0c62047e3f37d433eb52fdaa48c2)

テーブル内の個別のボックスをクリックして、単一のユーザーに対する権限を切り替えるか、テーブルカラムの上部にあるボックスをクリックして、すべてのユーザーに対してその権限を切り替えます。

### 仮想スキーマアクセスとソース権限

仮想スキーマがソースコネクション由来のアセットを含む場合、そのアセットへのアクセスはソースコネクションの権限ではなく仮想スキーマの権限によって制御されます。仮想スキーマへのアクセス権を持つユーザーは、（ユーザーごとの権限またはロールを介した）基盤となるソースコネクションへのアクセス権の有無に関係なく、その仮想スキーマ内のアセットにアクセスできます。

この仮想スキーマスコープのアクセスは、仮想スキーマがツールキットに追加され、カスタムMCP エンドポイント経由でAI に公開されている場合にも適用されます。つまり、ユーザーが仮想スキーマへのアクセス権を付与されている場合、そのアセットの取得元であるソースコネクションへのアクセス権を持っていなくても、カスタムMCP エンドポイント経由でその仮想スキーマ内のアセットにアクセスできます。

## 認証パターン

### 共有認証（保存された認証情報）

デフォルトでは、アカウントのすべてのユーザーが、コネクションに保存された認証情報を使用する共有認証によって、データソースのデータにアクセスできます。共有認証は、ユーザー固有の権限を含まない読み取り専用のデータソース、またはユーザーごとの認証がないシステムに使用します。

例えば、共有認証を使用したSalesforce へのコネクションがある場合、すべてのユーザーアカウントは、そのSalesforce コネクション用に作成されたSalesforce アカウントのデータにアクセスできます。クエリ権限はユーザーごとにカスタマイズして利用可能な操作を制限できますが、これらの制限の下ですべてのユーザーは同じデータにアクセスします。

### ユーザーごとの認証

特定のデータソースは、アカウントの各ユーザーに対して、自身のログイン認証情報でコネクションにログインすることを強制する機能をサポートしています。規制要件に準拠する場合や、ユーザーごとに異なるデータの場合は、ユーザーごとの認証を使用してください。ユーザーごとの認証により、ユーザーは自身がアクセスする必要があるアカウントのデータのみにアクセスできます。さらに、この方法でコネクションを構成すると、アカウントの最大数に対して単一のコネクションスロットとしてのみカウントされます。

データソースがユーザーごとの認証をサポートしている場合、コネクション設定の**Authentication** セクションの下に**Authentication Model** セクションが表示されます。**Shared Authentication** または**Per-User Authentication** のいずれかを選択します。

![Authentication Model](https://mintcdn.com/cdata/IKpvd4x-DWRWFNCF/ja/images/user_credentials_modal.png?fit=max\&auto=format\&n=IKpvd4x-DWRWFNCF\&q=85\&s=128dc24e12e69dbbd932d796b3006339)

特定のデータソースでこの機能が利用できず、ご希望の場合は、CData サポートまでお問い合わせください。

> [!NOTE]
>
> この機能には以下の制限が適用されます：
>
> * Administrator のみがデータソースを**Shared Authentication** と**Per-User Authentication** の間で切り替えることができますが、すべてのロールのユーザーが自身の認証情報でユーザーごとの認証コネクションにログインできます。
> * ユーザーごとの認証は、[OData API](https://docs.cloud.cdata.com/ja/API/OData-Dashboard.md) の使用時はサポートされていません。データソースをOData API に接続するには、共有認証を使用する必要があります。
> * キャッシュは共有認証でのみ許可されており、ユーザーごとの認証では許可されていません。詳しくは [キャッシュ](https://docs.cloud.cdata.com/ja/Caching.md) を参照してください。
> * Connect AI の[サービスアカウント](https://docs.cloud.cdata.com/ja/Identities/Service-Accounts.md) は、ユーザーごとの認証コネクションに対する権限を割り当てることができないため、そのコネクションにサインインできません。サービスアカウントにデータソースへのアクセスを許可するには、共有認証を使用するコネクションを使用してください。
> * キーボルトは共有認証でのみサポートされており、ユーザーごとの認証ではサポートされていません。詳細については、[Keys](https://docs.cloud.cdata.com/ja/Settings/Keys.md) を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.