Azure Policy を使用して Hybrid Runbook Worker でジョブの実行を適用する

[アーティクル]
09/09/2024

重要

Azure Automation エージェントベースのユーザー Hybrid Runbook Worker (Windows と Linux) は 2024 年 8 月 31 日に廃止され、サポートされなくなりました。既存のエージェントベースのユーザー Hybrid Runbook Worker から拡張機能ベースのハイブリッド worker に移行する方法については、ガイドラインに従ってください。

Hybrid Runbook Worker で Runbook を起動すると、Azure portal から開始するときに Hybrid Runbook Worker グループの名前を Azure PowerShell または REST API で指定できる Run on オプションが使用されます。グループを指定すると、そのグループ内の worker の 1 つによって Runbook が取得されて実行されます。 Runbook でこのオプションが指定されていない場合は、Azure Automation によって Azure サンドボックスで Runbook が実行されます。

Automation ジョブオペレーター以上のメンバーである組織内のすべてのユーザーは、Runbook ジョブを作成できます。 Automation アカウント内の Hybrid Runbook Worker グループをターゲットにした Runbook の実行を管理するには、Azure Policy を使用します。これは、組織の標準を適用し、指定されたユーザーによってオートメーションジョブが制御および管理され、Runbook の実行が Azure サンドボックス上ではできず、Hybrid Runbook Worker 上でのみできるようにするのに役立ちます。

この記事には、次の Automation REST API 操作を使用して、これらのアクティビティを制御するのに役立つカスタム Azure Policy 定義が含まれています。具体的には、次のように使用します。

このポリシーは、runOn プロパティに基づいています。ポリシーは、プロパティの値を検証します。これには、既存の Hybrid Runbook Worker グループの名前が含まれます。値が null の場合は、ジョブ、ジョブスケジュール、または Webhook の作成要求が Azure サンドボックスを対象にすると解釈され、要求は拒否されます。

必要なアクセス許可

Azure Policy リソースへのアクセス許可を得るには、サブスクリプションレベルで所有者ロールのメンバーである必要があります。

ポリシー定義を作成して割り当てる

ここでは、ポリシールールを作成し、管理グループまたはサブスクリプションに割り当て、必要に応じてサブスクリプションでリソースグループを指定します。ポリシー言語に慣れていない場合は、ポリシー定義の構造に関するページでポリシー定義の構成方法を確認してください。

次の JSON スニペットを使用して、AuditAutomationHRWJobExecution.json という名前の JSON ファイルを作成します。

 {
   "properties": {
     "displayName": "Enforce job execution on Automation Hybrid Runbook Worker",
     "description": "Enforce job execution on Hybrid Runbook Workers in your Automation account.",
     "mode": "all",
     "parameters": {
       "effectType": {
         "type": "string",
         "defaultValue": "Deny",
         "allowedValues": [
            "Deny",
            "Disabled"
         ],
         "metadata": {
           "displayName": "Effect",
           "description": "Enable or disable execution of the policy"
         }
       }
     },
     "policyRule": {
       "if": {
         "anyOf": [
           {
             "allOf": [
               {
                 "field": "type",
                 "equals": "Microsoft.Automation/automationAccounts/jobs"
               },
               {
                 "value": "[length(field('Microsoft.Automation/automationAccounts/jobs/runOn'))]",
                 "less": 1
               }
             ]
           },
           {
             "allOf": [
               {
                 "field": "type",
                 "equals": "Microsoft.Automation/automationAccounts/webhooks"
               },
               {
                 "value": "[length(field('Microsoft.Automation/automationAccounts/webhooks/runOn'))]",
                 "less": 1
               }
             ]
           },
           {
             "allOf": [
               {
                 "field": "type",
                 "equals": "Microsoft.Automation/automationAccounts/jobSchedules"
               },
               {
                 "value": "[length(field('Microsoft.Automation/automationAccounts/jobSchedules/runOn'))]",
                 "less": 1
               }
             ]
           }
         ]
       },
       "then": {
         "effect": "[parameters('effectType')]"
       }
     }
   }
 }

