> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-permissions.md).

# Runbook のアクセス許可

特定の Runbook へのアクセスを許可/拒否する方法。

{% embed url="<https://www.youtube.com/watch?v=bLi_k_Yzhyw>" %}

## 対象範囲

これは、Azure Tenant 内の特定の runbook へのアクセスを許可/拒否する方法を扱います。runbook として特定の操作を実行するために必要な MS Graph API 権限について知りたい場合は、ぜひ当社の [要件](https://docs.realmjoin.com/ja/zi-dong-hua/connecting-azure-automation/azure-ad-roles-and-permissions.md).

## 概要

"Runbook Permissions" は、特定のユーザーに対する runbook の表示可否を定義します。一部の runbook はグローバルにブロック/非表示にもできます。

以下の [Runbook Customizations](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-customization.md)、これらの権限は、RealmJoin 管理者として RealmJoin の Web ポータルで JSON 形式の設定を指定することで定義します。 <https://portal.realmjoin.com/settings/runbooks-permissions> .

### このガイドについて

まず構文を簡単に説明し、その後、完全な例を少しずつ作っていきます。完全なサンプルへ直接進んで、そこから始めてもかまいません [そこから](#targetentitygroups).

## 設定構文

### runbook 名

runbook は、Azure Automation Account に表示される名前で参照されます。たとえば `rjgit-group_general_remove-group`.

ワイルドカード ('\*') を使って複数の runbook に一致させることができます。同じ文字列内で複数のワイルドカードを使うこともできます。たとえば `rjgit-*_security_*`。これは次のすべての例に該当します：

* `rjgit-org_security_list-inactive-users`
* `rjgit-device_security_enable-or-disable-device`

接頭辞 `rjgit-` は、公開 GitHub リポジトリからインポートされた runbook を示します。顧客固有の runbook には接頭辞がありません。たとえば `user_userinfo_custom-runbook`

### Entra ID Groups

Entra ID グループは、次のように Object ID で参照されます。 `91688d11-9a34-42cd-8d1e-ce617d6c1234`。現在使用できるのはセキュリティ グループのみです。

## JSON の構造と例

完全な設定例を少しずつ作成していきます。

JSON 設定は複数のセクションで構成されますが、すべてのセクションは省略可能です。

"//" プレフィックスを使ってコメントを追加できます。

### EnabledRunbookPatterns

このセクションには、使用を許可された runbook の一覧が含まれます。このセクションを省略すると、既定ですべての runbook が有効/許可されます。

このセクションを定義すると、このセクションに記載された runbook のみが、どのロール / サポート担当者 / 管理者でも使用可能になります。

#### 例

* 完全名を指定して、特定の個別 runbook のみを許可する

  `rjgit-group_general_remove-group`
* 共有リポジトリの device 関連 runbook をすべて許可する

  `rjgit-device_*`
* 共有 user runbook をすべて許可する

  `rjgit-user_*`
* 顧客固有（ローカル）の user 関連 runbook をすべて許可する

  `user_*`

これにより、多くの group ベースの runbook とすべての org ベースの runbook が暗黙的に除外されます。ご注意ください。

```
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ]
}
```

### DisabledRunbookPatterns

グローバルに無効化 / 禁止された runbook の一覧です。このセクションが省略されているか空の場合、（以下で指定された [EnabledRunbookPatterns](#enabledrunbookpatterns))

このセクションの項目は [EnabledRunbookPatterns ](#enabledrunbookpatterns)より優先されます。- これらの runbook は、この Tenant の誰に対しても非表示になり、使用できなくなります。

#### 例

前の `EnabledRunbookPatterns` セクションを再利用します。

* 共有 (`rjgit-`) の runbook を `セキュリティ` カテゴリで無効化する。

```
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ]
}
```

### ロール

このセクションでは、runbook の一覧を Entra ID グループに割り当てることができます。これにより、Tenant 内で複数のサポート/オペレーター ロールを定義できます。

このセクションを省略すると、すべての RealmJoin サポート担当者と管理者が、前のセクションで指定されたすべての runbook にアクセスできます。

{% hint style="warning" %}
有効にすると、ロールに属さないユーザーは runbook を一切表示できません。
{% endhint %}

#### 例

ここまでの内容を踏まえて、デバイス サポート ロールを作成しましょう `DeviceAdmin` そしてユーザー サポート ロールも作成します `UserAdmin`.

これらのロールを複数の Entra ID グループに適用し、各ロールに許可された runbook の一覧を指定します。ご注意ください。これにより、ユーザー サポート ロールはごく少数の runbook のみに制限されます。

読者が Entra ID グループ名を把握しやすいように、グループの object ID の横にコメント（"//"）を追加しましょう。

```json
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ],
  "Roles": {
    "DeviceAdmin": {
      "Groups": [
        "9cbfc0af-c217-41e9-b790-3043788f1234", // 1つ目の Device Support Entra ID グループ
        "5555c0af-c217-41e9-b790-3043788f1234"  // 2つ目の Device Support Entra ID グループ - 別チーム
      ],
      "AllowedRunbookPatterns": [
        "rjgit-device_*"
      ]
    },
    "UserAdmin": {
      "Groups": [
        "1234c0af-c217-41e9-b790-3043788f1234" // ユーザー サポート Entra ID グループ
      ],
      "AllowedRunbookPatterns": [
        "rjgit-user_general_assign-or-unassign-license",
        "rjgit-user_mail_*",
        "user_*"
      ]
    }
  }
}
```

これで `UserAdmin` ロールは次のことができます：

* Tenant 内のすべてのユーザーにライセンスを割り当てる
* Tenant 内のすべてのユーザーのメールアドレスを変更する

次の `DeviceAdmin` ロールは

* Tenant 内の任意のデバイスをワイプする

### TargetEntityGroups

重要な VIP ユーザーがいる場合もあるでしょう。どのサポート担当者でも VIP のデバイスを消去したり、VIP のメールアドレスを変更したりできるべきではありません。"targeting" を使うことで、重要なユーザーに対するロールを専用チームに限定できます。

"Devices" は、Entra ID のデバイス オブジェクトではなく、主担当/割り当てユーザーによってターゲット指定されます。これにより、純粋にユーザーベースのグループモデルに留まることができます。

重要な VIP ユーザーを含む Entra ID グループが存在すると仮定します。このセクションを使うことで、これらの特定の Entra ID グループ（ターゲット）向けに、より重要な一部のロールと runbook の範囲を慎重に限定できます。

もちろん、このセクションを省略すると、Tenant 内のすべてのユーザー/グループ/デバイスは同等に扱われます。

TargetEntityGroups を定義しても、このセクションに記載されていない他のグループには影響しません。

#### 完全な例

グループ `0000c0af-c217-41e9-b790-3043788f0000` は VIP ユーザーのグループです。

新しい Entra ID グループを導入します `4444c0af-c217-41e9-b790-3043788f4444` VIP ユーザーの管理を許可されたサポート担当者を含みます。これらのサポート担当者には、他の基本的なサポート権限もすべて必要なので、既存のロールに追加します。

ロールを「制限」しても、サポーターに新しいロールが付与されるわけではありません。

```json
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ],
  "Roles": {
    "DeviceAdmin": {
      "Groups": [
        "9cbfc0af-c217-41e9-b790-3043788f1234", // 1つ目の Device Support Entra ID グループ
        "5555c0af-c217-41e9-b790-3043788f1234"  // 2つ目の Device Support Entra ID グループ - 別チーム
        "4444c0af-c217-41e9-b790-3043788f4444"  // VIP サポート チーム
      ],
      "AllowedRunbookPatterns": [
        "rjgit-device_*"
      ]
    },
    "UserAdmin": {
      "Groups": [
        "1234c0af-c217-41e9-b790-3043788f1234", // ユーザー サポート Entra ID グループ
        "4444c0af-c217-41e9-b790-3043788f4444"  // VIP サポート チーム
      ],
      "AllowedRunbookPatterns": [
        "rjgit-user_general_assign-or-unassign-license",
        "rjgit-user_mail_*",
        "user_*"
      ]
    }
  },
  "TargetEntityGroups": {
    "0000c0af-c217-41e9-b790-3043788f0000": {  // VIP ユーザー - 慎重に扱ってください！
      "RestrictRoles": {
        "UserAdmin": [
          "4444c0af-c217-41e9-b790-3043788f4444" // VIP サポート
        ],
        "DeviceAdmin": [
          "4444c0af-c217-41e9-b790-3043788f4444" // VIP サポート
        ]
      }
    }
  }
}
```

#### **例: US サポート担当者を US ユーザーのみに管理を限定する**

このシナリオでは、US 拠点のサポート担当者が、US にいるユーザーのみを管理できるようにします。この制限を適用するには:

* 次のことを明示的に **拒否する** US サポート担当者が runbook を実行できる対象を **すべてのユーザーに対して**.
* 特に **許可する** runbook の実行を **US ユーザーにのみ**.

これにより、US サポート担当者の権限は意図した対象（US ユーザー）に厳密に限定され、対象外のユーザーとの誤ったやり取りを防げます。

**実装**

1. Realm Join Portal で Runbook Runners Entra グループを割り当てる必要があります
   1. 設定 > 権限 > Runbook Runner Permissions
   2. RealmJoin Portal で一般的な runbook 操作を許可するには、US Supporters Entra グループを Runbook Runners Group のメンバーにする必要があります。
2. Settings > Runbook Permissions で新しいロールを追加する
   1. Roles セクションで、USSupporters ロールに対応する Entra グループ（group object ID）を追加します
   2. USSupporters に AllowedRunbookPatterns を追加します
3. TargetEntityGroups を変更します
   1. All-Users グループは、空の値で Role USSupporters を Restrict する必要があります（ここには Entra group object ID は追加されません）。これは暗黙の拒否です！
   2. US Users グループは、Role USSupporters を US Supporters Entra group object ID に Restrict する必要があります

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FZ56Ipx6VuZDjIeZO2MTC%2Fimage.png?alt=media&amp;token=e3f5fe54-0d17-46f0-a106-f51d548bde64" alt=""><figcaption><p>US サポート担当者の管理を US Users のみに制限する</p></figcaption></figure>

このシナリオの完全な例を以下に示します：

```json
{
  // ポータル権限:
  // Runbook Runner ロール: US Supporters

  // グループ メンバーシップ:
  // 3e1e7540-7f0c-483c-b9bf-500342e2467c: All-Users
  // c603278c-cc36-4661-bb7a-eecb7ab079f9: US Supporters
  // 0f76d01e-cc6b-4553-bf1d-e4ccedd9c824: US Users

  "EnabledRunbookPatterns": [ // mail および security の Runbook を一般的に有効化
    "rjgit-*_mail_*",
    "rjgit-*security*"
  ],
  "DisabledRunbookPatterns": [
    "*password*"
  ],

  "Roles": {
    "USSupporters": {
      "Groups": [
        "c603278c-cc36-4661-bb7a-eecb7ab079f9" // US Supporters
      ],
      "AllowedRunbookPatterns": [ // このロール - US Supporters に許可された Runbook
        "rjgit-user_*",
        "rjgit-device_*",
        "rjgit-group_*"
      ]
    }
  },
  
  "TargetEntityGroups": {
    "3e1e7540-7f0c-483c-b9bf-500342e2467c": { // All-Users
      "RestrictRoles": {
        "USSupporters": [
          // 基本的に、US Supporters には runbook を許可しない
        ]
      }
    },
    "0f76d01e-cc6b-4553-bf1d-e4ccedd9c824": { // US Users
      "RestrictRoles": {
        "USSupporters": [
          "c603278c-cc36-4661-bb7a-eecb7ab079f9" // US Supporters
        ]
      }
    }
  }
}
```

### SchedulingEnabledRunbookPatterns

このセクションには、「スケジュール可能」としてフラグが付与される runbook の一覧が含まれます。RealmJoin Port では、これらの runbook のスケジュールを割り当て/管理できます。詳しくは [Runbook のスケジュール設定](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/scheduling.md).

SchedulingEnabledRunbookPatterns が定義されていない場合の既定の動作は、次の例で示されます：

```json
{
  "SchedulingEnabledRunbookPatterns": [
    "*_scheduled"
  ]
}
```

### SchedulingDisabledRunbookPatterns

このセクションには、「スケジュール可能」としてフラグが付与されることがブラックリスト化された runbook の一覧が含まれます。RealmJoin Port では、これらの runbook のスケジュールを割り当て/管理できません。詳しくは [Runbook のスケジュール設定](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/scheduling.md).

SchedulingEnabledRunbookPatterns と SchedulingDisabledRunbookPatterns の両方に存在する runbook は **は** スケジュール可能になります。

既定ではブラックリスト化された runbook はありません。次の例は構文を示すだけです：

```json
{
  "SchedulingDisabledRunbookPatterns": [
    "rjgit-user_*"
  ]
}
```


---

# 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.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-permissions.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.
