Cherwell と統合する

統合でできるようになること

Jira Service Management は Cherwell との強力な双方向統合を提供します。統合を使用して Cherwell インシデントを詳細とともに Jira Service Management の API に送信します。Jira Service Management は Cherwell のアラートのディスパッチャーとして機能し、オンコール スケジュールに基づいて通知すべき担当者を決定します。メール、テキスト メッセージ（SMS）、電話、iOS や Android のプッシュ通知による通知を行い、アラートが承認またはクローズされるまでアラートをエスカレートします。

統合による機能

• When the status of incident is New or Reopened in Cherwell, an alert is created in Jira Service Management automatically through the integration.

• When the status of incident is In Progress in Cherwell, the alert that is created in Jira Service Management is acknowledged automatically.

• When the status of incident is Resolved or Closed in Cherwell, the alert that is created in Jira Service Management is closed automatically.

• If Send Alert Updates Back to Cherwell is enabled, incident actions are executed in Cherwell when the chosen action is executed in Jira Service Management for Cherwell alerts.

• [Create Cherwell Incidents for Jira Service Management Alerts（Jira Service Management アラート用に Cherwell インシデントを作成する）] が有効になっている場合、Cherwell 以外のソースからのアラートに対して選択されたアクションが Jira Service Management で実行されると、Cherwell でインシデント アクションが実行されます。

統合をセットアップする

Cherwell は双方向の統合です。セットアップは次の手順で行います。

• Jira Service Management で Cherwell 統合を追加する

• Cherwell で統合を設定する

Cherwell 統合を追加する

Jira Service Management で Cherwell 統合を追加するには、次の手順を実行します。

1. チームの運用ページに移動します。

2. 左側のナビゲーション パネルで、[統合] > [統合を追加] の順に選択します。

3. 「Cherwell」を検索して、選択します。

4. 次の画面で、統合の名前を入力します。

5. オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。

6. [Continue] を選択します。
   この時点で、統合が保存されます。

7. [統合を設定する手順] セクションを展開して、API キーをコピーします。
   このキーは、後ほど Cherwell で統合を設定する際に使用します。

8. [統合をオンにする] を選択します。
   統合のために作成したルールは、統合をオンにした場合にのみ機能します。

Jira Service Management から Cherwell にデータを送信するには、Jira Edge Connector が必要です。

We currently support Cherwellversion 10.X. Earlier versions aren’t supported due to API changes in Cherwell.

Cherwell で統合を設定する

Cherwell と Jira Service Management の統合を設定するには、次の手順を実行します。

1. 統合ブループリント（jsm.bp）をダウンロードします。

2. Cherwell Administrator で、jsm.bp を開いて公開します。

   • ブループリントを開く方法をご確認ください。

   • ブループリントを公開する方法をご確認ください。。

3. Stored Values Manager を開きます。

4. [グローバル/統合] に移動して「JSM API キー」を見つけます。

5. Paste the API key copied previously from Jira Service Management into JSM API Key.
   Read how to update stored values.

Jira Service Management から Cherwell にデータを送信するには、Jira Edge Connector（JEC）が必要です。

JEC 統合に必要な Cherwell での変更

JEC を介した統合をセットアップする前に、快適なエクスペリエンスをご利用いただくために次の手順を実行します。

REST API クライアント ID を取得する

1. Cherwell Service Management Administrator で [セキュリティ] を開きます。

2. [REST API クライアント設定を編集] を選択します。

3. プラス記号を選択して、新しいエントリを作成します。

4. REST API クライアントに Jira Service Management という名前を付けて、クライアント ID をコピーします。

5. フロッピー ディスクのアイコンを選択して保存します。

JEC 統合のユーザーを作成する

Cherwell で認証するための JEC 統合用の Cherwell ユーザーを作成します。

1. Cherwell Service Management Administrator で [セキュリティ] を開きます。

2. [ユーザーを編集] を選択します。

3. プラス記号を選択して、新しいエントリを作成します。

4. このユーザーの Cherwell 認証資格情報を指定します。

5. ユーザーの [氏名] を JSM に設定します。このフィールドでは大文字と小文字が区別されます。

6. 画像はオプションです。

7. フロッピー ディスクのアイコンを選択して保存します。

Create a customer for JEC Integration
Create a Cherwell Customer for JEC integration which will be used as the requestor of the incidents created by Jira Service Management.

1. Cherwell Service Management で、[新規] > [新規カスタマー - 社内] の順にクリックします。

2. カスタマーの [氏名] を JSM に設定します。このフィールドでは、大文字と小文字が区別されます。

3. 画像はオプションです。

4. フロッピー ディスクのアイコンを選択して保存します。

JEC 経由で統合する

または、Jira Service Management の JEC と Cherwell スクリプトを使用して、Cherwell でアクションを実行します。これによって、独自のスクリプト/機能をデプロイして提供されたスクリプト/機能を変更し、カスタマイズしたアクションを Cherwell 上で実行できるようになります。Cherwell 統合パッケージを使用するには、次のセクションの手順を最後まで実行します。

Cherwell パッケージの最新バージョンをダウンロードします。

インストール

RedHat ベースのディストリビューションである場合

次のコマンドを実行します。rpm -i cherwell-<your_version>.rpm

Debian ベースのディストリビューションである場合

次のコマンドを実行します。dpkg -i cherwell-<your_version>.deb

Windows の場合

JEC パッケージを含む統合 zip ファイルをディレクトリ内に解凍します（C:\jsm が推奨パス）。便宜上、この解凍パスを %JEC_HOME% と呼びます。解凍場所の値で JEC_HOME というシステム環境変数を作成できます。これを行うには、昇格した Powershell セッションを開き、次のコマンドを入力します。

テキスト

JEC の実行に関する詳細をご確認ください。

JEC 用に Cherwell 統合を設定する

• Cherwell 統合に JEC ユーティリティを使用するには、統合の設定で [JEC 経由で送信] を有効にします。

• Cherwell に関するその他の設定は、「統合の設定」ページまたは JEC 設定ファイルで行えます。「統合」ページで行われた設定は、設定ファイルよりも優先されます。

JEC を設定する

To be able to execute actions in Cherwell, JEC gets the configuration parameters from the configuration file located at path /home/jsm/jec/conf/config.json (Linux) or %JEC_HOME%\conf\config.json (Windows).

設定パラメーター

• apiKey — 上記で作成した Cherwell インテグレーションから API キーをコピーします。

• apiUrl – Cherwell API の URL。例: http://localhost/CherwellAPI/。

• username — Cherwell へのサインインに使用したユーザー名。

• password — Cherwell へのサインインに使用したパスワード。

• clientId – [JEC 統合に Cherwell で必要な変更] セクションに記載されています

The package that you downloaded also includes JEC utility which is at path /usr/local/bin/JiraEdgeConnector (Linux) or %JEC_HOME%\JiraEdgeConnector64.exe (Windows) and the script that is needed to be run by JEC which is under /home/jsm/jec/scripts (Linux) or %JEC_HOME%\scripts\actionExecutor.py (Windows). After the configuration of JEC is done, you need to run it. Read more about running JEC. After all is set, according to your action mappings incidents will be created / updated in Cherwell.