WCF
| Code Block | ||||
|---|---|---|---|---|
| ||||
AuthServerResponseEnrollUser EnrollUser(String authServerPartnerLoginName,
string authServerPartnerLoginPassword,
string firstName,
string lastName,
string loginName,
string loginPassword,
string email,
string mobilePhone,
short deviceType,
short otpType,
short otpLength,
short otpWindow,
string pinotpPin,
string deviceId,
bool addDeviceOnly,
short notificationMethod); |
...
| WCF parameter | data type | description |
|---|---|---|
| authServerPartnerLoginName | string | SurePassId account login name |
| authServerPartnerLoginPassword | string | SurePassId account login key |
| firstName | string | First name |
| lastName | string | Last name |
| loginName | string | User account login name |
| loginPassword | string | Users password. If omitted one will be generated. If using Active Directory on the server this parameter is ignored. |
| string | User email. Used for sending email notifications and temporary pass codes. | |
| mobilePhone | string | Users mobile phone Used for sending voice or sms messages |
| deviceType | short | Device Type |
| otpTypeOtpType | short | OTP Type |
| otpLengthOtpLength | short | The length of the desired OTP. |
| otpWindowOtpWindow | short | The sliding window for OTP validation. For event based OTP Type this is the number of values > than the event counter that will be accepted. For time based OTP Type this is the number of seconds that will elapse before the OTP will change. |
| pinOtppin | short | The pin associated with device for OTP Type that require a PIN |
| timeDrift | short | The number of allowable time drift increments to be used as part of the calculation. |
| psn | string | The device serial number for the device. If this field is not specified then a serial number will be generated by the system. For hardware devices such as FOBS this field is recommended since these devices usually come serialized. For soft devices such as mobile otp generators, it is recommended to not specify a serial number and let the system create one automatically. The generated serial number will be returned in the response. |
| secretKeyHex | string | The secret key (in hex format) for the device. If this field is not specified then a secure secret key will be generated by the system. For hardware devices such as FOBS this field is recommended since these devices usually come with predefined keys. For soft devices such as mobile otp generators, it is recommended to not specify a secret key and let the system create one automatically. |
| secretKeyHexBase64 | string | The secret key (Base64 format) for the device. If this field is not specified then a secure secret key will be generated by the system. For hardware devices such as FOBS this field is recommended since these devices usually come with predefined keys. For soft devices such as mobile otp generators, it is recommended to not specify a secret key and let the system create one automatically. |
| deviceId | short | The deviceId to assign to this newly created device associated with this account. It is recommended you pass an empty string value. |
| onlyAddDevice | bool | true false = add user and add the device device, falsetrue = just add user; device will need to be added to user account lateruser device to this account |
| notificationMethod | short | send welcome message to user. 0 = none, 1=email, 2=sms |
| Code Block | ||||
|---|---|---|---|---|
| ||||
AuthServerResponseEnrollUser resp = EnrollUser("accountLogin",
"accountKey",
"Mandy",
"Last",
"Mandy",
"M@5ndy58!",
Mandy5@myco.com,
"+1(407)555-1212,
2, // desktop token
1, // time based otp
6, // otp digits
30, // time window in seconds
"", // timewindow no pin for time based otp
false, // add user and this device
0); |
| Code Block | ||||
|---|---|---|---|---|
| ||||
if (resp.ErrorCode != 0) {
message.Text = resp.ErrorMsg;
return false;
} |
REST
| REST parameter | data type | description |
|---|---|---|
| spAccountLoginName | string | SurePassId account login name |
| spAccountLoginKey | string | SurePassId account login key |
| username | string | User account login name |
| type | string | add_oath_user |
| firstName | string | First name |
| lastName | string | Last name |
| string | User email. Used for sending email notifications nd temporary pass codes. | |
| pw | string | Users password. If omitted one will be generated. If using Active Directory on the server this parameter is ignored. |
| mobile | string | Users mobile phone Used for sending voice or sms messages |
| notificationMethod | short | send welcome message to user. 0 = none, 1=email, 2=sms |
...