# ServiceNow Workflow

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FbsXlHiVGJ8ma5El1n5WT%2Fimage.png?alt=media&#x26;token=c87f4a72-b598-45f9-acf7-3127812ee277" alt=""><figcaption></figcaption></figure>

## 概要

ServiceNowワークフローアプリは、管理者およびセキュリティチームがServiceNowプラットフォーム上で直接Keeperボルトの操作を一貫して管理できるようにします。この連携ではKeeperコマンダーCLIの機能を利用し、サービスカタログポータルとあわせて、ServiceNowのIntegrationHubおよびFlow Designerワークフローに組み込んだ自動化と安全なパスワード管理が行えます。

次のServiceNowストアのURLから利用できます。

<https://store.servicenow.com/store/app/4b6de27987ebfe14e95f40c5cebb35d9>

## 機能

| 機能                      | 詳細                                                                                                                            | 説明                                             |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| **エンドポイント特権マネージャーの承認**  | EPMリクエストの承認または却下                                                                                                              | EPM承認リクエスト向けの自動SIRインシデントフロー。                   |
| **レコードまたはフォルダへのアクセス申請** | <p>フォルダへのアクセス申請</p><p>レコードへのアクセス申請</p><p>ワンタイム共有の申請</p>                                                                       | レコードまたはフォルダのパスまたはUIDを指定して、ユーザーのアクセスを付与または取り消す。 |
| **Keeperボルトへのレコード保存**   | <p>データベース認証情報の追加</p><p>ログインレコードの追加</p><p>サーバー認証情報の追加</p><p>SSH鍵の追加</p><p>ソフトウェアライセンスの追加</p><p>セキュアノートの追加</p><p>メンバーシップの追加</p> | 認証情報をKeeperボルトに安全に保存する。                        |
| **検索**                  | <p>レコードの検索</p><p>フォルダの検索</p>                                                                                                  | 指定したレコードまたはフォルダを検索する。                          |

## 利用例

#### レコードへのアクセス申請

1. 申請者が、社内Keeperボルトに保存されたレコードへのアクセスを求めるリクエストチケットを起票する。
2. アプリ管理者がリクエストを承認する。
3. フルフィルメントグループがタスクを処理し、ServiceNow専用アプリ経由で申請されたレコードを共有する。
4. 結果: レコードがServiceNowユーザーに正常に共有される。

#### エンドポイント特権管理

1. エンドポイントデバイスからリクエストが起票される。
2. そのリクエストに対してServiceNowのセキュリティインシデントが作成される。
3. ServiceNowのアプリ管理者がリクエストを承認または却下する。
4. セキュリティインシデントチケットが、適切なコメント付きでクローズされる。

## 要件

