Configure Web API Manually - Intergraph Smart Materials - Version 2017 R2 (2.2) - Installation & Upgrade - Hexagon

To configure Web API manually, follow these steps:

1. Navigate to IIS. Select an existing website, and right click on the website name.

2. Click Add Application. In the Alias, type the Application name, and then select the folder where the Web API is installed in the Physical Path.

   You should select the physical path to a location, where the API is installed , for example (C:\Program Files\INTERGRAPH\Smart Materials Web API 2.2\Web\API)

3. Select the Application pool, and then click OK.

   Application gets created in the selected website.

   If you want to create a new Application pool, follow these steps:

   • Navigate to IIS and click Application Pools. In the right navigation, Actions> click Add Application Pool.

   • Provide the Application pool name, and then click OK.

   • To add this newly created Application Pool in the application, in the left navigation, right click the Application>Manage Application>Advanced Settings.

   • Select the Application pool which you have created and then click OK.

   • You must provide a full control access to the created application pool over the folder where the API is installed (for eg; C:\Program Files\INTERGRAPH\Smart Materials Web API 2.2\Web\API)

Add https protocol

1. By default, http protocol is supported, to add https protocol, right click the recently created Application Name in the IIS.

2. Click Manage application> Advanced settings. In Behavior>Enabled Protocols, add https also, and then click OK.

3. Right click the created application website, and then select Edit Bindings.

4. To add a new Site Binding, click Add. Select https in Type and required SSL certificate , type the Port number, and then click OK.

Configure Web api

1. Navigate to the web config api file (<installed path>\Web\API\webconfig).

2. In the Security>Element oauth> issuer, update the value to the actual Identity Server/Authorization Server (SAM).

3. Navigate to Configure web.config, and perform all the steps as mentioned Configure web.config

Register API in the Identity Server/Authorization Server

1. Navigate to your Identity/Authorization server. Create or register the created application, and save the changes.

   Here we are taking the example of SAM as Identity/Authorization Server. Follow these steps to register the application in SAM.

   1. Login SAM, to register the application, click +icon, and type the Application name (created in IIS).

   2. Type the description url (http(s)://{{hostname}}/{{Applicationname}}/SMAT/V1/description ), and then click Next.

   3. Copy the Secret and Resource ID, and then click OK.

   4. In the web config file, in section, Services with prefix/VI , update/paste the Resource ID and Secret .