WorkDriveでカスタムアプリを表示および管理する

1. アプリ詳細の更新: 任意のアプリをクリックします。該当するアプリの詳細ページが開き、要件に合わせてアプリ名や説明を編集できます。
   
   
2. カスタムアプリの削除: WorkDriveチームからカスタムアプリを削除したい場合は、削除したいアプリのアプリ詳細ページ下部にある削除ボタンをクリックして削除できます。
   
   

メモ:

1. 各カスタムアプリにつき最大10件のWebhookを作成できます。
   
2. Webhookの呼び出しは1日あたり最大50,000回までです。
   

1. 左下のAdmin Consoleをクリックします。Admin Consoleウィンドウが開き、ダッシュボードタブが初期設定で選択されます。
   
2. 左側のペインからAppsタブをクリックして移動します。Appsタブが右側に表示され、すべてのカスタムアプリが一覧で表示されます。
   
   
3. Webhookを設定したいカスタムアプリケーションを選択します。カスタムアプリウィンドウが開き、App 詳細タブが初期設定で選択されます。
   
   
4. Webhookタブに移動し、新しく作成する Webhookをクリックします。新しく作成する Webhookウィンドウが開きます。
   
5. Webhookの名前と説明をそれぞれの項目に入力します。
   
   
6. 通知を受信したいEndpoint URLを入力します。
   メモ: URLが有効であり、Webhookの処理が可能であることを確認してください。
   
   
7. トリガーイベント（ファイル、フォルダー、チームフォルダー、組織ベース）を選択し、イベントの対象となる場所を指定します。
   WorkDriveで利用可能なイベントタイプの詳細はこちらをクリック
   
   
8. 作成 Webhookをクリックします。
   指定したイベントがWorkDriveで発生すると、指定したURLに通知が届きます。
   
   

Webhook データの内容

{

'data': [

{

'resource_info': {

'parent_id': 'lvwg28f94012d0a484328b6175c6da296b433',

'resource_id': 'ep19987f95a0161684d8ea1b3161f16e41e38',

'resource_name': '初期設定 App Migration レポート.csv',

'base_parent_id': 'lvwg28f94012d0a484328b6175c6da296b433',

'ステータス': 1

},

'share_info': {

'役割': '7',

'shared_type': '14',

'shared_by': 5608329,

'shared_status': 14,

'shared_to': '111118000000038003'

},

'association_info': {

'entity_value': 'Guna',

'entity_label': 'データ',

'タブ': '見込み客',

'entity_id': 'EID0000001011'

},

'event_id': '839687000000338003',

'event_type': 'file_create',

'app_key': '1000.0UUMEY8E1WWRF26GF0XIHRLKDHHFNH',

'webhook_id': 'ep19987f95a0161684d8ea1b3161f16e41e38-839687000000335005',

'module_name': '',

'portal_id': '638722',

'team_id': 'lvwg26329e83825ed4815b2e685e1781d6728',

'種類': 'event_callback',

'event_time': 1600422715262,

'event_by': 61184597

}

]

}

Webhook認証

1. 共有シークレットキーを使用して、Webhookデータの内容に署名し、エンコードします。
2. 生成された署名を、WebhookリクエストのX-ZWDWebhook-署名ヘッダーに送信された値と比較します。

HMAC署名の作成

JWSヘッダーは以下の通りです：

{

'alg': 'HS256',

'typ': 'JWT'

}

1. alg:HS256アルゴリズムがハッシュ署名の生成に使用されます。
2. typ: typ（種類）ヘッダーパラメータは、署名されたコンテンツの種類を示すために使用されます。
   

1. JWTヘッダーとWebhookデータの内容を個別にBase64エンコードし、ピリオド（“.”）で結合します。
   
   
2. Base64エンコードされたヘッダーおよびBase64エンコードされたWebhookデータの内容をSHA-256アルゴリズムでハッシュし、得られた署名をBase64エンコードしてWebhook署名を作成します。
   
   
3. Base64エンコードされたヘッダー、Base64エンコードされたWebhookデータの内容、Base64エンコードされたHMAC SHA-256署名の3つの要素を、区切り文字としてピリオド（'.'）で連結します。

X-ZWDWEBHOOK-署名: . . . )

HMAC署名の認証

メモ: カスタムアプリ用に設定されたすべてのWebhookは、署名の検証に同じシークレットキーを使用します。

1. 画面左下のAdmin Consoleをクリックします。Admin Consoleウィンドウが開き、ダッシュボードタブが初期設定で選択されています。
2. 左側のペインからAppsタブをクリックして移動します。右側にAppsタブが表示され、すべてのカスタムアプリの一覧が表示されます。
3. シークレットキーをコピーしたいカスタムアプリを選択します。これにより、カスタムアプリウィンドウが開き、App詳細タブが初期設定で選択されます。
   
   情報: すでにWebhookページにいる場合は、右側の表示するシークレットキーリンクをクリックしてください。該当するApp詳細タブに移動します。
   
   
4. App詳細タブ内のシークレットキー項目に移動し、その値をコピーします。このシークレットキーをWebhookの検証に使用できます。
   
   

1. 受領済みWebhookリクエストからWebhookデータの内容を抽出します。
   
   
2. 共有シークレットキーを使ってWebhookデータの内容のHMAC署名を計算します。この際、SHA-256ハッシュアルゴリズムを使用します。
   
   
3. 計算したHMAC署名をBase64エンコーディング方式でエンコードします。
   
   
4. WebhookリクエストのX-ZWDWEBHOOK-署名ヘッダーから署名を抽出します。
   
   
5. Webhookデータの内容の計算済みBase64エンコードSHA-256ハッシュが、WebhookリクエストのX-ZWDWEBHOOK-署名ヘッダーで提供されている値と一致していることを確認します。
   
   一致しない場合は、Webhookリクエストを却下してください。

メモ: Webhookデータの正確かつ一貫した検証のために、作成および検証の両方の仕組みで同じエンコーディング方式を使用してください。

WorkDriveでWebhookの表示と管理

1. Admin Consoleを左下隅でクリックします。Admin Consoleウィンドウが開き、ダッシュボードタブが初期設定で選択されます。
   
   
2. 左側のペインからAppsタブをクリックして移動します。右側にAppsタブが表示され、すべてのカスタムアプリ一覧が表示されます。
   
   
3. Webhookの変更を行いたいカスタムアプリケーションを選択します。カスタムアプリウィンドウが開き、App 詳細タブが初期設定で選択されます。
   
   
4. Webhookタブをクリックし、カスタムアプリに設定されているWebhookの一覧および各管理設定にアクセスします。
   
   
1. Webhookを有効化または無効化するには：Webhookタブ内のオン／オフ切り替えを操作してください。
   
   
2. Webhookの名前や説明を編集するには：その他の操作アイコンをクリックし、編集オプションを選択します。
   
   
3. Webhookを削除するには：その他の操作アイコンをクリックし、削除を選択します。確認ダイアログで再度削除をクリックして削除を確定してください。