EasyVista
統合バージョン: 4.0
Google Security Operations で EasyVista の統合を構成する
Google SecOps で統合を構成する方法について詳しくは、統合を構成するをご覧ください。
統合のパラメータ
次のパラメータを使用して統合を構成します。
パラメータの表示名 | 種類 | デフォルト値 | 必須 | 説明 |
---|---|---|---|---|
インスタンス名 | 文字列 | なし | いいえ | 統合を構成するインスタンスの名前。 |
説明 | 文字列 | なし | いいえ | インスタンスの説明。 |
API ルート | 文字列 | https://try.easyvista.com/api/v1/ | はい | 接続先の EasyVista API ルート。 |
アカウント ID | 文字列 | なし | はい | EasyVista アカウント ID。 |
ユーザー名 | 文字列 | なし | はい | 接続に使用する EasyVista ユーザー名。 |
パスワード | パスワード | なし | はい | 接続に使用する EasyVista のパスワード。 |
SSL を確認する | チェックボックス | オン | いいえ | API ルート用に構成された証明書が有効かどうかを確認するために、証明書の検証を有効にするかどうかを指定します。 |
リモートで実行 | チェックボックス | オフ | いいえ | 構成した統合をリモートで実行するには、フィールドのチェックボックスをオンにします。オンにすると、リモート ユーザー(エージェント)を選択するオプションが表示されます。 |
アクション
Ping
説明
[Google Security Operations Marketplace] タブの統合構成ページで提供されるパラメータを使用して、EasyVista インスタンスへの接続をテストします。
実行
このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。
アクションの結果
スクリプトの結果
スクリプトの結果名 | 値のオプション | 例 |
---|---|---|
is_success | True/False | is_success:False |
JSON の結果
{
"HREF": "https://try.easyvista.com/api/v1/70047/requests?max_rows=1",
"record_count": "1",
"total_record_count": "13015",
"records": [
{
"HREF": "https://try.easyvista.com/api/v1/70047/requests/000002",
"COMMENT": {
"HREF": "https://try.easyvista.com/api/v1/70047/requests/000002/comment"
},
"MAX_RESOLUTION_DATE_UT": "2010-11-19T19:00:00.000-05:00",
"REQUEST_ID": "28452",
"RFC_NUMBER": "000002",
"SUBMIT_DATE_UT": "2011-11-17T19:00:00.000-05:00",
"CATALOG_REQUEST": {
"CODE": "",
"CATALOG_REQUEST_PATH": "Incidents/Applications/Functional Domain/Exodata",
"HREF": "https://try.easyvista.com/api/v1/70047/catalog-requests/4816",
"SD_CATALOG_ID": "4816",
"TITLE_EN": "Exodata"
},
"STATUS": {
"STATUS_EN": "Closed",
"STATUS_GUID": "{C3D9DFA7-7A21-46C2-B3A3-8BC50C9FF4F3}",
"HREF": "https://try.easyvista.com/api/v1/70047/status/8",
"STATUS_ID": "8"
},
"RECIPIENT": {
"BEGIN_OF_CONTRACT": "1986-03-19",
"CELLULAR_NUMBER": "790-933-579",
"DEPARTMENT_PATH": "Sales/Direct/Services",
"E_MAIL": "abuxtehude@evtry.com",
"EMPLOYEE_ID": "10334",
"LAST_NAME": "Buxtehude, Andrew",
"LOCATION_PATH": "Europe/France/Marseille/Bldg 1/Floor 02/244",
"PHONE_NUMBER": "+33155859446"
},
"REQUESTOR": {
"BEGIN_OF_CONTRACT": "1986-03-19",
"CELLULAR_NUMBER": "790-933-579",
"DEPARTMENT_PATH": "Sales/Direct/Services",
"E_MAIL": "abuxtehude@evtry.com",
"EMPLOYEE_ID": "10334",
"LAST_NAME": "Buxtehude, Andrew",
"LOCATION_PATH": "Europe/France/Marseille/Bldg 1/Floor 02/244",
"PHONE_NUMBER": "+33155859446"
},
"LOCATION": {
"CITY": "",
"LOCATION_CODE": "",
"LOCATION_EN": "244",
"LOCATION_PATH": "Europe/France/Marseille/Bldg 1/Floor 02/244",
"HREF": "https://try.easyvista.com/api/v1/70047/locations/1610",
"LOCATION_ID": "1610"
},
"DEPARTMENT": {
"DEPARTMENT_CODE": "",
"DEPARTMENT_EN": "Services",
"DEPARTMENT_PATH": "Sales/Direct/Services",
"HREF": "https://try.easyvista.com/api/v1/70047/departments/37",
"DEPARTMENT_ID": "37",
"DEPARTMENT_LABEL": ""
},
"KNOWNERROR": {
"KNOWNERROR_PATH": "",
"KNOWN_PROBLEMS_ID": "",
"KP_NUMBER": "",
"QUESTION_EN": ""
}
}
]
}
ケースウォール
結果のタイプ | 値 / 説明 | タイプ(エンティティ / 全般) |
---|---|---|
出力メッセージ * | アクションが失敗したり、Playbook の実行が停止したりすることはありません。 成功した場合: 「指定された接続パラメータを使用して EasyVista インスタンスに正常に接続されました。」と出力します。 アクションが失敗し、Playbook の実行が停止します。 不成功の場合: 「EasyVista インスタンスへの接続に失敗しました」と出力します。エラーは {0}」.format(exception.stacktrace) |
全般 |
EasyVista チケットを取得する
説明
特定の EasyVista チケットに関する情報を取得します。注: Google SecOps エンティティではアクションが機能しません。チケット識別子(rfc_number)を指定する必要があります。
パラメータ
パラメータの表示名 | 種類 | デフォルト値 | 必須 | 説明 |
---|---|---|---|---|
チケット ID | 文字列 | なし | はい | 情報を取得する EasyVista チケット識別子(例: S201001_000001)。 |
プレイブックのユースケースの例
Google SecOps で処理されたアラートに接続されている EasyVista チケットに関する情報を取得します。
実行
このアクションは URL エンティティに対して実行されます。
アクションの結果
スクリプトの結果
スクリプトの結果名 | 値のオプション | 例 |
---|---|---|
is_success | True/False | is_success:False |
JSON の結果
「General」レスポンス(https://try.easyvista.com/api/v1/70047/requests/I200716_000001) - チケットの説明、コメント、添付ファイル、アクションを取得するレスポンスの例を以下に示します。
{
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001",
"ANALYTICAL_CHARGE_PATH": "",
"ANALYTICAL_CHARGE_ID": "",
"ASSET_ID": "",
"AVAILABLE_FIELD_1": "",
"AVAILABLE_FIELD_2": "",
"AVAILABLE_FIELD_3": "",
"AVAILABLE_FIELD_4": "",
"AVAILABLE_FIELD_5": "",
"AVAILABLE_FIELD_6": "",
"BUDGET_EFFECTIVE": "",
"BUDGET_ID": "",
"BUDGET_PLANNED": "",
"CAN_BE_DUPLICATED": "0",
"CI_ID": "",
"CLICK_2_GET_INSTALL_RESULT": "",
"COMMENT": {
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001/comment"
},
"CONTINUITY_PLAN_ID": "",
"COST_CENTER_ID": "",
"CREATION_DATE_UT": "2020-07-16T04:00:24.000-04:00",
"DELAY": "3840",
"DEPARTMENT_PATH": "IT",
"DEPARTMENT_ID": "100",
"DESCRIPTION": {
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001/description"
},
"DYNAMIC_DETAILS": {
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001/dynamic_details"
},
"E_COST": "100.00",
"E_DELAY": "",
"E_SENTIMENT_ANALYSIS": "",
"EFFECTIVE_CHANGE_DATE_END": "",
"EFFECTIVE_CHANGE_DATE_START": "",
"END_DATE_UT": "2020-07-28T23:13:54.000-04:00",
"ESTIMATED_NET_PRICE": "",
"ESTIMATED_PERCENT_COMPLETE": "",
"EXPECTED_DATE_UT": "",
"EXPECTED_DURATION": "",
"EXPECTED_END_DATE_UT": "",
"EXPECTED_START_DATE_UT": "",
"EXTERNAL_REFERENCE": "",
"FIRST_CALL_RESOLUTION": "0",
"HOUR_PER_DAY": "",
"IMPACT_ID": "3",
"IMPUTATION_DATE": "",
"INITIAL_SD_CATALOG_PATH": "",
"INITIAL_SD_CATALOG_ID": "",
"IS_FINANCIAL_COMPTED": "0",
"IS_MAJOR_INCIDENT": "",
"IS_TEMPLATE": "0",
"KBASE_ID": "",
"KNOWN_PROBLEMS_PATH": "",
"KNOWN_PROBLEMS_ID": "",
"LAST_DONE_BY_ID": "18376",
"LAST_GROUP_ID": "12",
"LAST_UPDATE": "2020-07-28T23:14:40.697-04:00",
"LOCATION_PATH": "North America/USA/New York",
"LOCATION_ID": "9762",
"MARK_1": "",
"MARK_2": "",
"MAX_RESOLUTION_DATE_UT": "2020-07-16T17:00:00.000-04:00",
"MS_PROJECT_IMPORT_VALIDATION_WAITING": "0",
"NET_PRICE": "",
"NET_PRICE_CUR_ID": "",
"NEWS_ID": "",
"NOT_DEDUCED_CALL": "",
"ORDER_ID": "",
"ORDER_NET_PRICE": "",
"ORIGIN_TOOL_ID": "1",
"OWNER_ID": "",
"OWNING_GROUP_ID": "",
"PARENT_REQUEST_ID": "",
"PLANNED_CHANGE_DATE_END": "",
"PLANNED_CHANGE_DATE_START": "",
"PM_STATUS_ID": "",
"PROJECT_ID": "",
"PROJECT_NAME": "",
"PROJECT_START_DATE_UT": "",
"QTY": "",
"RECIPIENT_ID": "18376",
"RELEASE_ID": "",
"RENTAL_NET_PRICE": "",
"RENTAL_NET_PRICE_CUR_ID": "",
"REQUALIFICATION_PROCESSING": "0",
"REQUEST_ID": "42837",
"REQUEST_ORIGIN_ID": "3",
"REQUEST_PROJECT_ID": "",
"REQUESTED_CHANGE_DATE_END": "",
"REQUESTED_CHANGE_DATE_START": "",
"REQUESTOR_FEEDBACK": "",
"REQUESTOR_ID": "18376",
"REQUESTOR_IP_ADDRESS": "",
"REQUESTOR_PHONE": "+41798248341",
"REQUIRED_DOWNTIME": "",
"RFC_NUMBER": "I200716_000001",
"RISK_AMOUNT": "",
"RISK_DESCRIPTION": {
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001/risk_description"
},
"RISK_LEVEL_ID": "",
"ROOT_CAUSE_ID": "69",
"SD_CATALOG_PATH": "Incidents/Equipment/Router",
"SD_CATALOG_ID": "4606",
"SEVERITY_ID": "40",
"SLA_ID": "1",
"STATUS_ID": "2",
"SUBMIT_DATE_UT": "2020-07-16T04:00:24.000-04:00",
"SUBMITTED_BY": "18376",
"SYSTEM_AFFECTED": {
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001/system_affected"
},
"SYSTEM_ID": "",
"TIME_USED_TO_DELIVER_FEEDBACK": "",
"TIME_USED_TO_SOLVE_REQUEST": "4320",
"TITLE": "",
"URGENCY_ID": "1",
"VALIDATION_LEVEL_REQUIRED": "",
"WAVE_ID_TARGET": "",
"CATALOG_REQUEST": {
"CODE": "46",
"CATALOG_REQUEST_PATH": "Incidents/Equipment/Router",
"HREF": "https://try.easyvista.com/api/v1/70047/catalog-requests/4606",
"SD_CATALOG_ID": "4606",
"TITLE_EN": "Router"
},
"STATUS": {
"STATUS_EN": "Solved",
"STATUS_GUID": "{DC97DD1D-0F35-4153-B0E1-0F2E0155365D}",
"HREF": "https://try.easyvista.com/api/v1/70047/status/2",
"STATUS_ID": "2"
},
"RECIPIENT": {
"BEGIN_OF_CONTRACT": "",
"CELLULAR_NUMBER": "+36666667776",
"DEPARTMENT_PATH": "IT",
"E_MAIL": "admin@evtry.com",
"EMPLOYEE_ID": "18376",
"LAST_NAME": "William",
"LOCATION_PATH": "North America/USA/New York",
"PHONE_NUMBER": "+41798248341"
},
"REQUESTOR": {
"BEGIN_OF_CONTRACT": "",
"CELLULAR_NUMBER": "+36666667776",
"DEPARTMENT_PATH": "IT",
"E_MAIL": "admin@evtry.com",
"EMPLOYEE_ID": "18376",
"LAST_NAME": "William",
"LOCATION_PATH": "North America/USA/New York",
"PHONE_NUMBER": "+41798248341"
},
"LOCATION": {
"CITY": "",
"LOCATION_CODE": "",
"LOCATION_EN": "New York",
"LOCATION_PATH": "North America/USA/New York",
"HREF": "https://try.easyvista.com/api/v1/70047/locations/9762",
"LOCATION_ID": "9762"
},
"DEPARTMENT": {
"DEPARTMENT_CODE": "",
"DEPARTMENT_EN": "IT",
"DEPARTMENT_PATH": "IT",
"HREF": "https://try.easyvista.com/api/v1/70047/departments/100",
"DEPARTMENT_ID": "100",
"DEPARTMENT_LABEL": ""
},
"KNOWNERROR": {
"KNOWNERROR_PATH": "",
"KNOWN_PROBLEMS_ID": "",
"KP_NUMBER": "",
"QUESTION_EN": ""
}
}
説明:
{
"COMMENT": "Here, your description",
"PARENT_HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001",
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001/comment"
}
コメント:
{
"DESCRIPTION": "REST API Update - This is a test comment 3, is it replacing old one?\r\nthis is solved",
"PARENT_HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001",
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001/description"
}
添付ファイル:
{
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001/documents",
"PARENT_HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001",
"Documents": [
{
"HREF": "https://try.easyvista.com/autoconnect_mail.php?field1=5C0F051E5B0F056B1E31&field2=&field3=&docpath=70047/Documents/40000_ff73bce22220ac5b8ce10cefd876a5c8a2b09fec&docname=testfile.txt",
"PARENT_HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001",
"DOCUMENT_ID": "40000_ff73bce22220ac5b8ce10cefd876a5c8a2b09fec&docname=testfile.txt",
"DDL_HREF": "https://try.easyvista.com/api/v1/70047/documents/40000_ff73bce22220ac5b8ce10cefd876a5c8a2b09fec&docname=testfile.txt"
},
{
"HREF": "https://try.easyvista.com/autoconnect_mail.php?field1=5C0F051E5B0F056B1E3C&field2=&field3=&docpath=70047/Documents/40000_284466a573e227bb632d977f3c4a399016d94fe6&docname=testfile2.txt",
"PARENT_HREF": "https://try.easyvista.com/api/v1/70047/requests/I200716_000001",
"DOCUMENT_ID": "40000_284466a573e227bb632d977f3c4a399016d94fe6&docname=testfile2.txt",
"DDL_HREF": "https://try.easyvista.com/api/v1/70047/documents/40000_284466a573e227bb632d977f3c4a399016d94fe6&docname=testfile2.txt"
}
]
}
アクション:
{
"HREF": "https://try.easyvista.com/api/v1/70047/actions?search=REQUEST.RFC_NUMBER:I200904_000001",
"record_count": "6",
"total_record_count": "6",
"records": [
{
"HREF": "https://try.easyvista.com/api/v1/70047/actions/79439",
"ACTION_ID": "79439",
"ACTION_LABEL_EN": "Analysis & Resolution",
"ACTION_NUMBER": "0",
"DONE_BY_ID": "",
"EXPECTED_START_DATE_UT": "",
"LOCATION": {
"CITY": "",
"LOCATION_CODE": "",
"LOCATION_EN": "-",
"LOCATION_PATH": "",
"HREF": "https://try.easyvista.com/api/v1/70047/locations/6",
"LOCATION_ID": "6"
},
"DONE_BY": {
"BEGIN_OF_CONTRACT": "",
"CELLULAR_NUMBER": "",
"DEPARTMENT_PATH": "",
"E_MAIL": "",
"EMPLOYEE_ID": "",
"LAST_NAME": "",
"LOCATION_PATH": "",
"PHONE_NUMBER": ""
},
"REQUEST": {
"MAX_RESOLUTION_DATE_UT": "2020-09-04T17:00:00.000-04:00",
"REQUEST_ID": "42845",
"HREF": "https://try.easyvista.com/api/v1/70047/requests/I200904_000001",
"RFC_NUMBER": "I200904_000001",
"SUBMIT_DATE_UT": "2020-09-04T03:07:26.000-04:00"
}
}]
}
ケースウォール
結果のタイプ | 値 / 説明 | タイプ(エンティティ / 全般) |
---|---|---|
出力メッセージ * | アクションが失敗したり、Playbook の実行が停止したりすることはありません。 成功した場合: 「チケット {0} の EasyVista 情報を正常に返しました」と出力します。format(ticket_id) is_success=False の場合(たとえば、、間違ったチケット ID が指定され、結果を取得できなかった): 「チケット {0} の EasyVista 情報を取得できませんでした。エラーは {1} です。」.format(ticket_id,exception.stacktrace) アクションが失敗し、Playbook の実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合: 「アクションの実行に失敗しました。エラーは {0}」.format(exception.stacktrace) |
一般 |
テーブル | テーブル名: "EasyVista チケット {0} 情報:".format(ticket_id) テーブル列: パラメータ、値
|
全般 |
チケットにコメントを追加する
説明
EasyVista チケットにコメントを追加します。注: Google SecOps エンティティではアクションが機能しません。アクション入力パラメータを指定する必要があります。
パラメータ
パラメータの表示名 | 種類 | デフォルト値 | 必須 | 説明 |
---|---|---|---|---|
チケット ID | 文字列 | なし | はい | 情報を取得する EasyVista チケットの識別子。 |
コメント | 文字列 | なし | はい | EasyVista チケットに追加するコメント。 |
プレイブックのユースケースの例
調査の一環として、EasyVista チケットにコメントを追加します。
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
スクリプトの結果名 | 値のオプション | 例 |
---|---|---|
is_success | True/False | is_success:False |
ケースウォール
結果のタイプ | 値 / 説明 | タイプ(エンティティ / 全般) |
---|---|---|
出力メッセージ * | アクションが失敗したり、Playbook の実行が停止したりすることはありません。 成功した場合: 「EasyVista チケット {0} にコメントが正常に追加されました」.format(ticket_id) を出力します。 is_success=False の場合(たとえば、、間違ったチケット ID が指定され、結果を取得できなかった): 「EasyVista チケット {0} にコメントを追加できませんでした。エラーは {1} です。」.format(ticket_id,exception.stacktrace) アクションが失敗し、Playbook の実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合: 「アクションの実行に失敗しました!エラーは {0}」.format(exception.stacktrace) |
全般 |
チケットの更新を待つ
説明
アクションは、ハンドブックの実行を一時停止し、タイムアウトするまで EasyVista に定期的に接続して、指定されたチケットが更新されたかどうかを確認します。アクションは特定のフィールドの更新をモニタリングすることもできます。そのフィールドが更新されると、アクションが完了し、更新されたチケット情報が取得されます。
パラメータ
パラメータの表示名 | 種類 | デフォルト値 | 必須 | 説明 |
---|---|---|---|---|
チケット ID | 文字列 | なし | はい | 情報を取得する EasyVista チケットの識別子。 |
モニタリングするフィールド | DDL | 有効な値: ステータス コメント 添付ファイル 操作 |
いいえ | 更新をモニタリングする EasyVista チケット フィールド。 |
プレイブックのユースケースの例
Google SecOps ハンドブックで、一部のプロセスが完了して Easyvista に記録されるまで待ちます。
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
スクリプトの結果名 | 値のオプション | 例 |
---|---|---|
is_success | True/False | is_success:False |
ケースウォール
結果のタイプ | 値 / 説明 | タイプ(エンティティ / 全般) |
---|---|---|
出力メッセージ * | アクションが失敗したり、Playbook の実行が停止したりすることはありません。 成功した場合: 「チケット {0} の更新を取得しました」と出力します。format(ticket_id)。 is_success=False の場合(たとえば、、間違ったチケット ID が指定され、結果を取得できなかった): 「チケット {0} の更新を取得できませんでした。エラーは {1} です。」.format(ticket_id,exception.stacktrace) アクションが失敗し、Playbook の実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合: 「アクションの実行に失敗しました!エラーは {0}」.format(exception.stacktrace) |
一般 |
テーブル | テーブル名: "EasyVista チケット {0} 情報:".format(ticket_id)
|
全般 |
EasyVista チケットをクローズする
説明
指定されたパラメータに基づいて EasyVista チケットをクローズします。注: Google SecOps エンティティではアクションが機能しません。チケット識別子(rfc_number)を指定する必要があります。
パラメータ
パラメータの表示名 | 種類 | デフォルト値 | 必須 | 説明 |
---|---|---|---|---|
チケット ID | 文字列 | なし | はい | EasyVista チケット ID(例: S201001_000001)。 |
コメント | 文字列 | なし | いいえ | チケットのクローズについて説明するコメント。 |
Actions Close Date(アクションの終了日) | 文字列 | なし | いいえ | チケットに関連付けられた未解決のアクションの終了日と、想定される終了アクション。 日付は MM/DD/YYYY HH:MM:SS の形式で指定します。 間違った形式が指定された場合、アクションでは現在の日付 / 時刻が終了日として使用されます。 |
進行中のアクションを削除しますか? | チェックボックス | オフ | いいえ | チケットのクローズ時にチケットの進行中のアクションを削除するかどうかを指定します。 |
プレイブックのユースケースの例
処理されたアラートに接続されている EasyVista チケットをクローズします。
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
スクリプトの結果名 | 値のオプション | 例 |
---|---|---|
is_success | True/False | is_success:False |
ケースウォール
結果のタイプ | 値 / 説明 | タイプ(エンティティ / 全般) |
---|---|---|
出力メッセージ * | アクションが失敗したり、Playbook の実行が停止したりすることはありません。 成功した場合(サーバーがステータス 201 を返した、is_success=true): 「EasyVista チケット {0} をクローズしました」と出力します。format(EasyVista_ticket) 成功したが、間違った日付が指定された場合(サーバーがステータス 201 を返した、is_success=true): 「日付形式が正しくありません。EasyVista チケット {0} は現在の日付と時刻でクローズされました。」と出力します。format(EasyVista_ticket) is_success=False の場合(たとえば、間違ったチケット ID が指定された、サーバーがエラーを返した): 「EasyVista チケット {0} を閉じることができませんでした。エラーは {1} です。」format(EasyVista_ticket,exception.stacktrace) アクションが失敗し、Playbook の実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合: 「アクションの実行に失敗しました!エラーは {0}」.format(exception.stacktrace) |
全般 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。