SmartTasks

マネジメントスマートタスクは、システム内のさまざまなトリガーに応じた自動アクションを設定することができます。SmartTaskは、トリガーとアクションの組み合わせです。

  • トリガーはイベントであり、現在はポリシーのインストールやセッションの公開など、既存の管理操作の観点から定義されています。

  • アクションは、スクリプトの実行、Webリクエストの投稿、電子メールの送信など、トリガーイベントの後に行われる自動的な応答です。

使用可能なトリガー

  • Before Publish- 管理者がセッションをパブリッシュするときに発行されます。SmartTaskは、セッションのメタデータ(発行管理者、ドメイン情報、セッション名)をアクションに渡します。ローカルのManagement APIサーバが利用可能な場合、公開されようとしているセッションの変更は、"show changes" APIへの応答としてフォーマットされます。

  • After Publish- 管理者がセッションのパブリッシュを成功させた後に発行されます。SmartTaskは、Before Publishトリガーと同じ情報をアクションに渡します。

  • After Install Policy- ポリシーがインストールされた後に実行されます。SmartTaskは、インストールされたパッケージ、インストールを開始した管理者、タスクの結果など、ポリシーのインストールタスクに関連する情報をアクションに渡します。

利用可能なアクション

  • スクリプトの実行- あらかじめ定義されたリポジトリスクリプトを実行します。スクリプトは、トリガーのデータを最初のパラメータとして取得します。トリガーのデータはBase64でエンコードされたJSONデータとして渡され、それをデコードしてカスタムビジネスロジックを実装することができます。

    Before" オペレーショントリガーで実行するように設定された SmartTasks では、リポジトリスクリプトは "result" とオプションの "message" フィールドを持つ JSON オブジェクトを出力し、コード 0 で終了することにより、操作を中断するか継続するかを合図することができます。result "フィールドの値が "failure "である場合、操作は中断される。

    他のトリガーで実行するように設定されたSmartTasksの場合、終了コード0は成功として扱われます。それ以外の終了コードは失敗として扱われる。

    - デフォルトでは、リポジトリスクリプトはローカルのセキュリティ管理サーバ上で実行されますが、Web APIを使用してカスタマイズすることができます。

  • WebRequest- 設定された URL に対して HTTPS POST Web リクエストを実行します。トリガーのデータは、リクエストのペイロードにJSONデータとして渡されます。

    注:

    • 設定するURLは、HTTPSで始まり、そのようなリクエストを処理できるターゲットWebサーバである必要があります。

    • 自己署名入りSSL証明書を持つWebサーバの場合、証明書のフィンガープリントを指定して信頼性を確立します。SmartTaskエディタでGet Fingerprint をクリックするか、Webブラウザで証明書を表示すると、フィンガープリントを取得できます。

    Before" オペレーショントリガーで実行するように設定された SmartTasks の場合、リポジトリスクリプトは、JSON オブジェクト "result" およびオプションの "message" フィールドと 200 OK というステータスで応答することにより、操作を中断するか継続するかを通知することができます。 result "フィールドの値が "failure "である場合、操作は中断される。

    他のトリガーと一緒に実行するように設定されたSmartTasksの場合、200 OKのリターンコードは成功として扱われます。それ以外の終了コードは失敗として扱われる。

SmartTaskのプロパティを設定する

  1. SmartTaskの一意の名前を入力します - nameプロパティは必須で、大文字と小文字を区別します。

  2. トグルボタンでSmartTaskのON/OFFを切り替えます。

  3. オプション - SmartTaskの説明を入力します。

  4. SmartTaskのトリガーを選択します。

  5. トリガーが発射されたときに発生するアクションを選択します。

  6. カスタムデータ -カスタムデータフィールドにJSONオブジェクトを追加することで、トリガー情報と共に送信されるJSONデータに追加情報を追加することができます。JSONカスタムデータは、トリガーのペイロードに連結され、アクションに渡されます。

  7. オプション - SmartTaskオブジェクトのタグを追加します。

SmartTaskの詳細プロパティ

利用可能な詳細オプションは、「一般」タブで選択したアクションによって異なります。

Webリクエストの送信

スクリプトの実行

  • タイムアウト- リクエストがタイムアウトし、中止されるまでの秒数。

  • スクリプトの実行に失敗したり、タイムアウトした場合- タイムアウト(または実行失敗)をエラーとして扱い、イベントを中断するか、通常通り続行します。