See

• Server side integration basics
• ADUCID Integration API

For detailed methods / classes / types description see Javadoc SDK Client API

WSA is meant for all platforms like PHP, C# except Java (Java is also possible but we provide a full module so WSDL import is redundant).

Web service is a standalone “application” which must be deployed on same server as AIM. Its default address is like this:

https://hostname/wsa-json

There you will see WSA Interface homepage where you can download WSDL file to generate client.

https://hostname/wsa-json?wsdl

Create an instance of AducidApiJsonServiceClient.

This page starts authentication request.

var aducid = new AducidApiJsonServiceClient();
string host = "http://" + HttpContext.Current.Request.Url.Host + ":" + HttpContext.Current.Request.Url.Port;
string query = context.Request.QueryString.ToString();
var queryParsed = HttpUtility.ParseQueryString(query);
var generateQr = queryParsed["generateQrCodePicture"];
var arg = new OperationArgument();
//return URL for iOS
arg.peigReturnName = host + "/result";
//QR code picture size
arg.qrCodePictureHeight = 300;
arg.qrCodePictureWidth = 300;
//tab helper If - if more authentication are in web browser in more tabs this help ti identify them - has to be unique
arg.id = "123";
arg.generateQrCodePicture = generateQr == "true";
 
//JSON response from WSA
var response = aducid.startAuthenticationSession(JsonConvert.SerializeObject(arg));
//parse and store authId
dynamic responseObj = JsonConvert.DeserializeObject(response);
//store authId to your session
context.Session["123"] = (string) responseObj.data.authId;
context.Response.ContentType = "text/plain";
//send response
context.Response.Write(response);

OperationArgument is a simple object

public class OperationArgument
    {
        public String peigReturnName { get; set; }
        public int qrCodePictureHeight { get; set; }
        public int qrCodePictureWidth { get; set; }
        public String id { get; set; }
        public Boolean generateQrCodePicture { get; set; }
    }

Just simple “Rewrite” from WSA to C# with authId check

var aducid = new AducidApiJsonServiceClient();
string host = "http://" + HttpContext.Current.Request.Url.Host + ":" + HttpContext.Current.Request.Url.Port;
var response = aducid.getStatus((string)context.Session["123"]);
context.Response.ContentType = "text/plain";
context.Response.Write(response);

On the result page we evaluate the authentication There are two basic results – authentication is OK or an error is thrown:

var aducid = new AducidApiJsonServiceClient();
//read authId from you session
string authId = (string)context.Session["123"];
var aducidResult = aducid.getResult(authId, null);
//parse json
dynamic aducidResultObj = JsonConvert.DeserializeObject(aducidResult);
//User primary key i.e. UDI
var udi = aducidResultObj.data.userDatabaseIndex;
//key to further ADUCID operetions on user object (with authId)
string authKey2 = aducidResultObj.data.authKey2;
//prepare response
var response = aducid.endAuthenticationSession(authId, authKey2);
context.Response.ContentType = "text/plain";
//OK do something with your session
//...
//send response
context.Response.Write(response);

This page should contain ADUCID Integration API
Provide start, check and proxy Url. aducid.setStartOperationUrl(“myOpen”); aducid.setResultOperationUrl(“myPpenCheck”); aducid.setProxyUrl(“myProxy”);