User Tools

Site Tools


developers:integration:wsa

This is an old revision of the document!


Using ADUCID web service “WSA”

See

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

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

https://hostname/wsa?wsdl

C# Example

Import WSDL into your project in Visual Studio.

Create an instance of AducidApiServiceClient and make calls to ADUCID and get authentication result with a few rows of code:

Create a start operation Url

This page starts authentication request. As a parameter of verifyLF method we provide URL with final page where authentication is evaluated:

protected void Page_Load(object sender, EventArgs e) {
            var aducid = new AducidApiServiceClient();
            string host = "http://" + HttpContext.Current.Request.Url.Host + ":" + HttpContext.Current.Request.Url.Port;
            var redirect = aducid.startAuthenticationSession(host + "/result");
            Response.Redirect(redirect);
}

Create check result Url

On the result page we evaluate the authentication request using aducid.getResult

There are two basic results – authentication is OK or an error is thrown:

protected void Page_Load(object sender, EventArgs e)
        {
            var queryString = HttpContext.Current.Request.Url.Query;
            var query = HttpUtility.ParseQueryString(queryString);
 
            var sb = new StringBuilder();
            var aducid = new AducidApiServiceClient();
            try
            {
                var result = aducid.getResult(query.Get("authId"), query.Get("authkey"));
                sb.Append("<table class=\"table table-bordered\">");
                sb.Append("<tr><td>authId:</td><td>" + result.authId + "</td></tr>");
                sb.Append("<tr><td>authKey:</td><td>" + result.authKey + "</td></tr>");
                sb.Append("<tr><td>operationName:</td><td>" + result.operationName + "</td></tr>");
                sb.Append("<tr><td>UDI:</td><td>" + result.userDatabaseIndex + "</td></tr>");
                sb.Append("<tr><td>Status AIM:</td><td>" + result.statusAIM + "</td></tr>");
                sb.Append("<tr><td>Status auth:</td><td>" + result.statusAuth + "</td></tr>");
 
                sb.Append("</table>");
 
            }
            catch (Exception ee)
            {
                sb.Append("Error:" + ee.Message);
            }
            lResponse.Text = sb.ToString();
        }

Prepare a web page

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

developers/integration/wsa.1530108188.txt.gz · Last modified: 2018/06/27 14:03 by tjotov