Class SSOCredentials
The credentials used if you want to authenticate a Customer via SSO
Properties
| NAME | TYPE | DESCRIPTION |
|---|---|---|
| PhoneKey | System.String | REQUIRED. The unique id for the phone. A GUID created by the app vendor at first time use and stored in long term storage on the device which is intended to be unique to the device and application. Limit of 100 characters. Printable characters only. |
| FIIdentifier | System.String | REQUIRED. A unique string value identifying the Financial Institution's RDA merchant in the EPS system (may be the same as Company, but stored in a different location). By default, this Value is generated and provided by EPS during integration. |
| Hash | System.String | REQUIRED. A unique string value. Hashed value (either SHA256 or SHA512) used for comparison. The string values must be concatenated in this order: HomeBankingId + Timestamp + FIIdentifier + SharedSecret + SaltValue. Note that the Timestamp used for this hash should be in the format M/d/yyyy h:mm:ss tt. (e.g. 6/17/2019 7:20:40 PM). |
| HomeBankingId | System.String | A string value with a unique identifier for the customer. It is required for all customers boarded with the RDA Web Service and most often corresponds to the customer's unique identifier in the Financial Institution's system. Max length is 50 characters. |
| SaltValue | System.String | REQUIRED. A randomly generated string of text by the application vendor, also to be used in the hash calculation to add additional randomness to the hash. |
| Timestamp | System.DateTime | REQUIRED. Current Date time of the SSO authentication and must be within 10 minutes of the EPS server time. Required to be in the format M/d/yyyy h:mm:ss tt for non-json requests: (e.g., 6/17/2019 7:20:40 PM). Required to be in the format /Date(xxxxxxxxxx-yyy)/ for json requests: (e.g., /Date(1560860654524-300)/) |
Examples
{
"__type":"SSOCredentials:#JackHenry.Eps.Mobile.RDA",
"HomeBankingId":"String Content",
"FIIdentifier":"String Content",
"Timestamp":/Date(1560799240498-300)/, the number of milliseconds since January 1, 1970 00:00:00 UTC appended with the servers timezone offset (e.g. -300)
"SaltValue":"String Content",
"Hash":"String Content",
}
Methods
Validate(IValidatorContext)
Declaration
public override void Validate(IValidatorContext context)
Parameters
| TYPE | NAME | DESCRIPTION |
|---|---|---|
| JHA.EPS.SharedService.Common.Validator.IValidatorContext | context |
Exceptions
| TYPE | DESCRIPTION |
|---|---|
| JHA.EPS.SharedService.Common.Validator.ValidationResult | HomeBankingId cannot be null |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | HomeBankingId must be between 1 and 50 characters |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | HomeBankingId must contain visible characters |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | HomeBankingId must contain visible characters |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | FIIdentifier cannot be null |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | FIIdentifier must be between 1 and 30 characters |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | FIIdentifier must contain visible characters |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | SaltValue cannot be null |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | SaltValue must be between 1 and 100 characters |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | SaltValue must contain visible characters |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | Hash cannot be null |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | Hash must be between 4 and 50 characters |
| JHA.EPS.SharedService.Common.Validator.ValidationResult | Hash must contain visible characters |