Skip to main content
Version: 2023 R3

REST Web Service

The source allows you to retrieve data from the REST Web Service.

RestWebService.png

1. ID

The data source identifier (if the value is smaller than "0", the source has not been saved in the database yet).

2. Name

Name of the data source entered by the user.

3. Connection type

The field allows you to specify a connection type. You can choose from: MSSQL Database, Oracle Database, Exchange Server, OneDrive, SharePoint Site Collection, REST Web Service, and SOAP Web Service.

4. Description

Description of the data source entered by the user.

5. Environment

Defines the behavior of the data source in particular environments. The Common tab sets the default parameters that are to be used across all three environments (DEV/TEST/PROD). The tabs dedicated to the individual environments can be used to enter custom parameters. In such case, it is necessary to check the Break inheritance checkbox (this will override the settings specified in the Common tab) and then enter the desired connection settings.

6. Authentication type

The field allows you to select the authentication method from a dropdown list. Whether the configuration fields are required depends on the method selected. The available methods: – Anonymous – none; – Custom – it is possible to provide any configuration field. This type of authentication can be used only in SDK plugins; – Microsoft Dynamics 365 – username, password, client ID, and user system instance URL; – Microsoft Dynamics 365 on-Premises – username, password, client ID, authenticator key provider URL, client ID, client secret; – Microsoft Graph – tenant ID or authenticator key provider URL, application ID, application secret; – NT – domain user name and password; – OAuth2 User → API and OAuth2 App → API – authentication method defined in the Authentication field; – Salesforce – username, password (actual password combined with the so-called "user secret"), client id, client secret, system instance URL, and authenticator key provider URL; – WEBCON BPS – username, client ID, client secret, system instance URL.

7. Authentication

The field allows you to select authentication configuration.

8. Connect as

Allows you to choose the method for connecting with the service.

9. User

A REST Web Service user. For the Windows authentication the field is grayed out.

10. Password

A REST Web Service user's password. For the Windows authentication the field is grayed out.

11. Authentication service URL

The URL address of the authentication service.

12. Client ID

The ID number of the client.

13. Client Secret

The number of the client secret.

14. Base service instance URL

The URL address of the base service instance.

15. Don't validate https certificate

When a web service is hosted through the HTTPS protocol, it should have a valid certificate

  • Certificate is trusted – the action checks the validity of the certificate in the certificate center;
  • Certificate is issued locally – if the certificate had NOT been added to the trusted certificates on the server (unless the option to ignore validation is enabled), the action will consider the certificate invalid.

Ignoring certificate validation is not recommended.

Possible error message:

"Could not establish trust relationship for the SSL/TLS secure channel. ---> System.Security.Authentication.AuthenticationException: The remote certificate is invalid according to the validation procedure."

info

To learn more about connecting to web services through the HTTPS protocol, read the ARTICLE available in the WEBCON Developer website.