このドキュメントでは、BMC Helix v2.1.0 の設定方法について説明します。Netskope Cloud Exchangeの Ticket Orchestrator モジュールを備えたプラグイン。 このプラグインは、BMC Helix ITSM プラットフォームでインシデントを作成するために使用します。 また、BMC Helixのインシデントステータスと影響度を同期することもサポートしています。
前提条件
この設定を完了するには、以下が必要です。
- Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
- Netskope Cloud Exchangeテナントには、テナントプラグインとチケットオーケストレータープラグインが既に設定済みです。
- ライセンス タイプが固定のBWAN プラットフォームへの接続。
- 次のホストへの接続: https:// <instance> .onbmc.com。
BMC Helixプラグインのサポート
このプラグインは、BMC Helix ITSM プラットフォームでインシデントを作成するために使用します。 また、BMC Helixのインシデントステータスと影響度を同期することもサポートしています。
| データ型 | サポート |
|---|---|
| インシデントでサポートされているアラートの種類 | 侵害されたクレデンシャル、ポリシー、マルサイト、マルウェア、DLP、セキュリティ評価、ウォッチリスト、検疫、修復、UBA、CTEP、デバイス、コンテンツ |
| インシデントでサポートされているイベントタイプ | エンドポイント、インシデント |
| Cloud Exchangeプラグインでサポートされているアラートの種類 | 情報、警告、エラー |
マッピング
以下は、プラグイン設定に追加されたデフォルトのマッピングです。Cloud Exchange のマッピングは、BMC プラットフォームで利用可能なマッピングに基づいて調整できます。
ステータスマッピング
| Cloud Exchangeフィールド | BMC Helixのインシデント状況 |
|---|---|
| 新しい | 新しい |
| 進行中 | 進行中 |
| Closed | Closed |
重症度マッピング
| Cloud Exchangeフィールド | BMC Helixのインシデント状況 |
|---|---|
| 致命的 | 1-Extensive/Widespread |
| 高い | 2-Significant/Large |
| 中くらい | 3-Moderate/Limited |
| 低い | 4-Minor/Localized |
以下は、キュー構成で使用可能なデフォルトのマッピングです。
注記
デフォルトのマッピングフィールドは必須項目であり、インシデントを作成するためには正しくマッピングされている必要があります。
| 対象分野 | Values |
|---|---|
| デスクリプション | カスタムメッセージ: Netskope CE によって作成されたインシデント。 |
| ショートデスクリプション | カスタムメッセージ: Netskope $appCategory アラート名: $alertName、イベント名: $alert_name |
| Detailed_Description | カスタムメッセージ: アラート/イベントID: $id アラート/イベントアプリ: $app アラート/イベントユーザー: $user アラート名: $alertName アラートタイプ: $alertType アラートアプリカテゴリ: $appCategory イベント名: $alert_name イベントタイプ: $eventType |
| First_Name | Custom Message: <add value> or select a field from the dropdown to map the value |
| Last_Name | Custom Message: <add value> or select a field from the dropdown to map the value |
| 状態 | Custom Message: <add value> or select a field from the dropdown to map the value |
| Impact | Custom Message: <add value> or select a field from the dropdown to map the value |
| Urgency | Custom Message: <add value> or select a field from the dropdown to map the value |
| 報告された情報源 | Custom Message: <add value> or select a field from the dropdown to map the value |
| Service_Type | Custom Message: <add value> or select a field from the dropdown to map the value |
権限
必要なアプリケーション権限:
- アセットビューア
- インシデントマスター
APIの詳細
使うAPI一覧
| APIエンドポイント | 方法 | 使うケース |
|---|---|---|
| /api/jwt/login | 役職 | Generate Auth Token |
| /api/arsys/v1/entry/HPD :インシデントインターフェース作成 | 役職 | インシデントを作成する |
| /api/arsys/v1/entry/HPD :インシデントインターフェース作成 | 得る | インシデントの詳細を取得する |
| /api/arsys/v1 .0/fields/HPD:IncidentInterface_Create | 得る | インシデントに使用可能なフィールドを取得する |
| /api/arsys/v1/entry/CTM :サポートグループ | 得る | 利用可能なグループをキューとして取得します |
認証トークンを生成する
Endpoint: <API Base URL>/api/jwt/login
Method: POST
Headers
| 鍵 | Value |
|---|---|
| ユーザーエージェント | netskope-ce-6.0.0-cto-bmc-helix-itsm-v2.1.0 |
| Content-Type | application/x-www-form-urlencoded |
Request Body
{ "username": , "password": , }
Sample Response
eyJ0eXAiOiJKV1QiLA0KICJhbGciOiJIUzI1.*********************UiLA0KICJleHAiOjEzMDA4MTkzODAsDQogImh0dHA6Ly9leGFtcGxlLmNvbS9pc19yb290Ijp0cnVlfQ.dBjftJeZ4CVP-mB9
インシデントを作成する
Endpoint: <API Base URL>/api/arsys/v1/entry/HPD:IncidentInterface_Create
Method: POST
Headers
| 鍵 | Value |
|---|---|
| ユーザーエージェント | netskope-ce-6.0.0-cto-bmc-helix-itsm-v2.1.0 |
| Authorization | AR-JWT <Access_Token> |
| Content-Type | アプリケーション/json |
Parameters
| 鍵 | Value |
|---|---|
| フィールド | 値（リクエストID、インシデント番号、ステータス、影響度、緊急度、サービスタイプ、報告元、割り当てグループ、担当者） |
Request Body
{ "values": { "z1D_Action": "CREATE", "Description": "Incident created by Netskope CE.", "Short Description": "Netskope $appCategory alert name: $alertName, Event Name: $alert_name", "Detailed_Decription": "Alert/Event ID: $id
Alert/Event App: $app
Alert/Event User: $user
Alert Name: $alertName
Alert Type: $alertType
Alert App Category: $appCategory
Event Name: $alert_name
Event Type: $eventType", "First_Name": "Test", "Last_Name": "User", "Status": "New", "Impact": "4-Minor/Localized", "Urgency": "4-Low", "Reported Source": "Web", "Service_Type": "Infrastructure Event", "Assigned Group": "", "Assigned Support Company": "", "Assigned Support Organization": "" } }
インシデントの詳細を取得する
Endpoint: <API Base URL>/api/arsys/v1/entry/HPD:IncidentInterface_Create
Method: GET
Headers
| 鍵 | Value |
|---|---|
| ユーザーエージェント | netskope-ce-6.0.0-cto-bmc-helix-itsm-v2.1.0 |
| Authorization | AR-JWT <Access_Token> |
| Content-Type | アプリケーション/json |
インシデントで使用可能なフィールドを取得する
Endpoint: <API Base URL>/api/arsys/v1.0/fields/HPD:IncidentInterface_Create
Method: GET
Headers
| 鍵 | Value |
|---|---|
| ユーザーエージェント | netskope-ce-6.0.0-cto-bmc-helix-itsm-v2.1.0 |
| Authorization | AR-JWT <Access_Token> |
| Content-Type | application/x-www-form-urlencoded |
利用可能なグループをキューとして取得する
Endpoint: <API Base URL>/api/arsys/v1/entry/CTM:Support Group
Method: GET
Headers
| 鍵 | Value |
|---|---|
| ユーザーエージェント | netskope-ce-6.0.0-cto-bmc-helix-itsm-v2.1.0 |
| Authorization | AR-JWT <Access_Token> |
| Content-Type | application/x-www-form-urlencoded |
ユーザーエージェント
netskope-ce-6.0.0-cto-bmc-helix-itsm-v2.1.0
ワークフロー
- BMC Helixユーザーに権限を付与する。
- BMC Helixプラグインを設定します。
- ビジネスルールを追加します。
- Add a Queue.
- プラグインを検証してください。
BMC Helixユーザーに権限を付与する
- BMC Helixで、ユーザーのプロファイルに移動します。
- Login/Access Detailsをクリックしてから、 Application Permissionをクリックしてください。
- 必要な権限を追加します。
- アセットビューア
- インシデントマスター
- Update Permission Groupsをクリックしてください。
BMC Helixプラグインの設定
- Cloud Exchange で、 Settings > Pluginsに移動します。BMC Helix ITSM v2.1.0 (CTO)プラグインボックスを検索して選択します。
- 基本情報を入力してください：
- Configuration Name: 設定の一意の名前。 Sync Interval :デフォルトのままにします。 Use System Proxy :通信にプロキシが必要な場合は有効にしてください。
- Nextをクリックして認証パラメータを入力してください。
- BMC Helix API Base URL: クラウドまたはオンプレミス環境に基づいたBMC Helix APIのURL。
例: http(s):// <instance-name> .com Username: BMC Helixアカウントに関連付けられているユーザー名。 Password:BMC Helixアカウントに関連付けられているパスワード。
- BMC Helix API Base URL: クラウドまたはオンプレミス環境に基づいたBMC Helix APIのURL。
- Nextをクリックして、ステータスと重要度のマッピングを指定してください。デフォルトではマッピングが追加されますが、必要に応じてBMCマッピングを使用して変更できます。
- Saveをクリックしてください。
BMC Helix 用の Ticket Orchestrator ビジネスルールを追加する
BMC Helix プラットフォームでチケットを生成するには、チケットの生成に使用するアラート/イベントをフィルターするビジネス ルールが必要です。
- Ticket OrchestratorでBusiness Rulesに移動し、 Create New Ruleをクリックします。
- ルールに、要件に応じてフィルターを追加してください。
- Save .
をクリックしてください
BMC Helix 用のチケットオーケストレーターキューを追加する
チケットを生成するには、キュー構成を追加する必要があります。
- Ticket Orchestratorで、 Queuesに移動してAdd Queue Configurationをクリックします。
- ビジネスルール、プラグイン構成（チケットを作成／生成する対象）、キュー、およびターゲットSelect 。 完了したら、 Saveをクリックしてください。
注記
- 各アクションの実行を手動で承認したい場合は、「承認が必要」のトグルを有効にしたままにしてください。
- キューにターゲットフィールドとして追加されたすべてのフィールドは、BMC Helixでインシデントを作成するために必須です。その他のマッピングされた値/形式はサポートされておらず、インシデント作成時にエラーが発生します。
以下は、BMC Helix 上でインシデント作成を確認するためのフィールド一覧です。 プラットフォームに他のフィールドが追加された場合、この数値は変化する可能性があります。
|
Fields |
Allowed Values |
|---|---|
|
状態 |
新しい Assigned 進行中 Pending Closed Cancelled |
|
Impact |
1-Extensive/Widespread 2-Significant/Large 3-Moderate/Limited 4-Minor/Localized |
|
Urgency |
1-Critical 2-High 3-Medium 4-Low |
|
Service_Type |
ユーザーサービス復旧 ユーザーサービスリクエスト インフラ復旧 インフラストラクチャ関連イベント（お客様からの提案） セキュリティインシデント |
|
報告された情報源 |
電子メール Chat ウェブ（お客様からの提案） BMCインパクトマネージャーイベント 外部エスカレーション ウォークイン Phone 直接入力 その他 システム管理 セルフサービス Fax ボイスメール |
BMC Helixプラグインを検証する
Cloud Exchangeで検証する
BMC 上で作成されたインシデントを確認するには、 Loggingに移動してプラグイン名に基づいてログを検索し、プラグインのログを確認してください。
Example: message Like “CTO BMC Helix”
作成されたインシデントを確認するには、 Ticketsに移動して作成されたインシデントを確認してください。
BMC Helixで検証する
インシデントの作成を検証するには、 Ticketsに移動してチケットの外部リンクをクリックしてください。
必ずBMC Helixプラットフォームにログインしてください。 そこからBMC Helixプラットフォームに移動します
BMC Helixプラグインのトラブルシューティング
インシデント作成時にエラーを受信
BMCでインシデントを作成する際にエラーが発生する場合、以下のいずれかの理由が考えられます。
- キューに追加されたマッピングが無効または空です。
- サービスタイプの値は「セキュリティインシデント」としてマッピングされていますが、キューにはグループが選択されていません。
What to do:
- マッピングがBMCが想定する値と異なる方法で追加された場合、プラグインはサーバーエラーまたは無効な値エラーをスローします。BMCは、マッピングが特定の形式であることを期待しており、フィールドの値はプラットフォーム上に存在している必要があります。キューに追加されたマッピングと、BMC プラットフォームで利用可能なマッピングを確認してください。 キュー構成に含まれるすべてのフィールドはマッピングする必要があります。なぜなら、それらはBMC上で必須だからです。
- BMC Helixは、サービスタイプが「セキュリティインシデント」の場合、グループが存在することを想定しています。そのため、キューに「グループなし」オプションが追加されており、サービスタイプが「セキュリティインシデント」の場合、インシデントは作成されず、ログにエラーが表示されます。
既知の動作
ステータスが「解決済み」にマッピングされている場合、インシデントを作成することが許可されていないことに気付きました。作成しようとした際に、このエラーが発生しました。
[{"messageType":"ERROR","messageText":null,"messageAppendedText":"The Status Reason field requires a value when the status is either pending or resolved. Select the status reason from the menu.","messageNumber":1291220}]
キューにStatus_Reasonフィールドを追加してみましたが、それでもエラーが発生します。
[{"messageType":"ERROR","messageText":null,"messageAppendedText":"You must associate a configuration item to this incident.","messageNumber":45534}]
or
[{"messageType":"ERROR","messageText":null,"messageAppendedText":"Status is not associated with the status reason. Please provide valid combination of Status and Status Reason values.","messageNumber":51310}]