ServiceDesk Plus
統合バージョン: 5.0
Google Security Operations と連携するように ServiceDesk Plus を構成する
- API キーを生成するには、[User block] で [Admin] > [Technicians] に移動します。
- 既存の技術者の API キーを生成するには、技術者の横にある編集アイコンをクリックします。一方、新しい技術者の API キーを生成する場合は、[Add New Technician] リンクをクリックして、技術者の詳細を入力し、ログイン権限を付与します。
- [API キーの詳細ブロック] で [リンクを生成] をクリックします。カレンダー アイコンを使用してキーの有効期限を選択するか、同じキーを永続的に保持できます。
- テクニシャン用にキーがすでに生成されている場合は、[再生成] リンクが表示されます。
Google SecOps で ServiceDesk Plus の統合を構成する
Google SecOps で統合を構成する方法について詳しくは、統合を構成するをご覧ください。
統合のパラメータ
次のパラメータを使用して統合を構成します。
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| API ルート | 文字列 | http://{IP OR FQDN}:8080/api/v3/ | ServiceDesk Plus の API ルート。 |
操作
メモを追加
説明
特定のリクエストに技術情報などの追加情報を追加したい場合は、メモの追加を使用します。メモを使用してリクエストのステータスを更新することもできます。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| リクエスト ID | 文字列 | なし | リクエストの ID。 |
| 注 | 文字列 | なし | メモの内容。 |
| 公開 | チェックボックス | オフ | メモを公開するかどうか。 |
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| success | True/False | success:False |
JSON の結果
N/A
メモを追加して返信を待つ
説明
メモを追加し、指定されたリクエストに新しいメモが追加されるまで待ちます。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| リクエスト ID | 文字列 | なし | リクエストの ID。 |
| 注 | 文字列 | なし | メモの内容。 |
| 公開 | チェックボックス | なし | メモを公開するかどうか。 |
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| new_notes | なし | なし |
JSON の結果
N/A
リクエストを閉じる
説明
リクエストが処理され、報告された問題が解決されたことにリクエスト送信者が完全に満足している場合は、リクエストをクローズできます。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| リクエスト ID | 文字列 | なし | リクエストの ID。 |
| コメント | 文字列 | なし | 締めくくりのコメント。 |
| 解決策の確認 | チェックボックス | なし | リクエストの解決が承認されたかどうか。 |
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| success | True/False | success:False |
JSON の結果
N/A
アラート リクエストを作成する
説明
Google SecOps アラートに関連するリクエストを作成します。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| 件名 | 文字列 | なし | リクエストの件名。 |
| リクエスト元 | 文字列 | なし | リクエストの送信者。指定しない場合、API キーのユーザーに設定されます。 |
| ステータス | 文字列 | なし | リクエストのステータス。 |
| 技術者 | 文字列 | なし | リクエストに割り当てられた技術者の名前。 |
| 優先度 | 文字列 | なし | リクエストの優先度。 |
| 緊急度 | 文字列 | なし | リクエストの緊急度。 |
| カテゴリ | 文字列 | なし | リクエストのカテゴリ。 |
| リクエスト テンプレート | 文字列 | なし | リクエストのテンプレート。 |
| リクエストの種類 | 文字列 | なし | リクエストのタイプ。例: インシデント、サービス リクエスト |
| 期限時刻（ミリ秒） | 文字列 | なし | リクエストの期日（ミリ秒単位）。 |
| モード | 文字列 | なし | リクエストのモード。 |
| レベル | 文字列 | なし | リクエストのレベル。 |
| サイト | 文字列 | なし | リクエストのサイト。 |
| グループ | 文字列 | なし | リクエストのグループ。 |
| 影響 | 文字列 | なし | リクエストの影響。 |
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| success | True/False | success:False |
JSON の結果
N/A
リクエストを作成
説明
システムで障害や問題が発生した場合は、問題を報告します。つまり、IT ヘルプデスク チームにリクエストを送信します。リクエストの送信方法には、ウェブベースのフォームの使用、メール通知の送信、電話での問い合わせなどがあります。ServiceDesk Plus には、上記のいずれかのフォームから送信されたリクエストの詳細を記録するオプションが用意されています。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| 件名 | 文字列 | なし | リクエストの件名。 |
| リクエスト元 | 文字列 | なし | リクエストの送信者。指定しない場合、API キーのユーザーに設定されます。 |
| 説明 | 文字列 | なし | リクエストの説明。 |
| ステータス | 文字列 | なし | リクエストのステータス。 |
| 技術者 | 文字列 | なし | リクエストに割り当てられた技術者の名前。 |
| 優先度 | 文字列 | なし | リクエストの優先度。 |
| 緊急度 | 文字列 | なし | リクエストの緊急度。 |
| カテゴリ | 文字列 | なし | リクエストのカテゴリ。 |
| リクエスト テンプレート | 文字列 | なし | リクエストのテンプレート。 |
| リクエストの種類 | 文字列 | なし | リクエストのタイプ。例: インシデント、サービス リクエスト |
| 期限時刻（ミリ秒） | 文字列 | なし | リクエストの期日（ミリ秒単位）。 |
| モード | 文字列 | なし | リクエストのモード。 |
| レベル | 文字列 | なし | リクエストのレベル。 |
| サイト | 文字列 | なし | リクエストのサイト。 |
| グループ | 文字列 | なし | リクエストのグループ。 |
| 影響 | 文字列 | なし | リクエストの影響。 |
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| request_id | なし | なし |
JSON の結果
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
リクエストの取得
説明
リクエストに関する情報を取得します。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| リクエスト ID | 文字列 | なし | リクエストの ID。 |
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| success | True/False | success:False |
JSON の結果
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
Ping
説明
ServiceDesk Plus インスタンスへの接続をテストします。
パラメータ
なし
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON の結果
N/A
リクエストの更新
説明
リクエストを更新します。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| リクエスト ID | 文字列 | なし | 更新するリクエストの ID。 |
| リクエスト元 | 文字列 | なし | リクエストの送信者。指定しない場合、API キーのユーザーに設定されます。 |
| 説明 | 文字列 | なし | リクエストの説明。 |
| ステータス | 文字列 | なし | リクエストのステータス。 |
| 技術者 | 文字列 | なし | リクエストに割り当てられた技術者の名前。 |
| 優先度 | 文字列 | なし | リクエストの優先度。 |
| 緊急度 | 文字列 | なし | リクエストの緊急度。 |
| カテゴリ | 文字列 | なし | リクエストのカテゴリ。 |
| リクエスト テンプレート | 文字列 | なし | リクエストのテンプレート。 |
| リクエストの種類 | 文字列 | なし | リクエストのタイプ。例: インシデント、サービス リクエスト |
| 期限時刻（ミリ秒） | 文字列 | なし | リクエストの期日（ミリ秒単位）。 |
| モード | 文字列 | なし | リクエストのモード。 |
| レベル | 文字列 | なし | リクエストのレベル。 |
| サイト | 文字列 | なし | リクエストのサイト。 |
| グループ | 文字列 | なし | リクエストのグループ。 |
| 影響 | 文字列 | なし | リクエストの影響。 |
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| success | True/False | success:False |
JSON の結果
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
フィールドの更新を待機
説明
リクエスト フィールドが目的の値に変更されるまで待ちます。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| リクエスト ID | 文字列 | なし | リクエストの ID。 |
| フィールド名 | 文字列 | なし | 更新するフィールドの名前。 |
| 値 | 文字列 | なし | 指定されたフィールドの目的の値。 |
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| new_value | なし | なし |
JSON の結果
N/A
ステータスの更新を待機する
説明
リクエストのステータスが目的のステータスに更新されるまで待ちます。
パラメータ
| パラメータ | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
| リクエスト ID | 文字列 | なし | リクエストの ID。 |
| 状態 | 文字列 | なし | リクエストのステータス（カンマ区切り）。 |
実行
このアクションはすべてのエンティティに対して実行されます。
アクションの結果
エンティティ拡充
なし
分析情報
なし
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| new_status | なし | なし |
JSON の結果
N/A
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。