トリガーの作成

オンライン編集

トリガーは、特定のイベントをモニターし、その条件が満たされるとアクションを開始します。トリガーを作成するには、curl コマンドを使用するか、 WebSphere Automation REST API 用の Swagger UI を使用します。

このタスクについて

WebSphere Automation REST API へのアクセス権限が必要です。また、Swagger UI ページで「許可」をクリックして、 Red Hat OpenShift Container Platform 管理者資格情報で認証する必要があります。

WebSphere Automation でのトリガーの作成

WebSphere Automation REST API の Swagger ユーザー・インターフェースを使用して、新規アクションを作成します。アクション・リソースは、Swagger UI ( https://<cpd-route>/websphereauto/secvul/apis/openapi/ui/) で使用可能な Self-Secure API の一部です。 <cpd-route> を見つける方法については、「 REST API を表示する」を参照してください。

自己保護 API の Swagger UI ページで、以下のステップを実行してトリガーを作成します。

トリガーを作成するには、「事後 /trigger」をクリックします。
セクションが展開され、「パラメーター」タブ、要求本体とスキーマの例、および応答が表示されます。
トリガー・スキーマを表示するには、「スキーマ」をクリックします。
各パラメーターのスキーマと許容値を十分に理解していることを確認してください。
「試用」をクリックします。
これで、要求本体領域を編集できます。
変更するパラメーターのコロンの後の引用符で囲まれた値を変更して、要求本体を変更します。
トリガー・リソース・パラメータの詳細については、トリガー・リソースを参照のこと。

JSONata 式を使用して、条件処理を提供したり、リソース通知からアクションに値を渡すことができます。詳細については、リソース・トリガの作成と JSONata式の検証を参照してください。
「実行」をクリックします。
応答コードを調べてください。
トリガーが有効であれば、正常な操作に対する応答コードは 201 です。トリガーはアクティブであり、定義された基準が満たされている場合に、指定された actionId を使用してアクションを呼び出す準備ができています。

JSONata 式の検証

リソース通知からトリガーを通してアクションにデータを渡す場合、またはリソース通知のデータに基づいて条件処理を使用する場合、以下のJSONata Exerciserを使用してJSONata式を検証することができます。 https://try.jsonata.org/ 外部リンク・アイコン .

トリガーの基礎となるリソース通知の完全な JSON コードをコピーし、それを JSON パネルに貼り付けます。
例については、トリガーリソースを参照のこと。
「JSONata」パネルで JSONata 式を作成します。
例えば、以下の JSONata 式は、 create vulnerability イベントを評価して、脆弱性の 1 つ以上の CVE の重大度が 9 より大きいかどうかを判別します (CVSS スケール 0 から 10)。
```
$count(vulnerability.cves[cvssBaseScore > 9 ]) > 0
```
別の例として、以下の JSONata 式があります。
```
$vulnerability.cves
```
以下のコード・スニペットのようなデータを渡すことができます。
```
{
        「id"：" CVE-2021-44228 "、
        "description": "ローラム・イプサム・ドール・シット・アメット ...",
        "cvssBaseScore": 10
      }
```
3 番目のパネルは、式の結果で自動的に更新されます。
JSONata 式を conditionとして使用するには、その式がブール値 (つまり、以下のいずれかの結果を持つ) でなければなりません。trueまたはfalse)。条件は次のように評価する必要がありますtrueトリガーがアクションを起動します。

リソース通知からアクションにデータを渡す場合は、必要な値を渡すために式が構文的に正しいことを確認してください。