Cherwell と統合する

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

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

統合による機能

• Cherwell でインシデントのステータスが「新規」または「再オープン済み」である場合は、統合によって Jira Service Management で自動的にアラートが作成されます。

• Cherwell でインシデントのステータスが [進行中] である場合は、Jira Service Management で作成されたアラートが自動的に承認されます。

• Cherwell でインシデントのステータスが「解決済み」または「クローズ」になると、Jira Service Management で作成されたアラートは自動的にクローズされます。

• [アラート更新を Cherwell に送信する] が有効化されている場合、Jira Service Management で Cherwell アラート用に選択されたアクションが実行されると、Cherwell でインシデント アクションが実行されます。

• [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. [続行] を選択します。
   この時点で、統合が保存されます。

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

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

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

現在、Cherwell バージョン 10.X をサポートしています。Cherwell の API の変更によって、以前のバージョンはサポート対象外です。

Cherwell で統合を設定する

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

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

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

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

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

3. Stored Values Manager を開きます。

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

5. 先ほど Jira Service Management からコピーした API キーを [JSM API キー] に貼り付けます。
   保存された値を更新する方法をご確認ください。

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. フロッピー ディスクのアイコンを選択して保存します。

JEC 統合のカスタマーを作成する
Jira Service Management が作成したインシデントのリクエスト元として使用される JEC 統合用の Cherwell カスタマーを作成します。

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 を設定する

Cherwell でアクションを実行するために、JEC はパス /home/jsm/jec/conf/config.json（Linux）または %JEC_HOME%\conf\config.json（Windows）にある設定ファイルから設定パラメーターを取得します。

設定パラメーター

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

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

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

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

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

ダウンロードしたパッケージには、パス /usr/local/bin/JiraEdgeConnector（Linux）または %JEC_HOME%\JiraEdgeConnector64.exe（Windows）にある JEC ユーティリティや、/home/jsm/jec/scripts（Linux）または %JEC_HOME%\scripts\actionExecutor.py（Windows）にある、JEC によって実行される必要のあるスクリプトも含まれます。JEC の設定が完了したら、JEC を実行する必要があります。JEC の実行に関する詳細をご確認ください。すべての設定の完了後、アクション マッピングに従ってインシデントが Cherwell で作成/更新されます。