> ## 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.

# Roles and Policies Overview

> システムロール、アクセスロール、ポリシーがどのように連携して、Connect AI の管理アクセスとデータアクセスを制御するかを説明します。

Connect AI は、2 種類のルールでアクセスを制御します。1 つはユーザーが管理できる内容を制御するルール、もう 1 つはユーザーがアクセスできるデータを制御するルールです。このページでは、ロールとポリシーがどのように組み合わさるか、およびアクセスロールからポリシーに移行する方法を説明します。

## 管理アクセスとデータアクセス

Connect AI では、次の 2 つの概念を区別しています：

* **管理アクセス**– ユーザーが実行できる操作（ユーザー、ワークスペース、コネクションの管理など）を決定します。管理アクセスは[システムロール](https://docs.cloud.cdata.com/ja/Roles-Policies/Roles.md) で制御します。
* **データアクセス**– ユーザーがクエリまたは変更できるデータ、および実行できるストアドプロシージャを決定します。データアクセスは[アクセスロール](https://docs.cloud.cdata.com/ja/Roles-Policies/Roles.md) と[ポリシー](https://docs.cloud.cdata.com/ja/Roles-Policies/Policies.md) で制御します。

次の図は、各要素の関係を示しています。

```mermaid theme={null}
flowchart LR
    U["ユーザー"]
    SR["`**システムロール**
    ワークスペースごとに 1 つ`"]
    AR["`**アクセスロール**
    複数、加算的
    *ポリシーに置き換え中*`"]
    PO["`**ポリシー**
    複数、加算的
    *推奨*`"]
    ADM["`**管理アクション**
    ユーザー、コネクション、ゲートウェイ、ログ`"]
    DATA["`**データ付与**
    Select、Insert、Update、Delete、Execute`"]

    U -->|"1 つ保持"| SR
    U -->|"複数保持"| AR
    U -->|"割り当て"| PO
    SR -->|"付与"| ADM
    AR -->|"付与"| DATA
    PO -->|"付与"| DATA
    SR -.->|"Administrator ロールはすべてのコネクションにクエリ可能"| DATA

    classDef ctrl fill:#e8f0fe,stroke:#3b6fd4,color:#1a1a1a
    classDef data fill:#e6f4ea,stroke:#2e8b57,color:#1a1a1a
    classDef plain fill:#f5f5f5,stroke:#888,color:#1a1a1a
    class U plain
    class SR,ADM ctrl
    class AR,PO,DATA data
```

## システムロール

各ユーザーは、ワークスペースごとに 1 つのシステムロールを持ちます。システムロールは固定されており、カスタマイズできません。利用可能なシステムロールは次のとおりです：

* **Administrator**
* **Workspace Administrator**
* **Connection Administrator**
* **User Administrator**
* **Query**

**Query** ロールがアクセスできるのは、付与されたデータのみです。各システムロールの説明については [Roles](https://docs.cloud.cdata.com/ja/Roles-Policies/Roles.md) を、各ロールで実行できる操作については[システムロールマトリクス](https://docs.cloud.cdata.com/ja/Permissions.md#システムロールマトリクス) を参照してください。

## アクセスロール

> [!NOTE]
>
> アクセスロールは[ポリシー](https://docs.cloud.cdata.com/ja/Roles-Policies/Policies.md) に置き換えられつつあり、データへの権限を付与する推奨の方法はポリシーになりました。

アクセスロールは、ワークスペース内のデータ権限を付与します。Administrator がアクセスロールを作成し、コネクションまたは仮想スキーマごとに次の権限を付与できます：

* テーブルとビューに対する**Select**、**Insert**、**Update**、**Delete**。
* ストアドプロシージャに対する**Execute**。

アクセスロールは加算的なので、ユーザーは割り当てられたすべてのアクセスロールの権限を合わせて受け取ります。アクセスロールは、ユーザーに直接、またはSCIM グループを通じて割り当てることができます。

アクセスロールは権限があらかじめ決まったセットであり、ポリシーほど個々のオブジェクトに合わせて細かく調整することはできません。

## ポリシー

[ポリシー](https://docs.cloud.cdata.com/ja/Roles-Policies/Policies.md) は、オンまたはオフに切り替えられる、名前付きのデータ権限のセットです。

ポリシーは次のように機能します：

* **許可のみ**– ポリシーはアクセスを付与します。ポリシーが付与していないものはすべて拒否されます。明示的な拒否はありません。
* **きめ細かい設定**– コネクションまたは仮想スキーマ内の個々のテーブル、ビュー、ストアドプロシージャにポリシーのスコープを設定し、それぞれが許可する具体的なアクセスを選択できます。
* **ポリシーごとに 1 つのワークスペース**– ポリシーはワークスペース内で作成し、そのワークスペースにのみ適用されます。
* **有効または無効**– ポリシーを**Inactive** に設定すると、そのポリシーが付与しているアクセスは削除されます。ポリシーの変更は約 1 分以内に反映されます。
* **監査**– ポリシーの変更はすべて[監査ログ](https://docs.cloud.cdata.com/ja/Logs.md#ログの監査) に記録されます。
* **Administrator による管理**– ポリシーを作成および変更できるのはAdministrator のみです。

ポリシーは、個々のユーザー、SCIM グループ（SCIM グループがプロビジョニングされている場合）、Administrator 以外のシステムロールに割り当てることができます。Administrator はすでにすべてのアクセス権を持っています。ポリシーの作成と管理については、[Policies](https://docs.cloud.cdata.com/ja/Roles-Policies/Policies.md) を参照してください。

## ロールとポリシーの連携

ロールとポリシーは共存します。ユーザーが両方に属している場合、Connect AI は、いずれかのロールまたはポリシーが許可していれば、そのアクションを許可します。ポリシーによって、アクセスロールまたは管理者ロールがすでに付与しているアクセスを取り消すことはできません。

| 質問 | 制御される場所 |
| - | - |
| このユーザーは何を管理できますか？ | システムロール |
| このユーザーはどのデータを読み取りまたは変更できますか？ | ポリシーまたはアクセスロール |
| このユーザーはどのストアドプロシージャを実行できますか？ | ポリシーまたはアクセスロール |

> [!NOTE]
>
> PII ルールなどのデータセキュリティルールは、誰がクエリを実行するかにかかわらず、すべてのコネクタに適用されます。これらはロールやポリシーとは別のものです。詳細については、[Data Security](https://docs.cloud.cdata.com/ja/Data-Security.md) を参照してください。

## アクセスロールからポリシーへの移行

Connect AI は、アクセスロールをポリシーに自動的に移行しません。ポリシーに移行するには：

**Step 1**

アカウント内のアクセスロールを確認し、それぞれが付与している権限を書き留めます。

**Step 2**

同じアクセスを付与する[ポリシー](https://docs.cloud.cdata.com/ja/Roles-Policies/Policies.md) を作成し、同じユーザー、SCIM グループ、またはシステムロールに割り当てます。

**Step 3**

アクセスロールとポリシーを並行して運用し、ユーザーが必要なデータに引き続きアクセスできることを確認します。

**Step 4**

アクセスロールから権限を削除します。

ロールとポリシーの権限は組み合わされるため、両方を並行して運用してもアクセスが中断されることはありません。


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