UiPath Documentation
orchestrator
2022.10
false
Orchestrator ユーザー ガイド
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。

Webhook

Webhook を使用すると、UiPath のオートメーションとお使いのアプリケーション エコシステム全体とをより適切に連携させることができます。Orchestrator のイベントをサブスクライブし、その情報を外部のいずれかの DCM、BPM、CRM ソリューションに送信することで、さまざまなユーザーに情報 (たとえば処理可能なキュー アイテムが新しく存在すること、トリガーが失敗したこと、プロセスが更新されたことなど) を伝えられます。

Webhooks allow external systems to subscribe and listen to different types of Orchestrator events. The Webhooks page enables you to easily set them up and view the ones that have been previously created. You can also disable webhooks, search for a specific one, edit or delete them.

イベントは、ジョブ、ロボット、キュー、キュー アイテム、プロセス、トリガーで利用可能です。

各イベントは、情報を含む指定した URL にペイロードを送信します。プロパティには、すべてに共通なものとイベントの種類に固有のものがあります。

Webhook イベントはフォルダーごとに作成されるため、フォルダー間で共有されるリソース (キューなど) に Webhook イベントが関連付けられている場合は、フォルダーごとに個別の Webhook イベントが生成されます。

イベントの転送要求が失敗すると、その特定の Webhook のサーキット ブレーカーが開き、Webhook が 1 時間無効化されます。

注:
  • サーキット ブレーカーが開いている間に送信されるはずだった Webhook イベントはスキップされ、サーキット ブレーカーが閉じてもリトライされません。
  • Webhook イベントは保存されず、リトライやエクスポートもできません。さらに、外部プラットフォームへの呼び出しが失敗すると、イベントは失われます。Webhook はリアルタイム処理用に設計されています。

共通のペイロード プロパティ​

プロパティ名プロパティの種類説明および例
入力string通知をトリガーするイベントの種類です。

このプロパティはすべてのイベントの種類で表示されます。

例：

"Type": "job.created"

"Type":"process.updated"
EventIdstringイベント発生時に、イベントに対して一意に生成される ID です。

このプロパティはすべてのイベントの種類で表示されます。

例：

"EventId":"3e5af0113e674ae597c579cb35ed8630"
TimestampRFC 8601 日付イベントが生成された日付と時刻です。

このプロパティはすべてのイベントの種類で表示されます。

例：

"Timestamp":"2018-11-02T11:47:48.5790797Z"
TenantIdintegerイベントが生成されたテナントの ID です。既定のテナントは 1 です。

このプロパティはすべてのイベントの種類で表示されます。

例：

"TenantId":3
UserIdintegerイベントをトリガーしたアクションを実行したユーザーの ID です。

イベントが、ロボットまたはトリガーのいずれかによってトリガーされた場合、このパラメーターは表示されません。

このプロパティはすべてのイベントの種類で表示されます。

例：

"UserId": 4947
FolderIdintegerイベントが生成されたフォルダーの ID です。

イベントがモダン ロボットによってトリガーされた場合、このパラメーターは表示されません。

例：

"FolderId": 26

権限​

[Webhooks] ページでさまざまな操作を行うには、Webhook 上で該当する権限を持っていなければなりません。

  • 表示 - Webhook とその詳細を確認する、そうした情報を API を使用してあるいは Ping 要求を送信することで取得する、Webhook がサブスクライブできる全イベントのリストを取得するなどが可能です。
  • 作成 - この権限があると、新しい Webhook を追加できます。これには、[表示] 権限も必要になります。
  • 編集 - UI または API を使用して Webhook を編集する権限が付与されます。これには、[表示] 権限も必要になります。
  • 削除 - Webhook を削除できる権限です。これには、[表示] 権限も必要になります。

認証​

すべての Webhook HTTP 要求は、Webhook の作成時に追加したシークレットを使用して認証します。これは、HMAC-SHA256 鍵付きハッシュを使用して要求本文と結合されます。その結果、シークレット情報を一切含まないセキュリティで保護された署名となります。この署名は、要求ごとに一意であり、X-UiPath-Signature HTTP ヘッダーを通じて送信されます。

