This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
developers:integration:wsa [2018/06/26 14:31] tjotov |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Using ADUCID web service “WSA” ====== | ||
- | |||
- | See [[developers: | ||
- | |||
- | For detailed methods / classes / types description see [[http:// | ||
- | |||
- | 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:// | ||
- | </ | ||
- | |||
- | There you will see WSA Interface homepage where you can download WSDL file to generate client. | ||
- | |||
- | < | ||
- | https:// | ||
- | </ | ||
- | |||
- | |||
- | |||
- | === 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: | ||
- | |||
- | <code csharp> | ||
- | protected void Page_Load(object sender, EventArgs e) { | ||
- | var aducid = new AducidApiServiceClient(); | ||
- | string host = " | ||
- | var redirect = aducid.startAuthenticationSession(host + "/ | ||
- | 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: | ||
- | |||
- | <code csharp> | ||
- | 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(" | ||
- | sb.Append("< | ||
- | sb.Append("< | ||
- | sb.Append("< | ||
- | sb.Append("< | ||
- | sb.Append("< | ||
- | sb.Append("< | ||
- | sb.Append("< | ||
- | |||
- | sb.Append("</ | ||
- | |||
- | } | ||
- | catch (Exception ee) | ||
- | { | ||
- | sb.Append(" | ||
- | } | ||
- | lResponse.Text = sb.ToString(); | ||
- | } | ||
- | </ | ||
- | |||
- | |||
- | === Prepare a web page === | ||
- | This page should contain [[integration-api: | ||
- | Provide start, check and proxy Url. | ||
- | | ||
- | | ||
- | | ||