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

# ユーザーロール

> CData Arc でロール、ポリシー、権限を作成および管理する方法。

export const siteNameShort = "Arc";

export const siteName = "CData Arc";

**ロール**タブには、アプリケーションで定義されているすべてのロールの一覧、関連するワークスペース、および各ロールを担うことが可能なすべてのユーザーへのリンクが表示されます。ロールを使用すると、特定のワークスペースで特定のアクションのみを実行するようにユーザーを制限できます。ユーザーに割り当てられたロールは、以下を含むがこれらに限定されない、{siteNameShort} に表示されるすべての内容に影響します：

* [ワークスペース](../../../flows/workspaces)
* [レポート](../reports)
* [ダッシュボードデータ](../dashboard)
* [ログ](../activity)

ロールを作成および管理するには、[設定ページ](./settings-page)に移動し、**ロール**タブに移動します。ユーザーの作成と管理については、[ユーザー](./users)を参照してください。

{siteNameShort} のすべてのインストールには、次の3つの組み込みロールが含まれています：

* [Admin](#admin-ロール)
* [Standard](#standard-ロール)
* [Support](#support-ロール)

これらは、編集や削除ができないグローバルなロールです。これらはすべてのワークスペースに適用されます。ただし、各ユーザーの権限を制限する[カスタムロール](#カスタムロール)を定義することができます。カスタムロールは*ポリシー*で構成されており、ユーザーが{siteNameShort} で表示または実行できる内容を最も細かく制御できます。またカスタムロールは、ユーザーがどのワークスペース、フローAPI、接続、および証明書を表示したり対話したりできるかを識別します。

次のセクションでは、各組み込みロールについて、および新しいポリシーとロールを定義する方法について説明し、ポリシーの例を示します。独自のポリシーとロールを作成する際には、[比較表](#ユーザーロール比較表)をご利用ください。

## Admin ロール

**Admin** ロールはアプリケーションを完全に制御できます。Admin は、新規[フロー](../../../flows)の作成、既存のフローの削除、[プロファイル](../profiles)設定の変更などのコンソールでサポートされるすべての操作を実行できます。

また、Admin のみが[監査ログ](../activity#監査ログ)を閲覧できます。監査ログには、アプリケーションでユーザーが行ったすべての変更が[改ざんを検知できる仕組み](../activity#改ざん検知ログ)で記録されます。

## Standard ロール

**Standard** ロールのメンバーは、コネクタおよびフローを作成、編集、削除できます。しかし、[プロファイル](../profiles)ページで公開されているような、アプリケーション全体の設定を変更することはできません。

Standard ユーザーは、新しいファイルをフローにアップロードしたり、コネクタで使用するパブリック証明書をアップロードしたりできます。プロファイルに設定されているプライベート証明書をアップロードすることはできません。

## Support ロール

**Support** ロールは読み取り専用のロールです。このロールのメンバーは、新しいフローの作成や削除、アプリケーション設定の変更はできません。**Support** ユーザーは、*Send* オペレーションを使用して既存のフローを通じてファイルを送信*できます*が、新しいファイルをアップロードすることはできません（つまり、コネクタの**トランザクション**タブにすでに存在するファイルのみを処理できます）。

## カスタムロール

カスタムロールを使用すると、各ユーザーが{siteNameShort} で表示または実行できる内容をより詳細に制御できます。カスタムロールはポリシーを作成することによって定義されます。1つのポリシーで、ワークスペース（フローAPI とコネクタを含む）、接続、証明書の3つの領域にわたって権限を付与できます。またカスタムロールは、ユーザーがどのワークスペース、接続、および証明書を表示したり対話したりできるかを識別します。

### ロールとポリシーの作成

1. カスタムロールを作成するには、[設定ページ](./settings-page)に移動し、**ロール**タブに移動します。
2. **ロールを追加**をクリックします。ロールにわかりやすい名前と説明を入力し、**ロールを追加**をクリックします。
3. ポリシーを定義するには、**ポリシーを追加**をクリックします。
4. ポリシーは**ワークスペース権限**（コネクタとフローAPI アクセスを含む）、**接続権限**、**証明書権限**の各セクションで構成されています。各セクションの横にあるトグルを使用して有効にし、そのセクションで許可されるアクションとアクセス範囲を以下に説明するように設定します。各アクセスの種類について、対応する**現在および将来のすべて**トグルを使用してそのタイプのすべてのアイテムへのアクセスを付与するか、トグルをオフにして特定のサブセットを選択します。
5. 別のポリシーを追加するには、**ポリシーを追加**をクリックし、前述の手順を繰り返します。
6. 終了したら、**保存**をクリックします。次の画像は、2つのポリシーを持つロールを示しています。

   <img src="https://mintcdn.com/cdata-arc/H21wlTeP6JC5lIzk/public/images/role_policy_example_263.png?fit=max&auto=format&n=H21wlTeP6JC5lIzk&q=85&s=e3c74f1dfdad5a26f44258499e279b30" alt="2つのポリシーが設定済みのロール" width="800" data-path="public/images/role_policy_example_263.png" />

### ワークスペース権限

#### ワークスペース設定

割り当てたい**許可されたワークスペースのアクション**の横にあるチェックボックスをON にし、**ワークスペースアクセス**セクションを使用して、ポリシーを1つ以上のワークスペースに割り当てます。すべてのワークスペースに割り当てるには、**現在および将来のすべてのワークスペース**トグルを使用します。

#### コネクタ設定

このセクション内の**コネクタ設定**エリアでは、選択されたワークスペース内のコネクタに対してユーザーが実行できる操作を制御します。割り当てたい**許可されたコネクタのアクション**の横にあるチェックボックスをON にし、**コネクタアクセス**を使用してポリシーを特定のコネクタタイプ、またはすべての現在および将来のコネクタにスコープします。

#### Flow API の設定

**ワークスペース権限**セクション内の**Flow API の設定**エリアでは、[フローAPI](../../../flows/flow-api) エンドポイントに対してユーザーが実行できる操作を制御します。割り当てたい**許可されたFlow API のアクション**の横にあるチェックボックスをON にします。

**Flow API アクセス**を使用してポリシーを特定のフローAPI にスコープするか、**現在および将来のすべてのFlow API** トグルを使用して選択されたワークスペース内のすべてのフローAPI へのアクセスを付与します。

<Note>**呼び出し**アクションはワークスペースアクセスとは独立しています。**呼び出し**権限のみが付与された[サービスアカウント](./users#ユーザーの種類)は、{siteNameShort} UI へのその他のアクセス権や表示権を持たずにフローAPI エンドポイントを呼び出すことができます。これにより、アプリケーションへの広範なアクセスを与えることなく、自動化されたクライアントにフローAPI エンドポイントを公開できます。</Note>

次の画像は、**ポリシー 1** に**ワークスペース**、**コネクタ**、および**Flow API** の権限が設定済みであることを示しています。

<img src="https://mintcdn.com/cdata-arc/H21wlTeP6JC5lIzk/public/images/roles_policy1_complete_263.png?fit=max&auto=format&n=H21wlTeP6JC5lIzk&q=85&s=d259a96bc2044254fc8040215f6dcec8" alt="ワークスペース、コネクタ、フローAPI の権限が設定済みのポリシー 1" width="800" data-path="public/images/roles_policy1_complete_263.png" />

### 接続権限

**接続権限**セクションでは、接続のライフサイクル（接続の作成、更新、削除）を制御します。割り当てたい**許可された接続のアクション**の横にあるチェックボックスをON にします。

接続を表示する能力は、ポリシーがいずれかの接続権限を付与するときに暗黙的に含まれます。

**接続アクセス**を使用して、接続名、接続タイプ（SFTP、Amazon S3、Salesforce など）、またはその両方でポリシーのスコープを設定します。名前フィルタと種類フィルタの両方を設定した場合、それらは組み合わされ、*両方*に一致する接続のみが対象になります。これらのフィルタに関係なくすべての接続へのアクセスを付与するには、**現在および将来のすべての接続**トグルを使用します。このトグルは名前と種類のフィルタをオーバーライドします。

次の画像は、**接続**権限が設定済みのポリシーを示しています。

<img src="https://mintcdn.com/cdata-arc/H21wlTeP6JC5lIzk/public/images/roles_connection_permissions.png?fit=max&auto=format&n=H21wlTeP6JC5lIzk&q=85&s=521b51d706653ba73070f6889f6980d3" alt="接続権限が設定済みのポリシー" width="800" data-path="public/images/roles_connection_permissions.png" />

<Note>接続権限を定義する際は注意が必要です。ポリシーが接続のサブセットのみへのアクセスを付与する場合、そのポリシーの対象となるユーザーがスコープ外の接続を作成することが可能です。この場合、ユーザーは作成後にその新しい接続を表示または一覧表示できません。それがポリシーに含まれる接続の一つではないためです。</Note>

### 証明書権限

**証明書権限**セクションでは、ユーザーがパブリック証明書とプライベート証明書を使用して実行できる操作を制御します。割り当てたい**許可された証明書のアクション**の横にあるチェックボックスをON にし、**証明書アクセス**を使用してポリシーを1つ以上の証明書に割り当てます。

<img src="https://mintcdn.com/cdata-arc/j59334epfVQRoK96/public/images/roles_certificate_policy.png?fit=max&auto=format&n=j59334epfVQRoK96&q=85&s=075b0d7d057c3fc69d578e2f08676c9c" alt="証明書ポリシーの設定" width="800" data-path="public/images/roles_certificate_policy.png" />

### ユーザーとロールの関連付け

1. ユーザーをロールに関連付けるには、**関連ユーザー**タブをクリックします。
2. **ユーザーを追加**をクリックし、このロールを担うユーザーを選択します。
3. 終了したら、**ユーザーを追加**をクリックします。
4. **ロール**タブを使用して、関連するワークスペースやユーザーを含む、各ロールのサマリ情報を表示します。数値の上にカーソルを合わせると詳細が表示されます。

   <img src="https://mintcdn.com/cdata-arc/j59334epfVQRoK96/public/images/roles_complete.png?fit=max&auto=format&n=j59334epfVQRoK96&q=85&s=e380ebaae12fc07880e07667890182ab" alt="関連ユーザーとワークスペースを含むロールタブ" width="800" data-path="public/images/roles_complete.png" />

<Note>証明書の特定のサブセットへのアクセスを含む証明書ポリシーがある場合、そのポリシーの対象となるユーザーは新しい証明書を作成できますが、作成後にコネクタでその証明書を表示または一覧表示することはできません。これは、新しい証明書がポリシー内の証明書のサブセットの一部ではないためです。</Note>

### ロールおよびポリシーの例

会社にEDI 開発者のグループがあるシナリオを想像してください。この会社には複数の取引パートナーがあります。この例では、2つの取引パートナーと2名の開発者を想定します。

取引パートナーのフローは、PartnerA およびPartnerB の2つの別々のワークスペースに分割されます。各EDI 開発者（DevA およびDevB）は、主に対応するワークスペース（DevA = PartnerA）で作業しますが、必要に応じてPartnerB のワークスペースでもファイルを表示または送信できる必要があります。これを管理するには、次の画像に示すように、DevA ユーザーを作成し、DevA 用のカスタムロールを作成して、そのロールに2つのポリシーを割り当てます。

<img src="https://mintcdn.com/cdata-arc/H21wlTeP6JC5lIzk/public/images/role_policy_example_263.png?fit=max&auto=format&n=H21wlTeP6JC5lIzk&q=85&s=e3c74f1dfdad5a26f44258499e279b30" alt="2つのポリシーが割り当てられたロールとポリシーの例" width="800" data-path="public/images/role_policy_example_263.png" />

* ポリシー 1 は、DevA にPartnerA ワークスペースへの完全なアクセス権を与えます。
* ポリシー 2 は、DevA にPartnerB ワークスペースへの限定的なアクセス権を与えます。ファイルの表示と送信を許可しますが、コネクタの作成や削除、フローや設定の編集は許可しません。

## ユーザーロール比較表

このテーブルでは、すべての種類のロールで利用できる機能について説明します。

| アクション                         | Admin | Standard | Support |  カスタム  |
| ----------------------------- | :---: | :------: | :-----: | :----: |
| フローの編集                        |   ✔   |     ✔    |         |    ✔   |
| 設定の更新                         |   ✔   |     ✔    |         |    ✔   |
| コネクタの削除                       |   ✔   |     ✔    |         |    ✔   |
| コネクタの作成                       |   ✔   |     ✔    |         |    ✔   |
| ファイルのアップロード                   |   ✔   |     ✔    |         |    ✔   |
| ファイルの送信                       |   ✔   |     ✔    |    ✔    |    ✔   |
| ファイルの受信（コネクタの**トランザクション**タブで） |   ✔   |     ✔    |    ✔    |    ✔   |
| ファイルの削除                       |   ✔   |     ✔    |         |    ✔   |
| トランザクションの削除                   |   ✔   |     ✔    |         |    ✔   |
| 再キュー                          |   ✔   |     ✔    |    ✔    |    ✔   |
| フローAPI エンドポイントの呼び出し           |   ✔   |     ✔    |    ✔    |    ✔   |
| フローAPI エンドポイントの作成、変更、削除       |   ✔   |     ✔    |         |    ✔   |
| 接続の作成、更新、削除                   |   ✔   |     ✔    |         |    ✔   |
| コネクタとフローの表示                   |   ✔   |     ✔    |    ✔    | ✔ [^1] |
| アプリケーションログとトランザクションログの表示      |   ✔   |     ✔    |    ✔    | ✔ [^1] |
| プライベート証明書ファイルのプロファイルへのアップロード  |   ✔   |          |         |        |
| プロファイル設定の変更                   |   ✔   |          |         |        |
| 監査ログの表示                       |   ✔   |          |         |        |
| ユーザーの追加と管理                    |   ✔   |          |         |        |

[^1]: このアクションを実行するには、ワークスペースへのアクセス権が必要です。