Orchestrator の要求を受信するクライアント アプリケーションは、要求の信頼性をチェックする必要があります。要求の署名は、次のパターンに従って行われます。

  • クライアント アプリケーションは、Orchestrator からの要求を受信します。
  • クライアント アプリケーションは、要求に基づいて署名を計算します。
  • クライアント アプリケーションは、自身が計算した署名と要求の署名を照合します。
    • 署名が一致しない場合、クライアント アプリケーションは要求を処理しません。
    • 署名が一致した場合、クライアント アプリケーションは要求を処理します。

署名の計算は、次のように行われます。

  1. X-UiPath-Signature HTTP ヘッダーを取得します。

  2. 署名のローバイトを取得するには、Base64 からヘッダーの値をデコードします。

  3. 生の (ロー) 要求本文を取得します。

    注:

    Orchestrator の要求は常に UTF-8 でエンコードされています。

  4. SHA256 と (UTF-8 でエンコードされた) 署名鍵を使用してハッシュを計算します。

  5. 計算した署名と X-UiPath-Signature HTTP ヘッダーからの値を照合します。

    • 署名が一致しない場合、要求を処理してはいけません。
    • 署名が一致した場合、クライアント アプリケーションは要求を処理します。

署名検証の例​

using System;
using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Threading.Tasks;


public async Task<bool> IsValidRequestAsync(HttpRequestMessage request, string secret)
{
    if (!request.Headers.TryGetValues("X-UiPath-Signature", out var headerValues))
        return false;

    var orchestratorSignature = Convert.FromBase64String(headerValues.First());
    using (var sha = new HMACSHA256(key: Encoding.UTF8.GetBytes(secret)))
    {
        var computedSignature = sha.ComputeHash(await request.Content.ReadAsByteArrayAsync());
        return ByteArrayEquals(orchestratorSignature, computedSignature);
    }
}
using System;
using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Threading.Tasks;


public async Task<bool> IsValidRequestAsync(HttpRequestMessage request, string secret)
{
    if (!request.Headers.TryGetValues("X-UiPath-Signature", out var headerValues))
        return false;

    var orchestratorSignature = Convert.FromBase64String(headerValues.First());
    using (var sha = new HMACSHA256(key: Encoding.UTF8.GetBytes(secret)))
    {
        var computedSignature = sha.ComputeHash(await request.Content.ReadAsByteArrayAsync());
        return ByteArrayEquals(orchestratorSignature, computedSignature);
    }
}

const { createServer } = require('http');
const { createHmac } = require('crypto');

const PORT = 9090
const WEBHOOK_SECRET = '<same secret as configured in Orchestrator>'

const isValidRequest = (body /* Buffer */, secret /* string */, expectedSignature /* string */) =>
    expectedSignature == null || createHmac('sha256', secret)
        .update(body)
        .digest('base64') === expectedSignature

const server = createServer((req, resp) => {

    let body = new Buffer([])

    req.on('data', chunk => body = Buffer.concat([body, chunk]))

    req.on('end', () => {

        if (!isValidRequest(body, WEBHOOK_SECRET, req.headers['x-uipath-signature'])) {
            console.error('Invalid signature')
            resp.statusCode = 401 // Unauthorized
        } else {

            let payload = JSON.parse(body.toString('utf8'))

            // Process request
            console.log(payload)

            resp.statusCode = 202 // Accepted
        }

        resp.end()
    })

})

server.listen(PORT)
const { createServer } = require('http');
const { createHmac } = require('crypto');

const PORT = 9090
const WEBHOOK_SECRET = '<same secret as configured in Orchestrator>'

const isValidRequest = (body /* Buffer */, secret /* string */, expectedSignature /* string */) =>
    expectedSignature == null || createHmac('sha256', secret)
        .update(body)
        .digest('base64') === expectedSignature

const server = createServer((req, resp) => {

    let body = new Buffer([])

    req.on('data', chunk => body = Buffer.concat([body, chunk]))

    req.on('end', () => {

        if (!isValidRequest(body, WEBHOOK_SECRET, req.headers['x-uipath-signature'])) {
            console.error('Invalid signature')
            resp.statusCode = 401 // Unauthorized
        } else {

            let payload = JSON.parse(body.toString('utf8'))

            // Process request
            console.log(payload)

            resp.statusCode = 202 // Accepted
        }

        resp.end()
    })

})

server.listen(PORT)
  • 共通のペイロード プロパティ​
  • 権限​
  • 認証​
  • 署名検証の例​

このページは役に立ちましたか?

接続

ヘルプ リソース サポート

学習する UiPath アカデミー

質問する UiPath フォーラム

最新情報を取得