---
title: 外部サービス（External Services）
description: OpenLM Platform の Directory Sync で External Services を設定し、退職者を SaaS サービスから削除します。または、自分で削除するための通知を受け取ります。
product: OpenLM Platform
---

退職者が利用中の SaaS サービスにアカウントを残さないようにするには、それらのサービスを **External Services** に追加します。Directory Sync Service（DSS）が社内 Active Directory からユーザーが削除されたことを検出すると、External Services は、設定済みのすべての外部プラットフォームからそのユーザーを削除するか、手動で対応するよう通知します。

External Services はユーザーの削除のみを行います。外部サービスでのユーザーの作成や更新は行いません。

:::note[External Services の以前の名前]
**External Services** は、独立した **Identity Alignment** アプリに代わるもので、そのアプリは **OneDirectorySync** に代わるものでした。ログや設定で OneDirectorySync への言及を見かけた場合、それはこのサービスを指しています。**Navigation** メニューには、その以前のアプリを開く **Identity Alignment** タイルがあります。同じサービスを扱います。このページでは、Directory Sync の **External Services** ページについて説明します。
:::

## はじめに

次の前提条件を確認します。

- **Identity Alignment** 製品が [OpenLM Products](https://www.openlm.com/documentation/ja/cloud/openlm-administration/products/) で有効化されていること。
- Identity Alignment の **Admin** ロールがあること。アカウント管理者には常にこのページが表示されます。ロールがない場合、サイドバーの **External Services** は非表示になり、アドレスを直接指定してページを開くと **Agents** に戻されます。
- **Directory Sync Service（DSS）** が有効化され、同期サイクルが実行されていること。
- **Directory Synchronization Agent（DSA）** がお客様の環境にインストールされ、Active Directory に接続されていること。
- **Cloud Broker** が対象サービスに必要な認証情報で設定されていること（通常サービスの場合）。

Identity Alignment には、[OpenLM Products](https://www.openlm.com/documentation/ja/cloud/openlm-administration/products/#製品の依存関係) に専用のカードはありません。OpenLM Platform は、Directory Sync が有効になり、OpenLM ライセンスが Identity Alignment を対象にしている場合に Identity Alignment を自動的に有効化し、Directory Sync が無効化されると Identity Alignment も無効化します。

External Services は OpenLM Platform でのみ利用できます。

External Services を開くには、OpenLM Platform のヘッダーにある **Navigation**（グリッドアイコン）、**Users**、**Directory Sync** の順に選択し、サイドバーの **External Services** を選択します。

関連する作業については、[Directory Sync](https://www.openlm.com/documentation/ja/cloud/users/directory-sync/index) と [Cloud Broker](https://www.openlm.com/documentation/ja/cloud/data-collection/cloud-broker/) を参照してください。

## External Services の機能

External Services は次の機能を提供します。

- DSS の同期結果に応じて削除されたユーザーを検出
- Cloud Broker を通じて設定済みの外部サービスからユーザーを削除
- 組み込みサービス連携とカスタムサービス定義の両方に対応
- 各サービスの削除シナリオに応じて、メールまたはチケットで通知
- サービスごとに削除シナリオを提供: 自動削除、通知のみ、削除と通知

## 動作の仕組み

ユーザーが退職すると、次のことが起こります。

1. 社内 Active Directory からユーザーが削除される。
2. DSS が同期サイクルを実行し、削除を検出する。
3. DSS が External Services にユーザー削除イベントを送信する（OpenLM Products で Identity Alignment 製品が有効な間のみ）。
4. External Services が、設定済みの各サービスについて削除されたユーザーを処理する。ユーザーがそのサービスにアカウントを持っているかどうかは、事前に確認しない。
5. 各サービスの設定に応じて、External Services が次のアクションを実行する：
   - **Delete Only**: Cloud Broker が外部サービスからユーザーを削除する。削除できない場合、ユーザーは「removed」としてマークされる。
   - **Notify Only**: External Services が、手動で削除すべきことを通知する。自動削除は行わない。
   - **Delete And Notify**: Cloud Broker がユーザーを削除し、External Services が確認通知を送信する。
6. **カスタムサービス**の場合、アップロードされたユーザーリストにユーザーが存在するかを確認し、手動削除の通知を送信する。

:::note
外部サービスでユーザーがグループに所属している場合、External Services はユーザーとグループの関係を削除します。ユーザーをすぐに完全削除することはありません。
:::

:::tip
External Services はサービスの設定とオーケストレーションを担当します。Cloud Broker が外部サービスからユーザーを削除します。ここにサービスを追加する前に、Cloud Broker で必要な認証情報を設定してください。
:::

Cloud Broker にも [External Services](https://www.openlm.com/documentation/ja/cloud/data-collection/cloud-broker#external-services) という名前のページがあります。こちらは、SaaS プラットフォームを最初に接続する場所です。Directory Sync の **External Services** ページは、すでに接続済みのプラットフォームで退職者をどう扱うかを決めます。

## External Services と Service Configuration を開く

Directory Sync のサイドバーで、次の入口を使用します。

- サービスを追加、変更、削除するには、Directory Sync のサイドバーで **External Services** を開きます。
- デフォルトの通知メールとチケットメールを設定するには、**Service Configuration** を開き、**Identity Alignment Notifications** タブを選択します。

## External Services の設定

どのサービスが設定されているか、各サービスが退職者をどう扱うかを確認するには、**External Services** を開きます。一覧には、各サービスの **Service Name**、**Description**、**Option** が表示されます。**Option** は削除シナリオで、**Delete Only**、**Delete And Notify**、**Notify Only** のいずれかです。サービスを探すには、**Service Name** でフィルターします。**Search** は、現在のページの行で一致するテキストを強調表示します。

次のスクリーンショットは、設定済みサービスの一覧を示します。

*External Services の一覧。Option は、各サービスが退職者をどう扱うかを示します。*

### 通知設定の構成

**Service Configuration** の **Identity Alignment Notifications** タブで、デフォルトの通知メールアドレスを設定します。これらのデフォルトはすべてのサービスに適用されます。

デフォルトを設定するには、次の手順を実行します。

1. サイドバーで **Service Configuration** を選択します。
2. **Identity Alignment Notifications** タブを選択します。
3. **Default email for notifications** の下で、**Email** を入力します。
4. （任意）削除イベントで IT サービス管理システムにチケットを作成する場合は、**Default ticketing system email for notifications** の下で **Ticketing system email** を入力します。
5. **Save** を選択します。

次のスクリーンショットは、このタブを示します。

*External Services のデフォルトの通知アドレス。*

:::note
このタブは OpenLM Platform でのみ、Identity Alignment の **Admin** ロールを持つユーザーに表示されます。**Service Configuration** 自体は管理者専用です。Directory Sync は、各値がメールアドレスの形式かどうかだけをチェックするため、入力ミスがないか確認してください。
:::

### 通常サービスの追加

サービスを追加する前に、Cloud Broker で有効な認証情報が設定されていることを確認します。通常サービスを追加するには、次の手順を実行します。

1. サイドバーで **External Services** を選択します。
2. **Add Service** を選択します。
3. **Add External Service** ページで、**Available services** ドロップダウンリストを開きます。

    一覧には、Cloud Broker で設定済みのサービスが表示されます。各エントリには、サービス名と、説明がある場合は縦棒に続けてその説明が表示されます。

4. サービスを選択します。
5. **Account** タブで、サービスの詳細を確認します。

    **Service** と **Description** は読み取り専用で、選択したサービスの Cloud Broker の設定から取得されます。

    次のスクリーンショットは、**Account** タブを示します。

    *Account タブには、選択した Cloud Broker のサービスが表示されます。*

6. **Actions configuration** タブを開きます。
7. **Select the scenario of deleting a user** で、次のオプションから 1 つを選択します。

    3 番目のオプションが既定で選択されています。

    - **Delete user without additional notification. If the user can't be removed at all, it will be marked as removed.**: Cloud Broker がユーザーを削除する。削除できない場合、ユーザーは「removed」としてマークされる。
    - **Delete user and notify**: Cloud Broker がユーザーを削除し、External Services が通知を送信する。
    - **Don't delete, just notify that user should be deleted.**: External Services が通知のみ送信する。自動削除は行わない。

8. （任意）**Custom email** をオンにします。
9. （任意）**Email** を入力して、このサービスのデフォルトの通知メールを上書きします。
10. （任意）**Custom ticketing system** をオンにします。
11. （任意）**Ticketing Email** を入力して、このサービスのデフォルトのチケットメールを上書きします。
12. **Save** を選択します。

    ページは一覧に戻ります。次のスクリーンショットは、**Actions configuration** タブを示します。

    *退職者をどう扱うかを選択し、必要に応じてこのサービスの通知アドレスを上書きします。*
*退職者をどう扱うかを選択し、必要に応じてこのサービスの通知アドレスを上書きします。*

どちらの上書きフィールドにも、有効なメールアドレスを入力する必要があります。トグルをオフにすると、その値はクリアされます。

### カスタムサービスの追加

Cloud Broker がネイティブにサポートしていないプラットフォームや、API 認証情報を共有したくない場合のユーザー削除を管理するには、カスタムサービスを使用します。

すべての外部プラットフォームが自動ユーザー削除用の API を提供しているわけではありません。そのようなプラットフォームでは、外部サービスからユーザーをエクスポートし、そのファイルを External Services にアップロードして参照用に使用します。カスタムサービスを追加するには、次の手順を実行します。

1. サイドバーで **External Services** を選択します。
2. **Add Service** を選択します。
3. **Available services** で **Custom** を選択します。

    ページには **Users** タブのみが表示されます。

4. **Description** を入力します。必須です。
5. **Upload File** を選択します。
6. 外部サービスのユーザーを一覧にした `.csv` ファイルを選択します。

    各ユーザーのメールアドレスを含めます。ファイル選択ダイアログで選択できるのは `.csv` ファイルのみです。

7. **Save** を選択します。

Active Directory からユーザーが削除されると、External Services はアップロードされたファイルにそのユーザーが存在するかを確認します。一致が見つかった場合、そのサービスからユーザーを手動で削除する必要があることを通知します。

:::note
カスタムサービスは、**Service Configuration** の **Identity Alignment Notifications** タブで設定されたデフォルトの通知設定を使用します。カスタムサービスではサービスごとのメール上書きは利用できません。
:::

カスタムサービスは次の場合に使用します：

- 外部プラットフォームがユーザー管理用の API を提供していない場合。
- サービスが OpenLM Cloud Broker でサポートされていない場合。
- OpenLM Platform に認証情報を共有したくない場合。

### サービスの編集

サービスを編集するには、次の手順を実行します。

1. サービスの行にポインターを合わせます。
2. **Edit Rule** アイコンを選択します。
3. **Edit External Service** ページで、設定を変更します。
   - 通常サービスの場合は、**Actions configuration** タブで削除シナリオとカスタムメールの上書きを変更します。**Account** タブは読み取り専用です。
   - カスタムサービスの場合は、**Users** タブで **Description** を変更するか、新しい `.csv` ファイルをアップロードします。このタブには、保存されているファイルの **File name** と **Upload date** も表示されます。ファイル名を選択すると、その内容を確認できます。
4. **Save** を選択します。

### サービスの削除

サービスを削除するには、次の手順を実行します。

1. 削除するサービスのチェックボックスをオンにします。少なくとも 1 つ選択するまで、**Delete** は使用できません。
2. **Delete** を選択し、ダイアログで確定します。

成功メッセージは表示されません。サービスは一覧から消え、何かが失敗した場合はエラーメッセージが表示されます。

## サービスの種類

External Services は 2 種類のサービスをサポートしています。

### 通常サービス

通常サービスは Cloud Broker を通じて外部プラットフォームに接続します。Active Directory からユーザーが削除されると、External Services は Cloud Broker に外部サービスからユーザーを自動的に削除するよう指示します。

Cloud Broker で設定済みの任意のサービスを追加できます：

- Autodesk Cloud
- Cloudflare
- GitLab
- Monday
- Office 365

### カスタムサービス

カスタムサービスでは、手動でアップロードしたユーザーリスト（`.csv` エクスポート）が必要です。External Services は外部プラットフォームに直接接続しません。代わりに、削除されたユーザーがアップロードされたファイルに存在するかを確認し、手動削除の通知を送信します。

## 削除シナリオ

通常サービスを追加する際に、以下の削除シナリオから 1 つを選択します。サービス一覧の **Option** 列には、選択したシナリオが表示されます。次の表に、シナリオを示します。

| シナリオ | **Option** 列 | 動作 |
|----------|---------------|------|
| **Delete user without additional notification. If the user can't be removed at all, it will be marked as removed.** | **Delete Only** | Cloud Broker が外部サービスからユーザーを削除する。削除できない場合、ユーザーは「removed」としてマークされる。通知は送信されない。外部サービスが論理削除に対応している場合、ユーザーはその方法で削除され、削除されたユーザーの履歴データが保持される。対応していない場合、ユーザーは完全に削除される。 |
| **Delete user and notify** | **Delete And Notify** | Cloud Broker がユーザーを削除し、External Services が削除確認を送信する。既定では、通知はデフォルトのメールとチケットシステムのメールに送られる。このサービスで別のアドレスを使うには、**Custom email** または **Custom ticketing system** をオンにする。 |
| **Don't delete, just notify that user should be deleted.** | **Notify Only** | External Services が通知のみ送信する。自動削除は行わない。手動で確認・削除したい場合に使用する。新しいサービスは、このシナリオが選択された状態で始まる。 |

## エラー処理

Cloud Broker が外部サービスへの接続に失敗した場合、または削除処理中にエラーが発生した場合：

- **Delete And Notify** に設定されたサービスでは、External Services は削除アクションが失敗したことを示すメール通知を送信します。**Delete Only** に設定されたサービスでは、削除が失敗しても通知は送信されません。
- 通知には、問題の診断に役立つ Cloud Broker のレスポンス詳細が含まれます。

## 例：退職する従業員のオフボーディング

従業員が組織を離れる際に、すべての外部プラットフォームからアクセスを削除する必要があります。

**シナリオ**: 山田太郎さんが退職します。Monday、GitLab、およびカスタム HR プラットフォームにアカウントがあります。

1. 管理者が Active Directory から山田太郎さんを削除する。
2. DSS が同期サイクルを実行し、削除を検出する。
3. External Services がイベントを受信し、設定済みのサービスを確認する。
4. Monday と GitLab（**Delete user and notify** に設定）：Cloud Broker が両方のサービスから山田太郎さんを削除する。管理者にメールで確認通知が届く。
5. カスタム HR プラットフォーム：管理者に手動削除の通知が届く。

External Services がなければ、管理者は各外部プラットフォームに個別にサインインし、手動でユーザーを削除する必要があります。

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

次の表に、症状、考えられる原因、対処方法を示します。

| 症状 | 考えられる原因 | 対処方法 |
|------|---------------|----------|
| **External Services** がサイドバーに表示されない | Identity Alignment 製品が有効化されていない、**Admin** ロールがない、またはデプロイがオンプレミスである | [OpenLM Products](https://www.openlm.com/documentation/ja/cloud/openlm-administration/products/) で Directory Sync を有効化し、OpenLM ライセンスが Identity Alignment を対象にしていることを確認する（Identity Alignment は自動的に有効化される）。アカウント管理者にロールの割り当てを依頼する。オンプレミスのデプロイにはこのページがない。 |
| 通常サービスからユーザーが削除されない | Cloud Broker が未設定またはアクセス不可 | Cloud Broker で有効な認証情報でサービスが設定されていることを確認する。 |
| 削除イベントが受信されない | DSS が削除を検出していない、または Identity Alignment 製品が有効化されていない | DSS が有効化され、同期サイクルが [Sync History](https://www.openlm.com/documentation/ja/cloud/users/directory-sync/index#sync-history) で完了していることを確認する。DSA がインストールされ Active Directory に接続されていることを確認する。Directory Sync は、OpenLM Products で Identity Alignment 製品が有効な間のみ、ユーザー削除イベントを送信する。 |
| 通知が届かない | メール設定が未構成 | **Service Configuration** の **Identity Alignment Notifications** タブで、デフォルトの通知メールを確認する。 |
| カスタムサービスでユーザーが一致しない | アップロードされたファイルが古い、またはユーザーのメールアドレスが記載されていない | 外部サービスから最新のユーザーデータを含む更新ファイルをアップロードする。 |
| サービスリストにサービスが表示されない | Cloud Broker でサービスが未設定 | 先に Cloud Broker でサービスを追加し、その後 External Services で追加する。 |
| 削除失敗メールが届いた | Cloud Broker 接続エラー | メール通知のエラー詳細を確認する。Cloud Broker のログを確認し、サービスの認証情報を検証する。 |

## FAQ

<details>
<summary>External Services に関するよくある質問</summary>

**External Services は外部サービスでユーザーを作成・更新しますか？**
いいえ。External Services はユーザーの削除のみを行います。外部プラットフォームでのユーザーアカウントの作成や更新は行いません。

**なぜ削除のみで完全な同期ではないのですか？**
お客様からのフィードバックにより、外部プラットフォームでの自動ユーザー作成はライセンスコストの増加につながる可能性があることが判明しました。従業員が組織を離れる際のユーザー削除が、意図しないアカウント作成のリスクなく明確なコスト削減を実現する主要なユースケースです。

**External Services は社内ディレクトリからユーザーを削除しますか？**
いいえ。External Services は Active Directory で既に発生した削除に反応します。ディレクトリ自体からではなく、外部サービスからユーザーを削除します。

**Cloud Broker なしで External Services を使用できますか？**
通常サービスの場合はできません。Cloud Broker が外部プラットフォームからの実際のユーザー削除を処理します。カスタムサービスの場合は、External Services が通知のみを送信するため、Cloud Broker は不要です。

**削除中に Cloud Broker が失敗した場合はどうなりますか？**
**Delete And Notify** に設定されたサービスでは、External Services が削除アクションの実行に失敗したことを示すメール通知が届きます。通知には Cloud Broker のレスポンスからのエラー詳細が含まれます。**Delete Only** に設定されたサービスでは、通知は送信されません。

**サポートリストにないサービスを追加できますか？**
はい。カスタムサービスタイプを使用し、ユーザーリストを含む `.csv` ファイルをアップロードします。手動削除の通知が届きます。

**カスタムサービスで通知メールを上書きできますか？**
いいえ。カスタムサービスは、**Service Configuration** の **Identity Alignment Notifications** タブで設定されたデフォルトの通知設定を使用します。サービスごとのメール上書きは通常サービスのみで利用できます。

**External Services にはどのような依存関係が必要ですか？**
External Services には DSS（Directory Sync Service）の有効化と DSA（Directory Synchronization Agent）のインストールが必要です。通常サービスの場合は、Cloud Broker が対象サービスの認証情報で設定されている必要があります。Identity Alignment 製品は、Directory Sync が有効になった後、OpenLM ライセンスが Identity Alignment を対象にしている場合に自動的に有効化されます。

**DSS の同期はどのくらいの頻度で実行されますか？**
DSS の同期頻度は External Services ではなく、[Directory Sync](https://www.openlm.com/documentation/ja/cloud/users/directory-sync/index#synchronizations) の **Synchronizations** ページで同期ごとに構成されます。現在のスケジュールについては同期定義を確認してください。
</details>