DOCS
インテグレーションガイド / ServiceNow Legacy

ServiceNowのインストール前の要件

アプリケーションアクセスコントロール

PagerDutyのインテグレーションを機能させるには、インストール前にServiceNowで以下の変更が必要です。この作業は、ServiceNow管理者が行う必要があります。

1. System Definition →Tables モジュールから、ユーザー（ sys_user ）テーブルのレコードを開きます。

2. ユーザーフォームからPagerDutyユーザーをプロビジョニングするアクションをサポートできるようにAllow configurationオプションを有効にします。

1. System Definition→Tablesモジュールから、グループ（ sys_user_group ）テーブルのレコードを開きます。

2. グループフォームからPagerDutyサービスとポリシーをプロビジョニングするアクションをサポートするには、 Allow configurationオプションを有効にします。

3. PagerDutyがグループのサービスおよびポリシーIDをグループレコードに書き込めるようにCan createおよびCan updateオプションを有効にします。

ServiceNowでの設定

1. ServiceNow Storeにログインし、PagerDuty Incident Resolution Platformアプリケーションを検索します。

2. アプリケーションを購入するオプションを選択します。このアプリケーションには無料です。使用しているServiceNowのバージョンで使用できる最新バージョンのアプリを選択してください。

3. ServiceNow Enterpriseアカウントに管理者としてログインします。

4. System Applications →Applications モジュールを開き、 Downloadsタブをクリックして新しいアプリケーションを表示します。

5. PagerDutyアプリケーションでInstallをクリックします。

ビューにPagerDutyフィールドを追加する

PagerDuty IDフィールドを表示する場合は、手動で追加する必要があります。 利用可能なフィールドのリストは次のとおりです。 これらのフィールドをフォームビューに追加すると、関連するPagerDutyレコードへのクイックリンクを使用することもできます。

• User

  • PagerDuty ID

• Group

  • PagerDuty service

  • PagerDuty escalation

• Incident

  • PagerDuty ID

PagerDutyでの設定

REST APIキーを作成する

1. Configuration メニューから、API accessを選択します。

   <li”>API accessのページでCreate New API Keyボタンをクリックします。

• ポップアップするダイアログで、キーのDescription を入力し、 API versionを選択するよう求められます。 また、キーをRead-onlyとして作成するオプションもあります。 このボックスをチェックしないままにすると、フルアクセスキーが作成されます。

バージョン管理に関する注記： API v2.0は、新しいインテグレーションがPagerDutyとの通信を容易にするように設計されています。既存のPagerDutyのインテグレーションには、API v1.0キーが必要です。

1. オプションを入力したら、Create Key<をクリックします。

2. Create Key をクリックすると、キーを表示したダイアログが表示され、前の手順で記入したオプションが確認されます。 このステップの後にはキーにアクセスできなくなるので、今すぐ必要なアプリケーションにこのキーをコピーしてください。以前に作成したキーを失くして再びアクセスする必要がある場合は、キーを削除して新しいキーを作成する必要があります。キーを正常にコピーしたら、Closeをクリックします。

ServiceNowでの設定

PagerDutyアプリケーションを設定する

1. PagerDuty→Configuration →Properties移動します。

2. 上記の例に従ってPagerDutyアカウントのURLを入力し、前の手順でAPIキーに貼り付けます。 また、セキュリティキーを長い一意の文字列に変更することもお勧めします。 このキーは、すべてのwebhook URLに必要です。

3. Configuration→Test API Connectionをクリックして、統合が有効であることを検証します。すべてが正常に動作している場合は、Connection test successful (200)応答が必要です。

レビューすべき追加のプロパティ

• Default PagerDuty User ID to use if auto-provisioning is disabled:アクションを実行するServiceNowユーザのPagerDutyアカウントを統合が識別できない場合に使用する有効なPagerDutyユーザIDを入力します。

• Incident state value to use when PagerDuty resolves an incident: デフォルトのServiceNowインシデントの状態を変更した場合は、PagerDutyが関連するインシデントを解決するときにインシデントを設定する値を入力します。

• Resolve PagerDuty incident if ServiceNow incident is assigned to a group that doesn’t exist in PagerDuty: PagerDutyインシデントがあるPagerDutyインシデントにリンクされ、ServiceNowインシデントがPagerDutyサービスを持たないグループに再割り当てされた場合、PagerDutyインシデントは解決され、ServiceNowからリンク解除されます。

• Automatically create a PagerDuty user if one is not found matching the user’s email: ユーザーがPagerDutyで見つからない場合、統合によって自動的にServiceNowのユーザーの電子メールアドレスに基づいてユーザーがプロビジョニングされます。

• Only assign based on an acknowledgment from PagerDuty user：有効にすると、PagerDutyで通知されたときにPagerDutyの割り当てがServiceNowで更新されます。

アサインメントグループをPagerDutyにプロビジョニングする

ServiceNowには、アサインメントグループの概念があります。PagerDutyとのインテグレーションでは、各アサインメントグループに対応するPagerDutyサービスとエスカレーションポリシーが用意されています。この統合により、新しいPagerDutyサービスとエスカレーションポリシーを迅速に生成する簡単な方法が提供されます。また、ServiceNow内の関連フィールドも入力します。

1. 以下は、ServiceNowインスタンス内のすべての割り当てグループのリストです。 PagerDuty ServiceとPagerDuty escalation policyのフィールドは、リストされているグループでは空であることがわかります。

2. 次に、PagerDutyにプロビジョニングする割り当てグループを選択します。 この場合、それはCAB Approvalグループです。次に、Provision PagerDuty Service リンクをクリックして、このグループをPagerDutyに展開します。

3. 次に、割り当てグループが作成されることがユーザーに通知されます。 完了したら、PagerDuty serviceおよび PagerDuty escalation policyフィールドに値が入力されます。

4. 最後に、対応するサービスとエスカレーションポリシーが作成されていることがわかります。このサービスには、PagerDutyとServiceNowの間の双方向同期に必要なWebHookも自動的に作成されます。webhookには、URLの共有秘密情報も含まれており、通信のセキュリティが強化されています。

PagerDutyへのユーザーのプロビジョニング

1. この統合により、ServiceNowからPagerDutyへのユーザのプロビジョニングも可能になります。 以下はServiceNowユーザーの一覧です。 PagerDuty IDフィールドに既に入力されているため、PagerDutyで既に作成されているユーザーを直接見ることができます。

2. PagerDutyにまだプロビジョニングされていないユーザーを選択します。 Provision PagerDuty Userのリンクをクリックして、PagerDutyアカウントに追加することができます。

3. 次に、ユーザーがプロビジョニングされているという通知が表示されます。 完了すると、PagerDuty IDフィールドに自動的に入力されます。 ユーザーはPagerDuty内にも表示されます：

4. ユーザーにBusiness phoneフィールド、またはMobile phoneフィールドが設定されている場合、これらの設定はPagerDutyの連絡方法と通知ルールとして自動的にプロビジョニングされます。

5. また、複数のユーザーを選択するには、User画面のドロップダウンメニューからProvision PagerDuty Userオプションをクリックして、一度にプロビジョニングできます。

ServiceNowとPagerDutyが通信していることを確認する

ServiceNowのグループにインシデントを割り当てて、それらが通信していることを確認できます。 以下は、PagerDutyサービスに結びついているField Serviceグル​​ープに割り当てられたインシデントです。その後、PagerDuty内のCAVUCodeエスカレーションポリシーに再割り当てされました。

インシデントがPagerDutyで解決されると、それはServiceNowで解決され、その逆も可能です。 ServiceNowは、PagerDuty内で行われた活動のログも保持します。