Zendesk を Google SecOps と統合する
このドキュメントでは、Zendesk を Google Security Operations と統合する方法について説明します。
ユースケース
Zendesk 統合では、Google SecOps の機能を使用して、次のユースケースをサポートしています。
インシデント チケット発行の自動化: セキュリティ通知から Zendesk チケットを自動的に作成し、すべてのインシデントが追跡され、適切なチームに割り当てられるようにします。
アナリストのコミュニケーションを効率化する: ハンドブックから直接チケットにコメントや内部メモを追加して、プラットフォームを離れることなく関係者に情報を提供できます。
対応ワークフローを標準化する: Zendesk マクロをチケットに適用して、繰り返しの操作を自動化し、一般的なセキュリティ問題の一貫した処理を確保します。
チケットの解決を追跡する: チケットの詳細とステータスの更新を定期的に取得して、両方のプラットフォームでインシデントのライフサイクルを同期します。
過去のコンテキストを検索する: 既存のチケットをキーワードでクエリして、関連する過去のインシデントを見つけ、現在の調査を迅速化します。
始める前に
Google SecOps で統合を構成する前に、Zendesk 環境で次の要件を確認します。
API トークン: 管理者は、接続を認証するために有効な API トークンを生成する必要があります。詳しい手順については、Zendesk API への API トークン アクセスの管理をご覧ください。
アカウントの権限: API トークンの生成に使用するアカウントに、ターゲット グループでチケットを作成および更新するための十分な権限があることを確認します。API は、認証ユーザーの権限を継承します。つまり、管理者が生成した API トークンは、その管理者に割り当てられたロールの権限によって制限されます。
トークン アクセス: Zendesk API 設定でトークン アクセスを有効にして、統合が Zendesk API と通信できるようにします。
統合のパラメータ
Zendesk 統合には、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Server Address |
必須。 Zendesk インスタンスの URL。 デフォルト値は |
User Email Address |
必須。 接続の認証に使用される Zendesk ユーザー アカウントのメールアドレス。 |
Api Token |
必須。 Zendesk 管理者設定内で生成された一意の API トークン。 |
Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。
必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。
操作
アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。
チケットにコメントを追加する
既存のチケットにコメントを追加する。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| チケット ID | 文字列 | なし | チケット番号。 |
| コメントの本文 | 文字列 | なし | なし |
| 著者の名前 | 文字列 | なし | なし |
| 内部メモ | ブール値 | なし | なし |
ユースケース
なし
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON の結果
N/A
チケットにマクロを適用する
チケットにマクロを適用する。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| チケット ID | 文字列 | なし | チケット番号。 |
| マクロのタイトル | 文字列 | なし | なし |
ユースケース
なし
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_applied | True/False | is_applied:False |
JSON の結果
N/A
チケットを作成する
特定のプロパティを持つチケットを作成します。
既知の制限事項
Unicode 文字を含むメールは Zendesk API でサポートされていません。これは「メール CC」パラメータに影響します。アクションはそれらを無視します
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| 件名 | 文字列 | なし | なし |
| 説明 | 文字列 | なし | なし |
| 割り当てユーザー | 文字列 | なし | ユーザーの姓名。 |
| 割り当てグループ | 文字列 | なし | グループ名。 |
| 優先度 | 文字列 | なし | 優先度は、緊急、高、通常、低のいずれかになります。 |
| チケットのタイプ | 文字列 | なし | 優先度は、緊急、高、標準、低のいずれかになります。 |
| タグ | 文字列 | なし | なし |
| 内部メモ | チェックボックス | オフ | コメントを公開にするか、内部向けにするかを指定します。チェックボックスをオフにすると公開され、オンにすると内部のみに公開されます。 |
| メールの CC 宛先 | CSV | なし | チケット作成の通知も受信する必要があるメールアドレスのカンマ区切りのリストを指定します。注: 追加できるメールの CC は最大 48 件です。これは Zendesk の制限です。 |
| メールの CC を検証する | ブール値 | オン | 有効にすると、アクションは「メールの CC」パラメータで指定されたメールアドレスを持つユーザーが存在するかどうかを確認しようとします。存在しないユーザーが 1 人でもいる場合、アクションは失敗します。このパラメータが無効になっている場合、アクションはこのチェックを実行しません。 |
ユースケース
なし
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| ticket_id | なし | なし |
JSON の結果
N/A
Case Wall
| 結果のタイプ | 値 / 説明 | タイプ |
|---|---|---|
| 出力メッセージ * | 「メールの CC を検証」が有効で、1 つ以上のメールが見つからない（失敗）: アクション「{アクション名}」の実行中にエラーが発生しました。理由: 次のメールアドレスを持つユーザーが見つかりませんでした: {entity.identifier}。スペルを確認するか、「メールの CC を検証」パラメータを無効にしてください。 少なくとも 1 つの入力が有効な電子メール・アドレスでない場合 アクション「{action name}」の実行中にエラーが発生しました。理由: 次のメールアドレスを持つユーザーが見つかりませんでした: {entity.identifier}。スペルを確認するか、「メールの CC を検証」パラメータを無効にしてください。 |
一般 |
チケットの詳細を取得する
チケット ID でチケットの詳細、コメント、添付ファイルを取得します。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| チケット ID | 文字列 | なし | チケットの ID。 |
ユースケース
なし
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| ticket_details | なし | なし |
JSON の結果
{
"Details":
{
"ticket":
{
"follower_ids": [],
"via":
{
"source":
{"to": {},
"from": {},
"rel": "None"},
"channel": "web"
},
"updated_at": "2019-02-03T10:08:00Z",
"submitter_id": 360638872459,
"assignee_id": 360638872459,
"brand_id": 360000159559,
"id": 2,
"custom_fields": [],
"satisfaction_rating": "None",
"sharing_agreement_ids": [],
"allow_attachments": "True",
"collaborator_ids": [],
"priority": "high",
"subject": "Test",
"type": "incident",
"status": "open",
"description": "Test Test Test",
"tags": ["test"],
"forum_topic_id": "None",
"organization_id": 360018882419,
"due_at": "None",
"is_public": "True",
"requester_id": 360638872459,
"followup_ids": [],
"recipient": "None",
"problem_id": "None",
"url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
"created_at": "2019-02-03T10:08:00Z",
"raw_subject": "Test",
"email_cc_ids": [],
"allow_channelback": "False",
"has_incidents": "False",
"group_id": 360000361099,
"external_id": "None"
}
},
"Comments":
[{
"body": "Test Test Test",
"plain_body": "Test Test Test",
"via":
{
"source":
{"to": {},
"from": {},
"rel": "None"},
"channel": "web"
},
"attachments":
[{
"thumbnails": [],
"url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
"file_name": "Siemplify 10 2018-12-11 (1).lic",
"content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
"height": "None",
"width": "None",
"mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
"content_type": "application/unknown",
"inline": "False",
"id": 360701661660,
"size": 1272
}],
"audit_id": 393260420939,
"created_at": "2019-02-03T10:08:00Z",
"id": 393260420979,
"author_id": 360638872459,
"html_body": "<div> Test Test Test < br >< /div>",
"type": "Comment",
"public": "True",
"metadata":
{
"system":
{
"latitude": 32.066599999999994,
"client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
"ip_address": "1.1.1.1",
"location": "Tel Aviv, 05, Israel",
"longitude": 34.764999999999986
},
"custom": {}
}
}],
"Attachments": [{"test.txt": ""}]
}
Ping
接続をテストします。
パラメータ
なし
ユースケース
なし
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_connected | True/False | is_connected:False |
JSON の結果
N/A
チケットの検索
キーワードでチケットを検索します。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| 検索クエリ | 文字列 | なし | クエリの内容（例: type:ticket status:pending）。 |
ユースケース
なし
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| results_count | なし | なし |
JSON の結果
N/A
更新チケット
既存のチケットの詳細を更新する
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| チケット ID | 文字列 | なし | チケット番号。 |
| 件名 | 文字列 | なし | チケットの件名。 |
| 割り当てユーザー | 文字列 | なし | ユーザーの姓名。 |
| 割り当てグループ | 文字列 | なし | グループ名。 |
| 優先度 | 文字列 | なし | 優先度は、緊急、高、通常、低のいずれかになります。 |
| チケットのタイプ | 文字列 | なし | チケットの種類は、問題、インシデント、質問、タスクのいずれかになります。 |
| タグ | 文字列 | なし | チケットに追加するタグ。 |
| ステータス | 文字列 | なし | ステータスは、新規、オープン、保留中、待機中、解決済み、終了のいずれかになります。 |
| 追加のコメント | 文字列 | なし | チケットにコメントを追加する場合は、コメントとして追加するテキストをここで指定します。 |
| 内部メモ | チェックボックス | オフ | コメントを公開にするか、内部向けにするかを指定します。チェックボックスをオフにすると公開され、オンにすると内部のみに公開されます。 |
ユースケース
なし
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_updated | True/False | is_updated:False |
JSON の結果
N/A
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。