次の Azure PowerShell または Azure CLI コマンドを実行して、AuditAutomationHRWJobExecution.json ファイルを使用してポリシー定義を作成します。
- Azure CLI
- PowerShell
```
 az policy definition create --name 'audit-enforce-jobs-on-automation-hybrid-runbook-workers' --display-name 'Audit Enforce Jobs on Automation Hybrid Runbook Workers' --description 'This policy enforces job execution on Automation account user Hybrid Runbook Workers.' --rules 'AuditAutomationHRWJobExecution.json' --mode All
```
このコマンドは、Audit Enforce Jobs on Automation Hybrid Runbook Workers という名前のポリシー定義を作成します。使用できるその他のパラメーターの詳細については、「az policy definition create」を参照してください。

場所のパラメーターを指定せずに呼び出す場合、az policy definition create は、既定により、セッションコンテキストの選択されたサブスクリプションにポリシー定義を保存することになります。定義を別の場所に保存するには、次のパラメーターを使用します。
- subscription - 別のサブスクリプションに保存します。サブスクリプション ID の GUID 値、またはサブスクリプション名の string 値を指定する必要があります。
- management-group - 管理グループに保存します。 string 値が必要です。
```
New-AzPolicyDefinition -Name 'audit-enforce-jobs-on-automation-hybrid-runbook-workers' -DisplayName 'Audit Enforce Jobs on Automation Hybrid Runbook Workers' -Policy 'AuditAutomationHRWJobExecution.json'
```
このコマンドは、Audit Enforce Jobs on Automation Hybrid Runbook Workers という名前のポリシー定義を作成します。使用できるその他のパラメーターの詳細については、「New-AzPolicyDefinition」を参照してください。

場所のパラメーターを指定せずに呼び出す場合、New-AzPolicyDefinition は、既定により、セッションコンテキストの選択されたサブスクリプションにポリシー定義を保存することになります。定義を別の場所に保存するには、次のパラメーターを使用します。
- SubscriptionId -別のサブスクリプションに保存します。 GUID 値が必要です。
- ManagementGroupName -管理グループに保存します。 string 値が必要です。

ポリシー定義を作成したら、次のコマンドを実行してポリシー割り当てを作成できます。
- Azure CLI
- PowerShell
```
az policy assignment create --name '<name>' --scope '<scope>' --policy '<policy definition ID>'
```
az policy assignment create の scope パラメーターは、管理グループ、サブスクリプション、リソースグループ、または単一のリソースに使用できます。このパラメーターは完全なリソースパスを使用します。各コンテナーの scope のパターンは、次のとおりです。 {rName}、{rgName}、{subId}、および {mgName} を、それぞれリソース名、リソースグループ名、サブスクリプション ID、および管理グループ名と置き換えます。 {rType} は、そのリソースのリソースの種類 (VM の場合は Microsoft.Compute/virtualMachines など) に置き換えられます。
- リソース - /subscriptions/{subID}/resourceGroups/{rgName}/providers/{rType}/{rName}
- リソースグループ - /subscriptions/{subID}/resourceGroups/{rgName}
- サブスクリプション - /subscriptions/{subID}
- 管理グループ - /providers/Microsoft.Management/managementGroups/{mgName}
Azure Policy の定義 ID は、PowerShell で次のコマンドを実行して取得できます。
```
az policy definition show --name 'Audit Enforce Jobs on Automation Hybrid Runbook Workers'
```
作成したポリシー定義のポリシー定義 ID は、次の例のようになります。
```
"/subscription/<subscriptionId>/providers/Microsoft.Authorization/policyDefinitions/Audit Enforce Jobs on Automation Hybrid Runbook Workers"
```
```
$rgName = Get-AzResourceGroup -Name 'ContosoRG'
$Policy = Get-AzPolicyDefinition -Name 'audit-enforce-jobs-on-automation-hybrid-runbook-workers'
New-AzPolicyAssignment -Name 'audit-enforce-jobs-on-automation-hybrid-runbook-workers' -PolicyDefinition $Policy -Scope $rg.ResourceId
```
ContosoRG を対象とするリソースグループの名前に置き換えます。