* ServiceNowでのMIDサーバー構成。
* MIDサーバーへのコマンダーCLIのインストール。
* ServiceNowの[Keeper Security ITSMアプリ](https://docs.keeper.io/jp/keeperpam/secrets-manager/integrations/servicenow-itsm) (任意 - EPM承認用)。

## ServiceNowで必要なロール

#### アプリ管理者ユーザーのロールと権限

| アプリケーションメニュー                                                     | 必要なロール                                                                                                                                                 |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 1. ガイド付きセットアップ                                                   | 1. `x_keese_ks_inthub.ks_admin`                                                                                                                        |
| 2. Keeper Service Portal                                         | <p>1. <code>x\_keese\_ks\_inthub.ks\_admin</code></p><p>2. <code>catalog-admin</code></p><p>3. <code>mid\_server</code></p>                            |
| <p>3. Service Catalog Requests</p><p>4. Service Catalog Task</p> | <p>1. <code>x\_keese\_ks\_inthub.ks\_admin</code></p><p>2. <code>catalog-admin</code></p><p>3. <code>itil</code></p><p>4. <code>mid\_server</code></p> |
| 5. My Approvals                                                  | 1. `x_keese_ks_inthub.ks_admin`                                                                                                                        |

#### 承認者ユーザーのロール

| アプリケーションメニュー    | 必要なロール                          |
| --------------- | ------------------------------- |
| 1. My Approvals | 1. `x_keese_ks_inthub.approver` |

#### 申請者ユーザーのロール

| アプリケーションメニュー             | 必要なロール                                                                                                           |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| 1. Keeper Service Portal | <p>1. <code>x\_keese\_ks\_inthub.ks\_app</code></p><p>2. <code>itil</code></p><p>3. <code>mid\_server</code></p> |

## サポート担当者向けロール

| アプリケーションメニュー                                                                | 必要なロール                                                                                          |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| <p>1. Application Log</p><p>2. Support Page</p><p>3. App Privacy Policy</p> | <p>1. <code>workflow\_admin</code></p><p>2. <code>x\_keese\_ks\_inthub.support\_user</code></p> |

## アプリのダウンロードとインストール

**System Administrator (`admin`)** ロールを持つユーザーのみ、ServiceNow Storeからアプリケーションをインストールできます。

1. [ServiceNow Storeの掲載ページ](https://store.servicenow.com/store/app/4b6de27987ebfe14e95f40c5cebb35d9)を開きます。
2. **\[Get]** をクリックします。
3. アプリがServiceNowインスタンスに正常に追加されたら、 **\[All]** > **\[System Applications]** > **\[All Available Applications]** > **\[All]** に移動します。
4. **\[install]** をクリックします。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FWvglNob38K5W2TiS3ClP%2Fimage.png?alt=media&#x26;token=59ddf862-c201-473d-ab3c-35364ff3e2b2" alt=""><figcaption></figcaption></figure>

## 構成手順

### MIDサーバーの構成

Keeper Security WorkflowアプリをServiceNowで使うには、管理者がMIDサーバーを構成し、ServiceNowで検証済みにする必要があります。

MIDサーバーは、KeeperコマンダーCLIとサービスモードをホストするServiceNow上のエージェントです。

MIDサーバーを構成するには、次の手順に従います。

1. 管理者権限でServiceNowインスタンスにログインします。
2. **\[All]** タブに移動し、 **\[keeper security Workflow]** を検索して **\[Guided Setup > MID Server]** を開きます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FvsM69LwuRd7Xw4Wh6f57%2Fimage.png?alt=media&#x26;token=f04a07b9-bb68-40cc-a8f5-d7cba0de3bc8" alt=""><figcaption></figcaption></figure>

MIDサーバーインストールのトラブルシューティングについては、ServiceNowの手順を[こちら](https://www.servicenow.com/docs/bundle/zurich-servicenow-platform/page/product/mid-server/concept/mid-server-installation.html)をご参照ください。

### Keeper Security Workflowの構成

MIDサーバーの構成と検証が完了したら、次の手順でアプリを構成します。

1. 管理者権限でServiceNowインスタンスにログインします。
2. **\[All]** タブに移動し、 **\[Keeper Security Workflow]** を検索して **\[Guided Setup]** を開きます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2F6litWoywudIfmoBtyoF3%2Fimage.png?alt=media&#x26;token=84a29466-40eb-472f-bbee-6b996dce62f0" alt=""><figcaption></figcaption></figure>

3. **\[Install Keeper Commander CLI]** をクリックし、 **\[Configure]** をクリックして、MIDサーバーへのKeeperコマンダーCLIのインストール手順に従います。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FGG8IjkUy58JGB9LTibIY%2Fimage.png?alt=media&#x26;token=df783cfe-ffdb-46f5-a6e0-803cd748ddc3" alt=""><figcaption></figcaption></figure>

4. 次のステップ **\[Configure Keeper Service Mode On MID Server]** に進み、**\[configure]** をクリックして、MIDサーバー上でサービスモードを構成し起動する手順に従います。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2F23HkfzjNzLuIAQe5qJ20%2Fimage.png?alt=media&#x26;token=224b7e92-a069-4eb3-aac2-94a826531b8a" alt=""><figcaption></figcaption></figure>

設定例は次のとおりです。

```
My Vault> service-create
Enter Port No:9090
Enable Ngrok Tunneling? (y/n):n
Enable TLS Certificate (y/n):n
Enable Request Queue? (y/n):y
Enable Advanced Security? (y/n):n
Select Run Mode (foreground/background):foreground
List of supported commands, Enter comma separated: get, search, record-add, record-update, share-folder, share-record, one-time-share, epm
Select configuration format (json/yaml):json
Generated API key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

```
Uploading service_config.yaml ...
Commander Service starting on https://localhost:9090/api/v2/
Commander Service started with PID: 35215
```

### 承認グループ

MIDサーバー上でサービスモードが稼働したら、ガイド付きセットアップで承認グループを構成します。

承認グループのメンバーは、申請者が起票した各リクエストの承認依頼を受け取ります。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FkD3tZVX2HmCDgqItWJNo%2Fimage.png?alt=media&#x26;token=2c7ce183-4576-4727-950a-956a21c72369" alt=""><figcaption></figcaption></figure>

5. ガイド付きセットアップの最終ステップ **\[Configure Keeper ServiceMode Credentials]** に進み、 **\[Configure]** をクリックします。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FkevUWqgal2hJuil2ZExo%2Fimage.png?alt=media&#x26;token=e51ef435-4155-4fe9-a660-232d0ce709ab" alt=""><figcaption></figcaption></figure>

6. **\[New]** をクリックし、MIDサーバー上で動作しているサービスモードの詳細を構成します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FQ2Zp87BqQA2PwWvvNBIj%2Fimage.png?alt=media&#x26;token=db991f7b-eb28-4fef-a83e-6c62ba0fd9ad" alt=""><figcaption></figcaption></figure>

## サービスのリクエスト

申請者は次の手順でサービスをリクエストできます。

1. **\[All]** > **\[Keeper Security Workflow]** > **\[Keeper Service Portal]** に移動します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FKC85hvJP8TAqy4xNaF6e%2Fimage.png?alt=media&#x26;token=3f8b6489-b4c8-4eed-a05b-07fcfa8e1132" alt=""><figcaption></figcaption></figure>

2. サービスポータルページで **\[Request something]** をクリックします。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2F6Y5ak194rS6y4wjRg9v9%2Fimage.png?alt=media&#x26;token=b1d353e2-96b8-4bed-b1f0-d342f6fb1c06" alt=""><figcaption></figcaption></figure>

3. 目的のカテゴリをクリックし、リクエストするサービスを選択します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FuT4IVih6drXRmP1IwrGx%2Fimage.png?alt=media&#x26;token=ca6f7b88-27bc-4a7e-9eed-f145eb3a7bc7" alt=""><figcaption></figcaption></figure>

4. 項目に関するフォームに入力し、**\[Request]** をクリックします。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FEl5sCpYUzdejlO7KZZIT%2Fimage.png?alt=media&#x26;token=72c81771-a8cd-4a91-8ef8-d8ee65c45b82" alt=""><figcaption></figcaption></figure>

5. 次の画面のとおり詳細付きで、申請者にリクエストチケットが割り当てられます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FqmGnnou6KfJl9R4YIxfa%2Fimage.png?alt=media&#x26;token=e88e0be5-42b6-423c-a5e3-53604259ef70" alt=""><figcaption></figcaption></figure>

### リクエストの承認

アプリ管理者側では、リクエストの表示、承認または却下、必要に応じたタスクの実行が行えます。

1. リクエストの表示および承認/却下のため、アプリ管理者または承認者は **\[All] > \[Keeper Security Workflow] > \[My Approvals]** に移動します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FcPSA4Sy7BBfatBtmCS8C%2Fimage.png?alt=media&#x26;token=6df36463-a47d-4dd0-99fa-5c15a128564f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2F06s6tJgplmWT7t961USu%2Fimage.png?alt=media&#x26;token=3080f0bb-a37a-4e2b-9872-d32146d8d62f" alt=""><figcaption></figcaption></figure>

2. 承認者は、該当ボタンをクリックしてリクエストを承認または却下します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FpWb1SxAml16fpZd6twDl%2Fimage.png?alt=media&#x26;token=6afddc8c-60eb-443a-84c2-c4981b21492b" alt=""><figcaption></figcaption></figure>

### タスクの履行

タスクに追加情報やフルフィルメント作業が必要な場合 (共有する正しいレコードの取得やユーザー申請の権限変更など)、タスク欄から対応できます。

1. **\[All]** > **\[Keeper Security Workflow]** > **\[Service Catalog Task]** に移動します。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FiFySJFOp8SaJpQuHaL0M%2Fimage.png?alt=media&#x26;token=1857d7ef-b2c9-4868-b53b-17e8a3d5787b" alt=""><figcaption></figcaption></figure>

2. タスク欄では、アプリ管理者は共有するレコードやフォルダを検索したり、ServiceNowから直接Keeperボルトに新しいレコードを作成したりできます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FT88kifPwpwqalQSPqEsB%2Fimage.png?alt=media&#x26;token=167a947e-a056-478b-a792-26c770a66cd3" alt=""><figcaption></figcaption></figure>

3. タスク欄で、アプリ管理者はレコードを検索できます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2F7C8FUEXO11qgCkgOzzJu%2Fimage.png?alt=media&#x26;token=b3a97105-b6b8-4809-a133-4934763400bd" alt=""><figcaption></figcaption></figure>

4. タスクが完了すると、申請ユーザーに目的のレコードが共有され、コマンダーサービスモードから受け取ったメッセージが表示されます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FZzEd6ghIqjz07pQR9jeK%2Fimage.png?alt=media&#x26;token=31ccd9f5-d4bd-4f88-9357-fca83021b490" alt=""><figcaption></figcaption></figure>

***

## エンドポイント特権マネージャー

エンドポイント特権管理の承認サイクルは[ServiceNow Keeper Security ITSM](https://docs.keeper.io/jp/keeperpam/secrets-manager/integrations/servicenow-itsm)アプリに依存します。

この機能を使うには、管理者がKeeper管理コンソールでエンドポイント特権マネージャーのアラートを有効にする必要があります。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2F7MJo7wSlJTtkNlwfN0aB%2Fimage.png?alt=media&#x26;token=050fb589-8d12-4dfd-9b0e-51042078d939" alt=""><figcaption></figcaption></figure>

1. EPMリクエストが起票されると、 **\[Keeper Security Workflow]** > **\[My Approvals]** にリクエストが表示されます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FcPSA4Sy7BBfatBtmCS8C%2Fimage.png?alt=media&#x26;token=6df36463-a47d-4dd0-99fa-5c15a128564f" alt=""><figcaption></figcaption></figure>

2. セキュリティインシデントチケットを参照するリクエストが作成されます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FSwiSTqpPnfzIwQuDJsSg%2Fimage.png?alt=media&#x26;token=e841a2f1-f348-4aa9-9d57-89337c5fb71b" alt=""><figcaption></figcaption></figure>

3. アプリ管理者がリクエストを承認または却下すると、承認プロセス完了後にセキュリティインシデントチケットが適切なコメント付きでクローズされます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fk6KsJczqQfqBj1IkBXFv%2Fimage.png?alt=media&#x26;token=ea590e57-4f0b-41e9-b0ab-a2da0bf0728a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FmQDoFJREB5qWwXlPdRMd%2Fimage.png?alt=media&#x26;token=f2e85b4f-89fc-40a2-a60e-32371478c97a" alt=""><figcaption></figcaption></figure>

***

## トラブルシューティング

#### サービスモード構成エラー

MIDサーバーでサービスモードを構成する際に次のエラーが出る場合は、次の手順で調査してください。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FsIhmF3xIMJgtVdvEhtUC%2Fimage.png?alt=media&#x26;token=cba95e00-b1fb-4902-9191-502dd7ea0b2f" alt=""><figcaption></figcaption></figure>

1. サービスモードのホストまたはAPIキーを確認する。
2. 構成フォーム送信時に正しいMIDサーバーが選ばれているか確認する。

#### **\[My Approvals]** に承認リクエストが表示されない

1. ServiceNowでサービスモードをセットアップするときに、正しい承認グループが構成されているか確認する。
2. アプリ管理者が、フォームで設定した承認グループのメンバーになっているか確認する。

#### レコード/フォルダ検索で **\[Unexpected error occurred]** が表示される

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2F7jIkhpLdGjNrtZh0blBG%2Fimage.png?alt=media&#x26;token=b61966c7-8f46-4240-900b-769d6581b67f" alt=""><figcaption></figcaption></figure>

1. MIDサーバーのステータスがUPか確認する。Downの場合はMIDサーバーを再起動する。
2. MIDサーバーが検証済みか確認する。
3. 正しいMIDサーバー上でサービスモードが動作し、設定したポートで待ち受けているか確認する。

#### **\[My Approvals]** にEPMリクエストが表示されない

1. Keeper管理コンソールのアラートで、エンドポイント特権マネージャーのアラートが有効か確認する。
2. Keeper Security ITSMアプリがインストールされ有効化されているか確認する。
3. Keeper Security ITSMアプリが正しく構成されているか確認する。

### アプリケーションログ

アプリケーションログの詳細は、常に **\[Application Log]** セクションで確認できます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2FpXM6LFFHYc7XKNaFbJIZ%2Fimage.png?alt=media&#x26;token=2e426376-a61e-4c92-9517-a857ad26f0d7" alt=""><figcaption></figcaption></figure>