HTTP bearer authentication definitions
The HTTP interface is used to send and receive data and information from HTTP server. If the remote HTTP server requires bearer authentication, the required configuration for bearer authentication can be specified here.
File location
<WorkspaceDirectory>\DataFiles\xio.HTTP.BearerDefinitions.dat
Changes within this definition file are taking effect immediately. No server restart is required.
Note: The parameters 4 - 14 are only required if “Dynamic” or “DynamicWithRefreshToken” is selected as bearer method.
Parameter | Description | Scope | Unit | Mandatory / default value | |
|---|---|---|---|---|---|
| 1 | Name | It is the key that identifies the bearer definition. The name can freely be chosen but has to be unique. | string | None | mandatory |
| 2 | Bearer method | The method to use:
|
| None | Static |
| 3 | Bearer token or refresh URL | If static is used, the bearer token has to be defined here. If dynamic is selected, the HTTP server URL from which the bearer token can be retrieved must be defined here. | string | None | mandatory |
| 4 | Refresh method | The HTTP request method for retrieving the token. | POST, PUT, GET | None | POST |
| 5 | Refresh interval | The interval in seconds for refreshing the bearer token. | 1 – 65535 | seconds | 60 |
| 6 | Request resource | The resource that is used for requesting the bearer token. It has to match the name that is used in the HTTP resource definition. | Reference to HTTP resource definition | None | mandatory |
| 7 | Request parameters | A comma-separated list of parameters that are used to replace the placeholders within the request resource ({0}, {1}, ...). | string | None | empty |
| 8 | Response Resource | The resource that is used for extracting the token from the response. It has to match the name that is used in the HTTP resource definition. | Reference to HTTP resource definition | None | mandatory |
| 9 | Response parameters | A comma-separated list of parameters that are used to replace the placeholders within the request resource ({0}, {1}, ...). | string | None | empty |
| 10 | Authentication method | The authentication method (None, Basic or Digest) if required by the HTTP server. | None, Basic, Digest | None | None |
| 11 | Authentication user | Username for Basic or Digest HTTP authentication if required by the HTTP server. | string | None | empty |
| 12 | Authentication password | Password for Basic or Digest HTTP authentication if required by the HTTP server. If empty, no HTTP authentication is used. | string | None | empty |
| 13 | Additional HTTP headers | A list of additional HTTP headers which is included in each HTTP request, e.g. for authentication purposes. Additional headers must have the following form: "<key1>: <value1>\r\n<key2>: <value2>\r\n<key3>: <value3>..." | string | None | empty |
| 14 | Response Refresh Resource | If the bearer authentication uses a dynamic refresh token, the resource to extract this refresh token can be specified here. It has to match the name that is used in the HTTP resource definition. | string | None | empty |