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

ServiceNowでの作業

PagerDutyアプリケーションをインストールする

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

2. Getをクリックして、アプリケーションをインストール可能にします。

3. ServiceNow Expressにadminとしてログインします。

4. Application Configuration → Store Applicationsに進み、Downloadsタブをクリックして新しいアプリケーションを表示します。

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

PagerDutyユーザーを作成する

PagerDutyのwebhookを処理するには、ServiceNowユーザーアカウントが必要です。既存のユーザーアカウントを使用するのではなく、PagerDuty用のサービスアカウントを作成することをお勧めします。

1. User Administration → Usersに進み、Newをクリックします。

2. 例えば 「pagerduty.webhook」 などのUser IDを入力し、パスワードを入力して、 admin と x_pd_integration_xadmin 権限をこのユーザーに割り当てます。

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

• User
  • PagerDuty ID
• Group
  • PagerDuty service
  • PagerDuty escalation
• Incident
  • PagerDuty ID

PagerDutyでの作業

PagerDutyにadminまたはアカウント所有者としてログインします。

REST APIキーを作成する

1. Configuration → API Accessに移動し、Create New API Keyをクリックします。 注：PagerDutyに管理者またはアカウント所有者としてログインしていない場合や、アカウントの料金プランにAPIアクセスが含まれていない場合は、APIアクセスは表示されません。

2. 「ServiceNow Express」など新しいキーの説明をDecriptionに入力し、このキーのAPI versionをv1 Legacyに設定してから、Create Keyをクリックします。 注：現時点でServiceNow Expressではv2 Currentを選択することはできません。

3. Create Keyをクリックすると、キーを表示したダイアログが表示され、前の手順で記入したオプションの確認になります。

ダイアログを閉じる前にこのキーをコピーしてください。この後はキーを再度表示ことはできません。作成したキーをなくした場合、再度アクセスするにはキーを削除して新しいキーを作成する必要があります。キーを正常にコピーしたらCloseをクリックします。

ServiceNowでの作業

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

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

2. PagerDutyアカウントURLをPagerDuty instance URLとREST API endpoint URLフィールドに入力し、PagerDutyのAPI Access keyを貼り付け、PagerDuty webhookを処理するために作成したServiceNowのユーザーアカウントとパスワードを入力します。

3. インテグレーションを有効化するために、PagerDuty for Express → Test REST API Connectionに進みます。すべてが正常に動作している場合は 「Connection test successful (200)」 が表示されます。

追加のプロパティ

• lowest priority incident that will trigger a PagerDuty incident（PagerDutyのインシデントをトリガーする最も優先度の低いインシデント）：トリガーしたいServiceNowインシデントの優先度を入力してください

• Only assign based on an acknowledgment from PagerDuty user（PagerDutyユーザーからの確認に基づいてのみ割り当て）：有効にするとインシデントがPagerDutyで確認されたときにServiceNowでのみPagerDutyの割り当てが更新されます

• Automatically create a PagerDuty user if one is not found matching the user’s email（ユーザーの電子メールに一致するものが見つからない場合、PagerDutyユーザーを自動的に作成）：Pag​​erDutyでユーザーが見つからない場合、ServiceNowユーザーの電子メールアドレスに基づいて自動的にPagerDutyユーザーが作成されます

• Default PagerDuty User ID to use if auto-provisioning is disabled（自動プロビジョニングが無効な場合に使用するデフォルトのPagerDutyユーザーID）：アクションを実行するServiceNowユーザーのPagerDutyアカウントが識別できない場合に使用する、有効なPagerDutyのユーザーIDを入力します

割り当てグループをPagerDutyにプロビジョニングする

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

1. 以下は、ServiceNowインスタンス内のすべての割り当てグループのリストです。リストされたグループのPagerDuty serviceとPagerDuty escalationフィールドが空であることに注目してください。

2. 次に、PagerDutyにプロビジョニングする割り当てグループを選択します。この場合はService Deskグループとしています。Provision PagerDuty Serviceリンクをクリックして、このグループをPagerDutyにデプロイします。

3. 割り当てグループが作成されることがユーザーに通知されます。その後、PagerDuty serviceとPagerDuty escalationフィールドが入力されます。

4. 最後に、対応するサービスとエスカレーションポリシーがPagerDuty内で作成されていることがわかります。このサービスには、PagerDutyとServiceNowの間の双方向同期に必要なwebhookも自動的に作成されます。webhookには、先ほど設定した pagerduty.webhook ユーザーの資格情報も含まれています。

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

このインテグレーションにより、ServiceNowからPagerDutyへのユーザのプロビジョニングも可能になります。プロビジョニングの唯一の要件は、PagerDutyでプロビジョニングするためにServiceNowに電子メールアドレスを設定する必要があることです。

さらに、ServiceNowプロファイルにBusiness phoneまたはMobile phoneが設定されている場合、これらの番号は新しいPagerDutyアカウントで連絡方法と通知ルールとしてプロビジョニングされます。

以下はServiceNowユーザーの一覧です。PagerDuty IDフィールドが入力されていることにより、PagerDutyですでに作成されているユーザーをすばやく確認できます。

単一のユーザーをプロビジョニングする

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

2. ユーザーがプロビジョニングされているという通知が表示されます。PagerDuty IDフィールドが自動的に入力されます。

一度に複数のユーザーをプロビジョニングする

複数のユーザーを一度にプロビジョニングするには、ユーザーを選択し、UsersページのドロップダウンメニューからProvision PagerDuty Userオプションを選択します。

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

ServiceNowのPagerDuty対応グループにインシデントを割り当てることで、相互に通信していることを確認できます。以下は、PagerDutyサービスに結びついているService Deskグループに割り当てられたインシデントです。その後、PagerDuty内で認識され、PagerDutyで割り当てられたユーザーによって追加されたメモがServiceNowにインポートされました。

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