このページのトピック

Bash と PowerShell を使用してコンピュータにポリシーを割り当てる

ポリシー設定に従ってコンピュータが保護されるように、コンピュータにポリシーを割り当てます。たとえば、 Workload Securityに追加されたばかりのコンピュータ、またはポリシーが割り当てられていないことが検出されたコンピュータにポリシーを割り当てます。

ポリシーを割り当てるには、コンピュータの変更操作を使用します。

始める前に

BashまたはPowerShellを使用してAPIを使用するように環境が設定されていることを確認しておく必要があります。

このレシピを完了するために必要な次の情報を収集します。

Workload SecurityのURL
APIキーの秘密鍵
ポリシーを割り当てるコンピュータのID。
割り当てるポリシーのID。

ポリシーまたはコンピュータのIDがわからない場合は、ポリシーの検索およびコンピュータのリストの取得レシピを使用して取得できます。

Bash

ターミナルまたは使用しているコマンドラインツールを開きます。
次のコマンドを入力して、 <YOUR URL> を Workload SecurityのURLに置き換え、 <YOUR SECRET KEY> をAPIキーのシークレットに置き換えます。
- url=<YOUR URL>
  
  例: url=https://cloudone.trendmicro.com
- secret=<YOUR SECRET KEY>
  
  例: secret=5C58EADA-04BC-4ABC-45CF-B72925A0B674:aFBgpPV8eJQGaY2Dk0LmyQMD7nUGvyIDfIbIQo8Zgm8=
次のコマンドを入力してコンピュータのIDを保存し、 <YOUR COMPUTER ID> をコンピュータのIDに置き換えます。

computerID=<YOUR COMPUTER ID>

例: computerID=51
次のコマンドを入力してポリシーのIDを保存し、 <YOUR POLICY ID> をコンピュータのIDに置き換えます。

policyID=<YOUR POLICY ID>

例: policyID=1
次のコマンドを入力して、応答データを保存するJSONファイルを指定します <FILE PATH> は作成するファイルに置き換えます。 .json 拡張子を含むファイル名を指定します。

file=<FILE PATH>

例: file=~/Documents/computer_modify.json
要求を送信するには、次のコマンドを入力します。
```
curl -X POST "$url/api/computers/$computerID" -H "api-secret-key: $secret" -H "api-version: v1" -H "Content-Type: application/json" -d "{ \"policyID\": \"$policyID\" }" > $file
```
返されたJSONを(ファイルに書き込む代わりに)読み取り可能な形式でターミナルに出力するには、cURLコマンドの結果をパイプ処理して jqに渡します。上記のコマンドで、 > $file を | jq .に置き換えます。

WebブラウザでJSONファイルを開きます。 WebブラウザはJSONを読み取り可能にフォーマットする必要があります。次の例のように、コンピュータを表すJSONコードがIDとpolicyIDに想定される値で表示されます。

{
    hostName: "testcomputer",
    displayName: "my test computer",
    description: "",
    lastIPUsed: "",
    platform: "Windows",
    groupID: 0,
    policyID: 1,
    relayListID: 1,
    lastSendPolicyRequest: 1568653868230,
    agentVersion: "12.0.0.563",
    computerStatus: {...},
    computerSettings: {...},
    ID: 51,
    antiMalware: {...},
    webReputation: {...},
    sensingMode: {...},
    firewall: {...},
    intrusionPrevention: {...},
    integrityMonitoring: {...},
    logInspection: {...},
    applicationControl: {...}
}

例を簡潔にするために、複数のプロパティ (オブジェクトなど) で構成される値は {...}と表されます。すべての情報が検索結果に表示されます。

PowerShell

PowerShellを起動します。
TLS 1.2を使用するには、次のコマンドを入力します.TLS 1.2は、セキュリティで保護された接続を確立するためにManagerで必要となります。
```
[Net.ServicePointManager]::SecurityProtocol += [Net.SecurityProtocolType]::Tls12
```
次のコマンドを入力して、 <YOUR URL> を Workload SecurityのURLに置き換え、 <YOUR SECRET KEY>をAPIキーのシークレットに置き換えます。
- $url = "<YOUR URL>"
  
  例: url=https://cloudone.trendmicro.com
- $secret = "<YOUR API KEY SECRET>"
  
  例: $secret="5C58EADA-04BC-4ABC-45CF-B72725A0B674:aFBgpPV8eJQGaY2Dk0LmyQMD7nUGvyIDfIbIQo8Zgm8="
- $headers = @{‘api-version’ = “v1”; ‘api-secret-key’ = $secret; 'Content-Type' = "application/json"}
次のコマンドを入力してコンピュータのIDを保存し、 <YOUR COMPUTER ID> をコンピュータのIDに置き換えます。

$computerID = "<YOUR COMPUTER ID>"

例: $computerID = "51"
次のコマンドを入力してポリシーのIDを保存し、 <YOUR POLICY ID> をコンピュータのIDに置き換えます。

$policyID = "<YOUR POLICY ID>"

例: $policyID = "1"
次のコマンドを入力して、レスポンスデータを保存するJSONファイルを指定し、 <FILE PATH> を作成するファイルに置き換えます。拡張子が.jsonのファイル名を指定します。

$file="<FILE PATH>"

例: $file="$HOME\Documents\policy_search.json"
要求を送信するには、次のコマンドを入力します。
```
Invoke-RestMethod -Method 'Post' -Uri "$url/api/computers/$computerID" -Headers $headers -Body @"
{"policyID": "$policyID"}
"@ -OutFile $file
```
エラーメッセージ The underlying connection was closed: An unexpected error occurred on a sendが表示されたら、PowerShellを終了して、PowerShellを再度開いて、手順を繰り返し実行してください。

WebブラウザでJSONファイルを開きます。 WebブラウザはJSONを読み取り可能にフォーマットする必要があります。次の例のように、IDとpolicyIDに期待される値を持つコンピュータを表すJSONコードが表示されます。

{
    hostName: "testcomputer",
    displayName: "my test computer",
    description: "",
    lastIPUsed: "",
    platform: "Windows",
    groupID: 0,
    policyID: 1,
    relayListID: 1,
    lastSendPolicyRequest: 1568653868230,
    agentVersion: "12.0.0.563",
    computerStatus: {...},
    computerSettings: {...},
    ID: 51,
    antiMalware: {...},
    webReputation: {...},
    sensingMode: {...},
    firewall: {...},
    intrusionPrevention: {...},
    integrityMonitoring: {...},
    logInspection: {...},
    applicationControl: {...}
}