Microsoft Dynamics 365 for Finance and Operations スポークの設定

Microsoft Azure でカスタム OAuth アプリケーションを作成して、ServiceNow インスタンスと Microsoft Dynamics 365 for Finance and Operations を統合し、ServiceNow 要求を認証します。

始める前に

• 統合ハブサブスクリプションを要求します。
• Microsoft Dynamics 365 for Finance and Operations スポークを有効にします。
• 必要なロール：admin。

注:

接続および資格情報エイリアスを設定した後、必ず Microsoft Dynamics 365 Finance and Operations アプリケーションから最新のメタデータを取得してください。

Microsoft Dynamics 365 for Finance and Operations を OAuth プロバイダーとして登録

Microsoft Dynamics 365 for Finance and Operations を OAuth プロバイダーとして登録して、ServiceNow インスタンスが OAuth 2.0 トークンを要求できるようにします。

始める前に

必要なロール：admin

手順

1. 移動先 すべて > システム OAuth > アプリケーションレジストリー.
2. Microsoft D365 Fin and Ops Spoke OAuth のレコードを開きます。
3. フォームに、これらの値を入力します。

   表 : 1. アプリケーションレジストリフォーム

   フィールド	説明
   名前	レコードを一意に識別する名前を入力します。たとえば、次のように入力します。 Microsoft Dynamics 365 for Finance and Operations OAuth
   クライアント ID	Microsoft Dynamics 365 for Finance and Operations 中に作成されたクライアント ID アプリケーション構成。
   クライアントシークレット	Microsoft Dynamics 365 for Finance and Operations アプリケーション構成中に作成されたクライアントシークレット
   認証 URL	OAuth 認証コードのエンドポイントです。次のように入力します：「https://login.microsoftonline.com/<AzureTenantID>/oauth2/v2.0/authorize」
   トークン URL	OAuth サーバートークンのエンドポイントです。次のように入力します：「https://login.microsoftonline.com/<AzureTenantID>/oauth2/v2.0/token」
   トークン失効 URL	OAuth サーバートークン失効エンドポイントです。
   リダイレクト URL	次の形式の OAuth コールバックエンドポイント： https://<instance>.service-now.com/oauth_redirect.do
   OAuth API スクリプト	要求と応答をカスタマイズするスクリプトです。[] を選択します。
   ロゴ URL	アプリケーションロゴとして使用するイメージを含む URL です。
   デフォルトの権限許可タイプ	トークンを確立するために使用される権限許可タイプです。[クライアント認証情報] を選択します。
   リフレッシュ トークンの有効期間	リフレッシュトークンが有効になる時間 (秒) デフォルトの時間は 8,640,000 秒です。
   PKCE が必要 (PKCE required)	パブリッククライアントが認証に PKCE を要求できるようにするオプション。 注: PKCE が有効になっている場合、[デフォルトの権限許可タイプ] として使用できるのは [認証コード] のみです。
   アプリケーション	このレコードを含むアプリケーションスコープです。
   アクセス可能	このレジストリにアクセスできるアプリケーションスコープです。
   有効	アプリケーションレジストリを積極的に使用するためのオプションです。
   相互認証を有効にします	トークンの要求と取り消しに相互認証を使用するオプション。このオプションでは、相互認証プロファイルを指定する必要があります。

4. フォームヘッダーを右クリックし、[保存] をクリックします。

Microsoft Dynamics 365 for Finance and Operations 用に接続レコードを作成

Microsoft Dynamics 365 for Finance and Operations 用に接続レコードを作成します。Microsoft Dynamics 365 for Finance and Operations スポークの接続および資格情報エイリアスは、これらの接続を使用して、Microsoft Dynamics 365 for Finance and Operations のアクションを実行します。

始める前に

必要なロール：admin

手順

