Add OATH User Account

WCF

Add User

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 otpPin,
                               string deviceId, 
                               bool   addDeviceOnly,
                               short notificationMethod);

WCF parameter	data type	description

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.
email	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
OtpType	short	OTP Type
OtpLength	short	The length of the desired OTP.
OtpWindow	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.
Otppin	short	The pin associated with device for OTP Type that require a PIN
deviceId	short	The serial number to be assigned to the newly created device associated with this account. It is recommended you pass an empty string value. The actual devicedId will be returned in the response.
onlyAddDevice	bool	false = add user and add the device device, true = just add user device to this account
notificationMethod	short	send welcome message to user. 0 = none, 1=email, 2=sms

Sample WCF C# Method

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 
                               "",        // no pin for time based otp 
                               false,     // add user and this device 
                               0);

Sample WCF C# Repsonse

 if (resp.ErrorCode != 0)  {      
       message.Text = resp.ErrorMsg;
       return false;
 }

REST

REST parameter	data type	description

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
email	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
deviceType	short	Device Type
OtpType	short	OTP Type
OtpLength	short	The length of the desired OTP.
windowSize	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.
OtpPin	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.
notificationMethod	short	send welcome message to user. 0 = none, 1=email, 2=sms

Sample REST/Json Method

 {
  "username": "Mandy",
  "spAccountLoginName": "accountLogin",
  "spAccountLoginKey": "accountKey",
  "type": "add_oath_user",
  "firstName": "Mandy5",
  "lastName": "Mandy5",
  "email": "Mandy5",
  "pw": "Mandy5",
  "mobile": "407-555-1212",
  "deviceType  ": 2,         // desktop token
  "OtpType":   1,            // time based otp 
  "OtpLength":   6,          // otp digits
  "windowSize":   30,        // time window in seconds 
  "OtpPin":   "",            // no pin for time based otp 
  "psn": "OATH_12345678", 
  "secretKeyHex": "3132333435363738383031323334353637383830", 
  "notificationMethod": 0 
}

Sample REST/Json Response

 {  
  "errorCode": 0,
  "errorMessage": "OK",
  "type": "add_oath_user"
}