New-AzPolicyAssignment の Scope パラメーターは、管理グループ、サブスクリプション、リソースグループ、または単一のリソースに使用できます。このパラメーターは、Get-AzResourceGroup の ResourceId プロパティが返す完全なリソースパスを使用します。各コンテナーの Scope のパターンは、次のとおりです。 {rName}、{rgName}、{subId}、および {mgName} を、それぞれリソース名、リソースグループ名、サブスクリプション ID、および管理グループ名と置き換えます。 {rType} は、そのリソースのリソースの種類 (VM の場合は Microsoft.Compute/virtualMachines など) に置き換えられます。
- リソース - /subscriptions/{subID}/resourceGroups/{rgName}/providers/{rType}/{rName}
- リソースグループ - /subscriptions/{subId}/resourceGroups/{rgName}
- サブスクリプション - /subscriptions/{subId}
- 管理グループ - /providers/Microsoft.Management/managementGroups/{mgName}

Azure portal にサインインします。
Azure portal で [すべてのサービス] を選択し、 [Policy] を検索して選択することで、Azure Policy サービスを起動します。
ページの左側にある [コンプライアンス] を選択します。そして、作成したポリシーの割り当てを探します。

いずれかの Automation REST 操作が、要求本文で Hybrid Runbook Worker を参照せずに実行されると、Azure サンドボックスで操作を実行しようとしたことを示す次の例のようなエラーで、403 応答コードが返されます。

{
  "error": {
    "code": "RequestDisallowedByPolicy",
    "target": "Start_VMS",
    "message": "Resource 'Start_VMS' was disallowed by policy. Policy identifiers: '[{\"policyAssignment\":{\"name\":\"Enforce Jobs on Automation Hybrid Runbook Workers\",\"id\":\"/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/MAIC-RG/providers/Microsoft.Authorization/policyAssignments/fd5e2cb3842d4eefbc857917\"},\"policyDefinition\":{\"name\":\"Enforce Jobs on Automation Hybrid Runbook Workers\",\"id\":\"/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Authorization/policyDefinitions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f\"}}]'.",
    "additionalInfo": [
      {
        "type": "PolicyViolation",
        "info": {
          "policyDefinitionDisplayName": "Enforce Jobs on Automation Hybrid Runbook Workers",
          "evaluationDetails": {
            "evaluatedExpressions": [
              {
                "result": "True",
                "expressionKind": "Field",
                "expression": "type",
                "path": "type",
                "expressionValue": "Microsoft.Automation/automationAccounts/jobs",
                "targetValue": "Microsoft.Automation/automationAccounts/jobs",
                "operator": "Equals"
              },
              {
                "result": "True",
                "expressionKind": "Value",
                "expression": "[length(field('Microsoft.Automation/automationAccounts/jobs/runOn'))]",
                "expressionValue": 0,
                "targetValue": 1,
                "operator": "Less"
              }
            ]
          },
          "policyDefinitionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Authorization/policyDefinitions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
          "policyDefinitionName": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
          "policyDefinitionEffect": "Deny",
          "policyAssignmentId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/MAIC-RG/providers/Microsoft.Authorization/policyAssignments/fd5e2cb3842d4eefbc857917",
          "policyAssignmentName": "fd5e2cb3842d4eefbc857917",
          "policyAssignmentDisplayName": "Enforce Jobs on Automation Hybrid Runbook Workers",
          "policyAssignmentScope": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/MAIC-RG",
          "policyAssignmentParameters": {}
        }
      }
    ]
  }
}

試行された操作は、次の例のように、Automation アカウントのアクティビティログにも記録されます。

失敗したジョブ実行のアクティビティログの例。

次のステップ

Runbook を操作するには、「Azure Automation で Runbook を管理する」を参照してください。

次の方法で共有

Azure Policy を使用して Hybrid Runbook Worker でジョブの実行を適用する

必要なアクセス許可

ポリシー定義を作成して割り当てる

次のステップ

フィードバック

その他のリソース