REST API を使用した BESPluginPortal プラグインの構成

プラグイン構成は、REST API を使用して BigFix アクションを発行することで実行できます。

残りの API に渡されるデータは BES XML ファイルでなければなりません。

必要な構成用のコマンドを含むアクション・スクリプトを作成し、それに応じて BES XML のフィールドにアクションを入力するだけで十分です。このような XML の例を以下に示します。

<?xml version="1.0" encoding="utf-8"?>
<BES xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd=
"http://www.w3.org/2001/XMLSchema" SkipUI="true">
    <SingleAction>
        <Title>test action</Title>
        <Relevance>true</Relevance>
        <ActionScript>
            plugin store "<plugin name>" set "<setting key>" value "<setting value>" on "{parameter "action issue date" of action}"
        </ActionScript>
        <SuccessCriteria />
        <Settings />
        <SettingsLocks />
        <Target>
            <ComputerID>0123456789</ComputerID>
        </Target>
    </SingleAction>
</BES>

ActionScript エレメントには、アクション・スクリプト・テキストが含まれます。

このアクションのターゲットは、構成するプラグインがインストールされている BESPluginPortal マシンのネイティブ表現である必要があります。したがって、Target フィールド内の ComputerID エレメントを使用し、その値に適切なコンピューター IDを入力すると便利です。

XML ファイルまたは XML ストリングをコードで作成した後、XML に記述されているアクションを POST を実行して発行できます。

次のコマンドは、cURL を使用して POST を実行します。ファイル action.xml は、ポート <port> (通常、BigFix の場合は 52311) を介してサーバー <server> に通知され、action.xml に含まれるアクションを作成して実行します。

curl --request POST --data-binary @action.xml --user <username>:<password> https://<server>:<port>/api/actions

curl -X POST -d @action.xml -ku <username>:<password> https://<server>:<port>/api/actions

Action REST API リソースについて詳しくは、『Action 』または BES.xsd および BESAPI.xsd ファイルを参照してください。

または、 IEM CLI を使用して BigFix REST API に対する要求を簡単に発行することもできます。

これを行うには、まず IEM CLI でセッションを開きます。端末を開き、BigFix Server フォルダーで IEM CLI を見つけます。

その後、次のコマンドを実行します。

iem login --server=<server>:<port> --user=<user> --password=<password>

その後、セッションが開いたら、次のコマンドを使用して要求を発行するだけです。

iem POST <path to action.xml> /api/actions

詳しくは、『 IEM CLI からの要求の実行』を参照してください。