外部サービス（External Services）

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

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

External Services の以前の名前

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

はじめに

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

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

Identity Alignment には、OpenLM 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 と 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. カスタムサービスの場合、アップロードされたユーザーリストにユーザーが存在するかを確認し、手動削除の通知を送信する。

注意

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

ヒント

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

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 のデフォルトの通知アドレス。

注意

このタブは 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 はアップロードされたファイルにそのユーザーが存在するかを確認します。一致が見つかった場合、そのサービスからユーザーを手動で削除する必要があることを通知します。

注意

カスタムサービスは、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 で Directory Sync を有効化し、OpenLM ライセンスが Identity Alignment を対象にしていることを確認する（Identity Alignment は自動的に有効化される）。アカウント管理者にロールの割り当てを依頼する。オンプレミスのデプロイにはこのページがない。
通常サービスからユーザーが削除されない	Cloud Broker が未設定またはアクセス不可	Cloud Broker で有効な認証情報でサービスが設定されていることを確認する。
削除イベントが受信されない	DSS が削除を検出していない、または Identity Alignment 製品が有効化されていない	DSS が有効化され、同期サイクルが 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

External Services に関するよくある質問

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 の Synchronizations ページで同期ごとに構成されます。現在のスケジュールについては同期定義を確認してください。