Salesforce アラート統合

Salesforce アラート連携を使用して、Salesforce 組織を OpenLM Cloud Broker に接続します。Salesforce を接続すると、Cloud Broker が利用シグナルを収集し、OpenLM Platform がライセンスシートの監視、重要イベントのアラート発報、Subscription Optimizer などの下流サービスへのフィードを行えるようにします。

このガイドを完了すると、OpenLM Platform が Connected App を介して Salesforce 組織を認証し、Cloud Broker での接続が成功し、Salesforce のデータが OpenLM Alerts とレポートで利用可能になります。

はじめに

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

• Salesforce Alerts Integration が OpenLM Products で有効化されている。
• OpenLM Platform で Cloud Broker が有効になっている。連携は Cloud Broker を介して Salesforce のデータを認証し、取得します。
• 管理者として Salesforce にサインインできる。
• 管理者として OpenLM Platform にサインインできる。

連携を開くには、OpenLM Platform のヘッダーにある Navigation（グリッドアイコン）、Integrations、Salesforce Alerts Integration の順に選択します。

関連するタスクについては、Cloud Broker、OpenLM Alerts、Subscription Optimizer を参照してください。

連携の仕組み

OpenLM Platform は Salesforce Connected App と OAuth のユーザー名/パスワードフローを使用して認証します。Salesforce 側で Connected App を登録し、Consumer Key と Consumer Secret を取得した後、Salesforce のユーザー名とパスワードと一緒に OpenLM Cloud Broker に入力します。Cloud Broker はその認証情報を使用してデータを取得し、OpenLM Alerts と下流サービスに公開します。

必要なコンポーネント

Salesforce を OpenLM Platform に接続するには、次のコンポーネントが必要です。

• Cloud Broker が有効化され、Salesforce Alerts Integration が有効化された OpenLM Platform アカウント。
• Connected App を作成および管理できる Salesforce 組織。初回構成にはサンドボックスを使用してください。
• OpenID Connect 設定をオンにし、Connected App の作成、アクセスポリシーの調整を行える Salesforce 管理者権限。

サンドボックスのログインホスト

本連携は、Salesforce のログインホスト https://login.salesforce.com を前提としています。https://test.salesforce.com を使用するサンドボックスでは追加構成が必要です。サンドボックスを接続する前に、対象ホストを OpenLM サポートに確認してください。

連携を構成する

このセクションのタスクは順番に実行します。OpenLM 側で Connected App の認証情報が必要となるため、Salesforce 側の作業を先に行います。

Salesforce で OpenID Connect 設定をオンにする

Salesforce で OpenID Connect 設定をオンにするには、次の手順を実行します。

1. Salesforce で Setup を開き、Identity、OAuth and OpenID Connect Settings の順に選択します。
2. Allow OAuth Username-Password Flows をオンにします。
3. Allow OAuth User-Agent Flows をオンにします。
4. 変更を保存します。

Connected App を作成する

Connected App を作成するには、次の手順を実行します。

1. Salesforce Setup で Apps、App Manager の順に開きます。
2. New Connected App を選択します。
3. 基本情報を入力します。
   • Connected App Name: OpenLM Cloud Broker などの分かりやすい名称。
   • API Name: Connected App Name から Salesforce が自動入力します。必要に応じて調整してください。
   • Contact Email: 管理者のメールアドレス。
4. API (Enable OAuth Settings) セクションで以下を実行します。
   • Enable OAuth Settings を選択します。
   • Callback URL に http://localhost を設定します。Salesforce はこのフローで http スキームを許容します。
   • OAuth スコープを追加します。Issue JSON Web Token (JWT) based access tokens を除く、利用可能なすべてのスコープを選択します。
5. Connected App を保存します。

Salesforce が Connected App をプロビジョニングすると、Manage Connected Apps ページで Consumer Key と Consumer Secret が利用可能になります。これらの値は後の手順で OpenLM にコピーします。

アクセスポリシーを調整する

Connected App でアクセスポリシーを調整するまで、Salesforce は OAuth フローをデフォルトでブロックします。調整するには、次の手順を実行します。

