OTPByHTTPGetValve
Note
Valve for delivering one-time passwords by HTTP GET.
Supports fallback URL's.
Properties
| Name | Description | Default value | Mandatory | Supports property expansion |
|---|---|---|---|---|
| generated_otp_name | Item property containing the generated otp. | generated_otp | No | No |
| recipient_param_name | Property containing the recipient mobile number. | mobile | No | Yes |
| userid_param_name | Property containing the username. | User-Name | No | Yes |
| url_list | Comma separated list of URLs to send to. Failover functionality. | Yes | No | |
| url_params | '&' separated list of parameters. Example: 'mobile=$$IDENTITY&otp=$$OTP' | No | No | |
| success_string | String to look for if the GET was successful. | 'OK' | No | No |
| wash_recipient_number | If the mobile number should be washed (i.e. removal of whitespaces, - and other non-number characters). | true | No | No |
| remove_leading_plus | If the leading + character should be removed from the mobile number. | false | No | No |
| recipient_prefix | If the mobile number should be prepended with a country prefix. (example: +46) | No | No | |
| dynamic_values | Dynamic template mapping values. Separated by pipe (|) Replaces key with value in url_params. Syntax: $$USERNAME={{item.givenName}}|$$SOME_OTHER_KEY={{item.somevalue}} See example below. |
No | Yes |
Example Configuration
{
"name": "OTPByHTTPGetValve",
"config": {
"generated_otp_name" : "generated_otp",
"recipient_param_name" : "{{item.othermobile}}",
"userid_param_name" : "{{request.username}}",
"url_list" : "https://www.messageservice.dd,https://www.messageservice.ff",
"url_params":"mobile=$$RECIPIENT&otp=$$OTP&user=$$USERNAME",
"success_string":"message_ok",
"wash_recipient_number" : "true",
"recipient_prefix" : "+46",
"dynamic_values" : "$$USERNAME={{item.givenName}}"
}
}
In the example above the value for attribute othermobile has been picked up earlier in the flow.
The value for userid_param_name has been picked up from the request. Most common values are {{request.User-Name}} for RADIUS and {{request.username}} for HTTP.
Information about values for url_list, url_params and success_string should be retrieved from the supplier of the message service.
Requirements
Item set must have at least one entry.