目次

Search

  1. はじめに
  2. コネクタと接続
  3. 接続設定
  4. 接続プロパティ
  5. REST V2接続用のSwaggerファイルの生成

接続

接続

Microsoft Dynamics 365 Mass Ingestion接続のプロパティ

Microsoft Dynamics 365 Mass Ingestion接続のプロパティ

Microsoft Dynamics 365 Mass Ingestion接続をセットアップする際には、接続プロパティを設定する必要があります。
Microsoft Dynamics 365 Mass Ingestionの接続には、Microsoft Dynamics 365データにアクセスするために、Azure Active Directory(Azure AD)に登録されているネイティブアプリケーションが必要です。接続を設定する前に、Azure ADにアプリケーションを登録して、接続がMicrosoft Dynamics 365データにアクセスできるようにする必要があります。Azure ADにアプリケーションを登録する方法の詳細については、Microsoft documentationを参照してください。
Microsoft Dynamics 365 Mass Ingestion接続のプロパティは、接続に指定した認証方法によって異なります。接続を作成する際に、次の認証方法のいずれかを選択できます。
  • OAuth 2.0ユーザー名パスワードフロー
    : Microsoft Dynamics 365アカウントのログイン資格情報と、Azure ADに登録されているアプリケーションのクライアントIDを使用して、接続を認証します。
  • OAuth 2.0クライアントシークレットフロー
    : Azure ADに登録されているアプリケーションのクライアントIDとクライアントシークレットを使用して、接続を認証します。
  • OAuth 2.0 JWTベアラーフロー
    : X509公開鍵基盤(PKI)証明書とJSON Web Token(JWT)を使用して接続を認証します。クライアントシークレットやMicrosoft Dynamics 365アカウントのログイン資格情報などの機密情報を共有せずに、Microsoft Dynamics 365への安全なアクセスを取得するには、この認証方法を使用します。

OAuth 2.0ユーザー名パスワードフロー認証の接続プロパティ

次の表に、OAuth 2.0ユーザー名パスワードフロー認証を使用して設定されたMicrosoft Dynamics 365 Mass Ingestion接続の接続プロパティを示します。
接続プロパティ
説明
ランタイム環境
取り込みタスクを実行するランタイム環境の名前。
ランタイム環境としてSecure Agentを指定する必要があります。
Hosted Agentやサーバーレスランタイム環境で
アプリケーション取り込み
タスクを実行することはできません。
ユーザー名
Microsoft Dynamics 365アカウントのユーザー名。
パスワード
Microsoft Dynamics 365アカウントのパスワード。
クライアントID
Azure ADに登録されているアプリケーションのクライアントID。
リソースURL
Microsoft Dynamics 365組織のURL。
次の形式でリソースURLを入力する必要があります。
https://<Microsoft_Dynamics_365_org_name>.api.crm8.dynamics.com
OAuthトークンURL
Microsoft Dynamics 365組織のOAuth 2.0トークンエンドポイント。Azure ADに登録されているアプリケーションは、アクセストークン要求をこのエンドポイントに送信します。
このフィールドには、次の値を入力する必要があります。
https://login.windows.net/common/oauth2/token
OAuth 2.0ユーザー名パスワードフロー認証方法の詳細については、Microsoft Dynamics 365のドキュメントを参照してください。

OAuth 2.0クライアントシークレットフロー認証の接続プロパティ

次の表に、OAuth 2.0クライアントシークレットフロー認証を使用して設定されたMicrosoft Dynamics 365 Mass Ingestion接続の接続プロパティを示します。
接続プロパティ
説明
ランタイム環境
取り込みタスクを実行するランタイム環境の名前。
ランタイム環境としてSecure Agentを指定する必要があります。
Hosted Agentやサーバーレスランタイム環境で
アプリケーション取り込み
タスクを実行することはできません。
クライアントID
Azure ADに登録されているアプリケーションのクライアントID。
クライアントシークレット
Azure ADに登録されているアプリケーションのクライアントシークレット。
リソースURL
Microsoft Dynamics 365組織のURL。
次の形式でリソースURLを入力する必要があります。
https://<Microsoft_Dynamics_365_org_name>.api.crm8.dynamics.com
OAuthトークンURL
Microsoft Dynamics 365組織のOAuth 2.0トークンエンドポイント。Azure ADに登録されているアプリケーションは、アクセストークン要求をこのエンドポイントに送信します。
このフィールドには、次の値を入力する必要があります。
https://login.microsoftonline.com/<tentant_id>/oauth2/token
OAuth 2.0クライアントシークレットフロー認証方法の詳細については、Microsoft Dynamics 365のドキュメントを参照してください。

OAuth 2.0 JWTベアラーフロー認証の接続プロパティ

次の表に、OAuth 2.0 JWTベアラーフロー認証を使用して設定されたMicrosoft Dynamics 365 Mass Ingestion接続の接続プロパティを示します。
接続プロパティ
説明
ランタイム環境
取り込みタスクを実行するランタイム環境の名前。
ランタイム環境としてSecure Agentを指定する必要があります。
Hosted Agentやサーバーレスランタイム環境で
アプリケーション取り込み
タスクを実行することはできません。
クライアントID
Azure ADに登録されているアプリケーションのクライアントID。
証明書の署名
X509証明書のSHA-1フィンガープリントを表す16進値をエンコードするBase64URL文字列。
キーストアのパス
JSON Web Token(JWT)を検証してMicrosoft Dynamics 365との安全な接続を確立するために必要なX509証明書を含むキーストアファイルへの絶対パス。
キーストアファイルはJava KeyStore (JKS)形式である必要があります。
キーストアのパスワード
キーストアファイルのパスワード。
プライベートキーのエイリアス
JWTの署名に使用されるプライベートキーのエイリアス名。
プライベートキーのパスワード
プライベートキーのパスワード。
JWTのオーディエンス
Azure ADに登録されているアプリケーションが検証のためにJWTを送信する宛先となる、Microsoft Dynamics 365リソースサーバーのURL。
次の形式でアドレスを入力する必要があります。
https://login.microsoftonline.com/<tentant_id>/oauth2/token
リソースURL
Microsoft Dynamics 365組織のURL。
次の形式でリソースURLを入力する必要があります。
https://<Microsoft_Dynamics_365_org_name>.api.crm8.dynamics.com
OAuthトークンURL
Microsoft Dynamics 365組織のOAuth 2.0トークンエンドポイント。Azure ADに登録されているアプリケーションは、アクセストークン要求をこのエンドポイントに送信します。
このフィールドには、次の値を入力する必要があります。
https://login.microsoftonline.com/<tentant_id>/oauth2/token
OAuth 2.0クライアントシークレットフロー認証方法の詳細については、Microsoft Dynamics 365のドキュメントを参照してください。