Differences

This shows you the differences between two versions of the page.

--- web-integration:c-sharp-example [2019/08/05 11:21]
tjotov
+++ web-integration:c-sharp-example [2019/08/05 11:27] (current)
tjotov
@@ Line 2: / Line 2: @@
 C# relies on Web services for ADUCID - or WSA, see [[web-integration:basics|Server side integration basics]]
-=== Import WSDL into your project in Visual Studio. ===
+Import WSDL into your project in Visual Studio.
 Create an instance of **AducidApiJsonServiceClient**.
@@ Line 53: / Line 53: @@
 </sxh>
-OperationArgument is a simple object
-<sxh csharp>
-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; }
-    }
-</sxh>
 === Create WSA proxy ===
 Just simple "Rewrite" from WSA to C# with authId check
 <sxh csharp>
-var aducid = new AducidApiJsonServiceClient();
+            //We have to "proxy" AIM reponses to Web APIuising this page
-string host = "http://" + HttpContext.Current.Request.Url.Host + ":" + HttpContext.Current.Request.Url.Port;
+            var aducid = new AducidApiServiceClient();
-var response = aducid.getStatus((string)context.Session["123"]);
+            context.Response.ContentType = "application/json";
-context.Response.ContentType = "text/plain";
+            try
-context.Response.Write(response);
+            {
+                string query = context.Request.QueryString.ToString();
+                var queryParsed = HttpUtility.ParseQueryString(query);
+                //get id from session based on GUID
+                var id = queryParsed["id"];
+                //get response from AIM
+                var response = aducid.getStatus((string)context.Session[id]);
+                //send response to Web API
+                context.Response.Write(aducid.toJson(response, ""));
+            }
+            catch (System.ServiceModel.FaultException e)
+            {
+                //handle error
+                var msgFault = e.CreateMessageFault();
+                var errorResult = msgFault.GetDetail<AducidClientException>().result;
+                //get error as JSON
+                var response = aducid.toErrorJson(errorResult, "error");
+                //send JSON to Web API
+                context.Response.Write(response);
+            }
 </sxh>
@@ Line 79: / Line 89: @@
 <sxh csharp>
-var aducid = new AducidApiJsonServiceClient();
+            var aducid = new AducidApiServiceClient();
-//read authId from you session
+            string query = context.Request.QueryString.ToString();
-string authId = (string)context.Session["123"];
+            var queryParsed = HttpUtility.ParseQueryString(query);
-var aducidResult = aducid.getResult(authId, null);
+            var id = queryParsed["id"];
-//parse json
+            //get authId from session
-dynamic aducidResultObj = JsonConvert.DeserializeObject(aducidResult);
+            string authId = (string)context.Session[id];
-//User primary key i.e. UDI
+            context.Response.ContentType = "application/json";
-var udi = aducidResultObj.data.userDatabaseIndex;
+            try
-//key to further ADUCID operetions on user object (with authId)
+            {
-string authKey2 = aducidResultObj.data.authKey2;
+                //call AIM to get operation result
-//prepare response
+                var aducidResult = aducid.getResult(authId, null);
-var response = aducid.endAuthenticationSession(authId, authKey2);
+                //User Database Index, i.e. UDI
-context.Response.ContentType = "text/plain";
+                var udi = aducidResult.userDatabaseIndex;
-//OK do something with your session
+                //authKey (with authId) used to access user data later from AIM
-//...
+                var authKey2 = aducidResult.authKey;
-//send response
+                //finalize authentication and get respoonse form Web API
-context.Response.Write(response);
+                var response = aducid.endAuthenticationSession(authId, authKey2);
+                //AUTHENTICATED
+                FormsAuthentication.SetAuthCookie("auth", false);
+                //send Web API the result - by default it will redirect to URI we provided earlier; for iOS PEIG opens this URI directly
+                context.Response.Write(aducid.toJson(response, "authenticated"));
+            }
+            catch (System.ServiceModel.FaultException e)
+            {
+                //handle error
+                var msgFault = e.CreateMessageFault();
+                var errorResult = msgFault.GetDetail<AducidClientException>().result;
+                //get error as JSON
+                var response = aducid.toErrorJson(errorResult, "error");
+                //send JSON to Web API
+                context.Response.Write(response);
+            }
 </sxh>
 === Prepare a web page ===
-This page should contain [[integration-api:start|ADUCID Integration API]]\\
+This page should contain [[web-integration:client-side|Client API for Web Integration]]\\
 Provide start, check and proxy Url.
-<sxh>
-   aducid.setStartOperationUrl("open");
-   aducid.setResultOperationUrl("openCheck");
-   aducid.setProxyUrl("proxy");
-</sxh>
 Override what should be done after authentication / operation:
-<sxh>
+<sxh javascript>
-   aducid.processResult = function (result) {
+     <script type="text/javascript">
+        var aducid = new ADUCID();
+        $(document).ready(function () {
+            aducid.setAuthentication();
+            //operation start URL
+            aducid.setStartOperationUrl("open");
+            //operation check URL
+            aducid.setResultOperationUrl("openCheck");
+            //proxy helper URL
+            aducid.setProxyUrl("proxy");
+            //text under QR code
+            aducid.showQRHint = function (param) {
+                $('#qr-code-hint').html("Use your PEIG to authenticate");
+            }
+            //running operation texr
+            aducid.showRunningHint = function (param) {
+                $('#qr-code-hint').html("Please wait ...");
+            }
+            //called when auth finished (except iOS)
+            aducid.processResult = function (result) {
+                alert("Auth finished. Result: " + JSON.stringify(result));
                 if (result.status == "OK") {
-                    alert("atuhenticated");
+                    location.href = result.redirect;
-                    //location.reload();
                 }
                 else {
-                    alert("atuhentication failure");
+                    location.href = result.redirect;
                 }
             }
+            //handle PEIG not installed error
+            aducid.showPeigError = function () {
+                showDialog("Problem with PEIG", "PEIG is not installed", "error", function () {
+                    location.reload();
+                });
+            }
+            //handle communication or other error
+            aducid.handleError = function (result) {
+                showDialog("General error", result.data.message, "error", function () {
+                    location.href = result.redirect;
+                });
+            }
+            //GUI mapping
+            //button associated to start auth
+            aducid.setButton($("#main-button"));
+            //locatino of QR code img
+            aducid.setQrCode($("#qr-code"));
+            //location of text under QR code
+            aducid.setQrHint($("#qr-code-hint"));
+            //start; false as we wait for button click or qr scan
+            aducid.init(false);
+        });
+    </script>
 </sxh>
@@ Line 123: / Line 193: @@
 <sxh html>
-<h1>ADUCID Hello World example</h1>
+    <div class="container">
+        <h1>ADUCID Hello World example</h1>
         <div class="row">
             <div class="col-xs-8 col-xs-offset-2">
@@ Line 149: / Line 220: @@
             </div>
         </div>
+    </div>
 </sxh>

ADUCID 4.x

User Tools

Site Tools

Differences

Page Tools