1. 移動先 すべて > 接続 & 認証情報 > 接続および資格情報エイリアス.
2. MicrosoftD365FinAndOps のエイリアスレコードを開きます。
3. [接続] タブで、[新規] をクリックします。
4. フォームの各フィールドに入力します。

   表 : 2. 接続フォーム

   フィールド	説明
   名前	レコードを一意に識別する名前を入力します。例を次に示します。 Microsoft Dynamics 365 for Finance and Operations Connection
   認証情報	Microsoft Dynamics 365 for Finance and Operations 用に作成された認証情報レコード。 [MicrosoftD365FinAndOps.Credential] を検索して選択します。
   接続エイリアス	この接続に関連付けられているエイリアスレコード。「sn_ms_fin_ops_spk.MicrosoftD365FinAndOps」と入力します。
   接続 URL	Microsoft Dynamics 365 for Finance and Operations に接続するベース URL。次のように入力します：「https://<instance_ID>.cloudax.dynamics.com/」
   有効	接続レコードを積極的に使用にするオプションです。
   ドメイン	アクションを実行するドメインです。

5. [送信] をクリックします。

Microsoft Dynamics 365 Finance and Operations からメタデータを取得

Microsoft Dynamics 365 Finance and Operations からメタデータを取得し、ServiceNow インスタンスに保存します。ダイナミックアクションは、Microsoft Dynamics 365 Finance and Operations からの最新のメタデータを必要とします。

始める前に

必要なロール：admin。

手順

1. 移動先 すべて > Microsoft D365 FinOps メタデータ > Microsoft D365 FinOps メタデータのコンテンツ.
2. [メタデータを取得またはリフレッシュ] をクリックします。
3. Microsoft Dynamics 365 Finance and Operation アプリケーションから更新されたメタデータを取得するエイリアスを選択し、[OK] をクリックします。
   注:

   Microsoft Dynamics 365 Finance and Operations アプリケーションに変更がある場合は、必ず最新のメタデータを取得してください。

Microsoft Dynamics 365 for Finance and Operations スポーク用の双方向 Webhook の設定

ServiceNow コールバック URL で Microsoft Dynamics 365 for Finance and Operations スポークに登録するように Webhook を設定します。

始める前に

必要なロール：admin

手順

1. 移動先 すべて > Microsoft D365 FnO スポーク > FnO Webhook レジストリ.
2. [New] をクリックします。
3. フォームのフィールドに入力します。

   フィールド	説明
   名前	Webhook レジストリの一意の名前。例：Microsoft Dynamics 365 for Finance and Operations Webhook。
   説明	Webhook のオプションの説明。
   コールバック URL を生成	Microsoft Dynamics 365 Finance and Operations ポータルに Webhook を登録するために使用されるコールバック URL を生成するオプション。
   新しいシークレットを生成	Microsoft Dynamics 365 Finance and Operations Webhook の秘密キーを生成するオプション。 注: 新しいシークレットを生成する場合は、シークレットを生成した後にコールバック URL も生成します。 Azure ポータルにアプリを登録するためのコールバック URL を記録します。

Microsoft Dynamics 365 Finance and Operations スポーク用の双方向 Webhook のカスタマイズ

Microsoft Dynamics 365 Finance and Operations スポークの要件に応じて、Webhook ルーティングポリシーとサブフローを作成します。

始める前に

必要なロール：admin

手順

1. 移動先 すべて > フローデザイナー > デザイナー.
2. [サブフロー] をクリックします。
3. 必要なサブフローのコピーを作成します。
4. 要件に応じて必要なサブフローをカスタマイズし、公開します。
5. 移動先 Microsoft D365 FnO スポーク > FnO Webhook ルーティングポリシー.
6. [New] をクリックします。
7. フォームのフィールドに入力します。

   表 : 3. 意思決定フォーム

   フィールド	説明
   ラベル	ルーティングポリシーを識別する一意のラベルです。
   デフォルトの回答	この回答がデフォルトの回答かどうかを指定するオプションです。デフォルトの回答は、条件が満たされない場合に適用されます。 検索アイコンをクリックします。 ドキュメントリストから必要なサブフローを選択します。 注: [テーブル名] がフロー [sys_hub_flow] であることを確認します。
   条件	Microsoft Dynamics 365 Finance and Operations で必要なイベントが発生したときに満たされるべき条件です。サポートされているフィールドの詳細については、Microsoft Dynamics 365 for Finance and Operations スポークを参照してください。
   回答	指定された条件が満たされるとトリガーされるサブフローです。

