1. Data Management
  2. Connectivity Studio
  3. Design
  4. Set up web services
  5. Set up inbound web services

Set up inbound web service - IIS application

If you want to run the inbound web service application on premise, use the predefined IIS application.
You can use the IIS application to route external HTTP requests to the applicable inbound web service actions in D365 FO.
Prerequisites:
Before you set up the IIS application, make sure:
  • The on-premises server has Internet Information Services installed and .NET 4.6 (or higher).
  • A D365 FO environment with Connectivity studio installed runs in the cloud or on premises.


Application Consultant Application Consultant Start Start Set up inbound web service website Set up inbound web service website Set up the web site that is required to run the IIS application. Procedure 1. On the on-premise server, start the Internet Information Services (IIS) Manager. 2. Add a website. 3. Enter the Site name. 4. You can enter the physical path as desired. Example: c:\inetpub\wwwroot\BisConnectivity. Enter the Physical path. Note: Make sure the physical path exists. 5. Fill in the other settings as desired and click OK. 6. Check if the Application pool uses .NET 4.6 (or higher). Install deployment tool Install deployment tool Run the IIS application deployment tool to install the web site. Before you can run the deployment tool, download the BisMessageHttpActionD365FO.zip file. Procedure 1. Extract the downloaded BisMessageHttpActionD365FO.zip file to a temporary location. Note: Do not extract it to the physical path of the created web site. 2. Edit the BisConnectivityServices.SetParameters.xml and replace BisConnectivity with the web site name. 3. Before installing the web site, run a test installation Run the Command Prompt as administrator. Note: This command does not change the web site, but gives an impression of the installation results. 4. In the Command Prompt, navigate to the location to which you extracted the BisMessageHttpActionD365FO.zip file. 5. Run this command: BisConnectivityServices.deploy.cmd /T 6. If the simulation results are satisfactory, you can actually install the web site. In the Command Prompt, run this command: BisConnectivityServices.deploy.cmd /Y Note: As a result, the files are installed in the physical path of the web site. Also, the required permissions are set. 7. Open the physical path of the web site. 8. Open the web site authentication and enable these authentications: ASP.NET Impersonation and Windows Authentication. Notes You can rerun the deployment tool. If you do so:Make sure that the web site name, as defined in the BisConnectivityServices.SetParameters.xml file is the same as the current web site name.The deployment tool overwrites any changes you made.The IIS application configuration is cleared. So, you must again configure the IIS application. Register Microsoft Entra ID application in D365 FO Register Microsoft Entra ID application in D365 FO To connect to D365 FO, you must register the Microsoft Entra ID application in D365 FO. Procedure 1. Go to System administration > Setup > Microsoft Entra ID applications. 2. Click New. 3. In the Client Id field, enter the 'Application (client) ID' of the Microsoft Entra ID app. 4. In the Name field, enter the 'Display name' of the Microsoft Entra ID app. 5. In the User ID field, enter or select a value. Note: Make sure, this user has sufficient rights. You can, for example, use a user with admin rights. 6. Close the page. Register application with Microsoft Entra ID Register application with Microsoft Entra ID Register a native web application in Microsoft Entra ID to access D365 FO. For more information, refer to Register an application with the Microsoft identity platform. For the web app, only OAuth 2.0 authentication is supported. So, on the registered app, as authentication, add a platform of type Mobile and desktop applications, and choose an option that supports OAuth2. Make sure the required API permissions to the Dynamics ERP API are granted for the Microsoft Entra ID application. For more information, refer to Permissions and consent in the Microsoft identity platform. Configure the IIS application Configure the IIS application Before you can use the web site to connect to D365 FO, configure the IIS application. Procedure 1. On the on-premise server, start the Internet Information Services (IIS) Manager. 2. Browse the web site and fill in the application settings. 3. URI: Enter the web address of the D365 FO environment, without trailing slash! 4. User name: Enter the user name that gives access to D365 FO. 5. Password: Enter the password for the D365 FO user. Note: You cannot type the password directly in Web.config because the system only uses encrypted passwords. 6. Company: Enter the default company. 7. Language: Enter the default language. 8. Microsoft Entra ID source URI: Enter the web address of the D365 FO environment, without trailing slash! 9. Microsoft Entra ID tenant: Enter the Microsoft Entra ID tenant like this: https://login.windows.net/[your tenant name] 10. Microsoft Entra ID client app: Enter the name of the native web application that you registered with Microsoft Entra ID. End End

Activities

Name Responsible Description

Set up inbound web service website

Application Consultant

 		Set up the web site that is required to run the IIS application.

Install deployment tool

Application Consultant

Run the IIS application deployment tool to install the web site.

Before you can run the deployment tool, download the BisMessageHttpActionD365FO.zip file.

Register Microsoft Entra ID application in D365 FO

Application Consultant

To connect to D365 FO, you must register the Microsoft Entra ID application in D365 FO.

Register application with Microsoft Entra ID

Application Consultant

Register a native web application in Microsoft Entra ID to access D365 FO. For more information, refer to Register an application with the Microsoft identity platform.

For the web app, only OAuth 2.0 authentication is supported. So, on the registered app, as authentication, add a platform of type Mobile and desktop applications, and choose an option that supports OAuth2.
Make sure the required API permissions to the Dynamics ERP API are granted for the Microsoft Entra ID application. For more information, refer to Permissions and consent in the Microsoft identity platform.

Configure the IIS application

Application Consultant

 		Before you can use the web site to connect to D365 FO, configure the IIS application.

Provide feedback