1. Setup、Apps、Manage Connected Apps の順に開きます。
2. 作成した Connected App を選択します。
3. Permitted Users を All users may self-authorize に設定します。
4. IP Relaxation を Relax IP restrictions に設定します。
5. 保存します。

警告

All users may self-authorize は概念実証で最も簡単な設定です。本番運用では Connected App を特定のパーミッションセットまたはプロファイルに限定し、IP 制限の緩和をセキュリティチームと確認してください。

OpenLM Platform で Salesforce Alerts Integration を有効化する

OpenLM Platform で Salesforce Alerts Integration を有効化するには、次の手順を実行します。

1. OpenLM Platform にサインインします。
2. Navigation メニューから Products を開きます。
3. Salesforce Alerts Integration カードを探します。
4. Activate を選択します。

Cloud Broker で Salesforce を接続する

Cloud Broker で Salesforce を接続するには、次の手順を実行します。

1. Navigation メニューから Cloud Broker を開きます。
2. サポートされているサービス一覧から Salesforce を選択します。
3. Active が選択されていない場合は、選択します。
4. 先ほど取得した認証情報を入力します。

項目	入力する値
Consumer Key	Salesforce Connected App の Consumer Key。
Consumer Secret	Salesforce Connected App の Consumer Secret。
Username	Cloud Broker が認証に使用する Salesforce ユーザー名。
Password	そのユーザーのパスワード。

5. 構成を保存します。

最初の Salesforce 同期を実行する

最初の Salesforce 同期を実行するには、次の手順を実行します。

1. Cloud Broker で Commands を開きます。
2. Salesforce 同期コマンドを実行します。
3. コマンドが成功状態になったことを確認します。

コマンドが失敗する場合は、トラブルシューティング を参照してください。

連携を検証する

最初の同期が成功したら、OpenLM Platform へのデータ流入を検証します。

1. Cloud Broker で、最終成功同期のタイムスタンプが更新されることを確認します。
2. OpenLM Alerts で Salesforce データを対象とするアラートルールを定義し、条件成立時にルールが発動することを確認します。
3. お使いのレポートツールで、Salesforce 由来の行が表示されることを確認します。

トラブルシューティング

次の表に、症状、想定される原因、対処を示します。

症状	想定される原因	対処
Cloud Broker が認証エラーを報告する。	Consumer Key、Consumer Secret、ユーザー名、パスワードのいずれかが正しくない、または Connected App が有効になっていない。	4 つの項目を 1 文字ずつ確認します。Connected App が保存され、アクセスポリシーが設定されていることを確認します。
Cloud Broker は接続できるがデータが返らない。	Salesforce ユーザーが対象オブジェクトへのアクセス権を持っていない。	適切な Salesforce プロファイルまたはパーミッションセットをユーザーに割り当てます。
Connected App が IP ブロックでリクエストを拒否する。	IP Relaxation が Enforce IP restrictions に設定されている。	Connected App の IP Relaxation を Relax IP restrictions に設定します。
Connected App がセルフ承認エラーでリクエストを拒否する。	Permitted Users が Admin approved users are pre-authorized で、ユーザーが事前承認されていない。	Permitted Users を All users may self-authorize に設定するか、対象プロファイルを事前承認します。
Salesforce ユーザーがサンドボックスにあり接続が失敗する。	連携は login.salesforce.com を前提としている。	サンドボックスを接続する前に、対象ホストを OpenLM サポートに確認してください。

既知の制限事項

次の制限事項に留意してください。

• 本連携は本番 Salesforce のログインホストを前提としています。サンドボックス対応には OpenLM サポートの確認が必要です。
• Cloud Broker UI では項目名として Client ID および Client Secret が表示される箇所があります。これらは Salesforce 側の Consumer Key および Consumer Secret に対応します。同義として扱ってください。
• Cloud Broker の Password 欄は、パスワードを入力するときにマスキングされません。構成中は画面共有を避けてください。

関連項目

詳細は、次のページを参照してください。

• Cloud Broker
• OpenLM Alerts
• Subscription Optimizer
• Products