8. [送信] をクリックします。
   注:

   これらのルーティングポリシーは意思決定テーブルに保存されます。ユーザーは、これらのテーブルのデータを直接更新または変更しないように注意してください。

タスクの結果

ルーティングポリシーとサブフローが作成されます。

Microsoft Dynamics 365 Finance and Operations スポーク用 Microsoft Azure ポータルへのアプリの登録

Microsoft Dynamics 365 Finance and Operations スポークを使用するために、Microsoft Azure ポータルに ServiceNow インスタンスを登録します。

始める前に

必要なロール：admin

手順

1. Azure ポータルにログインします。
2. [アプリの登録] に移動し、Webhook のアプリを登録します。
3. Azure ポータルを使用して Key Vault を作成します。
   詳細については、「Azure portal を使用してキーコンテナーを作成する」を参照してください。
4. [アクセスポリシー] に移動します。
5. アクセスポリシーを作成します。
6. [シークレット権限 (Secret permissions)] の [取得] を選択し、[次へ] をクリックします。
7. [プリンシパル (Principal)] タブで、先ほど登録したアプリの名前を検索し、[次へ] をクリックします。
8. [アプリケーション (オプション) (Application (optional))] タブで、[次へ] をクリックします。
9. [レビュー + 作成 (Review + create)] タブで、[作成] をクリックします。
10. [シークレット] セクションに移動します。
11. [+生成/インポート (+ Generate/Import)] をクリックします。
12. [シークレットの作成 (Create a secret)] ページで、名前を入力し、ServiceNow インスタンスから生成されたコールバック URL を指定します。
13. [作成] をクリックします。
14. Microsoft Dynamics 365 Finance and Operations ポータルにログインします。
15. 移動先 システム管理 > ビジネスイベント > ビジネスイベントカタログ.
16. [エンドポイント] タブに移動し、[新規] をクリックします。
17. 標準ビューからエンドポイントタイプとして [HTTPS] を選択し、[次へ] をクリックします。
18. フォームで、詳細を入力します。

    エンドポイント名	エンドポイントの名前。
    エンドポイントタイプ	エンドポイントのタイプ。
    Key Vault	アプリケーション用に作成された Key vault。
    Azure Active Directory アプリケーション ID	アプリケーションのオブジェクト ID。
    Azure アプリケーションシークレット	アプリケーション用に作成されたシークレット
    Key Vault の DNS 名	アプリケーションの Vault URI。
    Key Vault シークレット名	key Vault シークレットの名前。

19. [OK] をクリックします。
    注:

    アプリケーション用の Key Vault アクセスポリシーが作成されていることを確認します。アクセスポリシーでは、アプリケーションレジストリが Key Vault からシークレットにアクセスできる必要があります。
20. [ビジネスイベント (Business events)] タブに移動し、カテゴリを検索します。
    例：発注書 (PO)。
21. リストから必要なカテゴリを選択し、[アクティブ化] をクリックします。
22. [新しいビジネスイベントの構成 (Configure new business event)] セクションで、法人とエンドポイント名を選択します。
23. [OK] をクリックします。
    注:

    以下の API 権限がアプリケーションで有効になっていることを確認します。

    • Dynamics AX カスタムサービスへのアクセス
    • Dynamics AX データへのアクセス
    • 組織ユーザーとしての Dynamics AX オンラインへのアクセス

タスクの結果

Webhook が登録され、テストの準備が整いました。