Authenticate

Method

Authenticate(AuthenticateRequest)

This method is used to validate a user based on specific credentials, such as MFA, SSO or Username / Password.

Declaration

public AuthenticateResponse Authenticate(AuthenticateRequest request)

Parameters

TYPE	NAME	DESCRIPTION
AuthenticateRequest	request	CustomerCredentials SSOCredentials

Returns

TYPE	DESCRIPTION
AuthenticateResponse	AuthenticatedResponse

Example C#

public enum AuthenticationType
{
	User,
	SSO256,
	SSO512,
}

private AuthenticateResponse Authenticate(AuthenticationType authType)
{
	using (RDAWebServiceClient client = new RDAWebServiceClient())
	{
		switch (authType)
		{
			case AuthenticationType.User:
				return client.Authenticate(Authenticate_User());
			case AuthenticationType.SSO256:
			case AuthenticationType.SSO512:
				return client.Authenticate(Authenticate_SSO(authType));
		}
	}
	return null;
}
private AuthenticateRequest Authenticate_User()
{
	return new AuthenticateRequest()
	{
		Credentials = new CustomerCredentials()
		{
			UserName = "TestUser",
			Password = "TestPassword",
			PhoneKey = GetPhoneKey(),
			Company = "Company",
		},
		DeviceTracking = new DeviceTracking
		{
			AppBundleId = "com.testbank.deposit", //get from your app
			AppVersion = "1.0.1433", //get from your app
			DeviceModel = "iPhone 6s",  //get from system info
			DeviceSystemName = "iPhone OS", //get from system info
			DeviceSystemVersion = "9.3.2", //get from system info
			Vendor = "EPS"
		},
		RequestDate = DateTime.Now,
		RequestId = NewRequestId()
	};
}
private AuthenticateRequest Authenticate_SSO(AuthenticationType authType)
{
	var ret = new AuthenticateRequest()
	{
		Credentials = new SSOCredentials()
		{
			FIIdentifier = "abcd",
			HomeBankingId = "999",
			SaltValue = Guid.NewGuid().ToString(),
			Timestamp = DateTime.Parse("1/1/2016"),
			PhoneKey = GetPhoneKey()
		},
		DeviceTracking = new DeviceTracking
		{
			AppBundleId = "com.testbank.deposit", //get from your app
			AppVersion = "1.0.1433", //get from your app
			DeviceModel = "iPhone 6s",  //get from system info
			DeviceSystemName = "iPhone OS", //get from system info
			DeviceSystemVersion = "9.3.2", //get from system info
			Vendor = "EPS"
		},
		RequestId = NewRequestId(),
		RequestDate = DateTime.Now,
	};
	CalculateHash(ret.Credentials as SSOCredentials, authType);

	return ret;
}
private string CalculateHash(SSOCredentials creds, AuthenticationType authType)
{
	string shared_secret = "This is a secret!!!!";
	string Concatenated = creds.HomeBankingId + creds.Timestamp.ToString() + creds.FIIdentifier + shared_secret + creds.SaltValue;

	byte[] output = null;
	HashAlgorithm hashAlgorithm = null;
	switch (authType)
	{
		case AuthenticationType.SSO256:
			hashAlgorithm = new SHA256CryptoServiceProvider();
			break;
		case AuthenticationType.SSO512:
			hashAlgorithm = new SHA512CryptoServiceProvider();
			break;
	}

	if (hashAlgorithm != null)
	{
		output = hashAlgorithm.ComputeHash(Encoding.ASCII.GetBytes(Concatenated));
		hashAlgorithm.Dispose();
		hashAlgorithm = null;
	}

	return ToHexString(output);
}
private string ToHexString(byte[] bytes)
{
	char[] hexDigits = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };

	char[] chars = new char[bytes.Length * 2];
	for (int i = 0; i < bytes.Length; i++)
	{
		int b = bytes[i];
		chars[i * 2] = hexDigits[b >> 4];
		chars[i * 2 + 1] = hexDigits[b & 0xF];
	}

	return new string(chars);
}

Example JS

function Authenticate(authType, success, error) {
  var request = new XMLHttpRequest();

  request.setRequestHeader("Content-type", "application/json; charset=utf-8");
  request.open(
    "POST",
    "http://localhost/mobile/RDAWebService.svc/Authenticate",
    true
  );
  request.onreadystatechange = function () {
    if (request.readyState === 4) {
      if (request.status !== 200) {
        return error(request.statusText);
      }

      var response = JSON.parse(request.responseText);

      switch (response.Result) {
        case Result.Error:
        case Result.ValidationError:
          return error(response);
        case Result.Success:
        default:
          return success(response);
      }
    }
  };
  request.send(getAuthenticationCredentials(authType));
}

function getAuthenticationCredentials(authType) {
  switch (authType) {
    case AuthenticateType.User: {
      var user = new Customer();
      user.PhoneKey = "1234";
      user.Company = "Company";
      user.Password = "TestPassword";
      user.UserName = "TestUser";
      user.DeviceTracking.AppBundleId = "com.testbank.deposit";
      user.DeviceTracking.AppVersion = "1.0";
      user.DeviceTracking.DeviceModel = "iPhone7.2";
      user.DeviceTracking.DeviceSystemName = "iPhone OS";
      user.DeviceTracking.DeviceSystemVersion = "8.3";
      user.DeviceTracking.Vendor = "XYZ";

      return JSON.stringify(user);
    }
    case AuthenticateType.SSO: {
      var ssoUser = new Customer();
      ssoUser.UserNumber = 999;
      ssoUser.FIIdentifier = "abcd";
      ssoUser.Hash = "1234";
      ssoUser.SaltValue = "1234";
      ssoUser.Timestamp = "/Date(" + new Date().toJSON() + ")/";
      ssoUser.DeviceTracking.AppBundleId = "com.testbank.deposit";
      ssoUser.DeviceTracking.AppVersion = "1.0";
      ssoUser.DeviceTracking.DeviceModel = "iPhone7.2";
      ssoUser.DeviceTracking.DeviceSystemName = "iPhone OS";
      ssoUser.DeviceTracking.DeviceSystemVersion = "8.3";
      ssoUser.DeviceTracking.Vendor = "EPS";

      return JSON.stringify(ssoUser);
    }
    default:
      return null;
  }
}