Merge pull request #160 from docusign/feature/web-forms-code-example

Web forms code example

Author: InbarGazit

.gitignore

@@ -263,4 +263,5 @@ __pycache__/
 #configuration files (secrets), should not be checked in to source control
 appsettings.json
 private.key
-app.config
+app.config
+web-form-config.json

ExamplesAPIType.cs

@@ -43,6 +43,12 @@ public enum ExamplesApiType
         /// </summary>
         [Description("con")]
         Connect = 5,
+
+        /// <summary>
+        /// Web Forms API
+        /// </summary>
+        [Description("web")]
+        WebForms = 6,
     }
 
     public static class ExamplesApiTypeExtensions

ExamplesApiTypeExtensions.cs

@@ -43,6 +43,12 @@ public enum ExamplesApiType
         /// </summary>
         [Description("con")]
         Connect = 5,
+
+        /// <summary>
+        /// Web Forms API
+        /// </summary>
+        [Description("web")]
+        WebForms = 6,
     }
 
     public static class ExamplesApiTypeExtensions

JWTAuth.cs

@@ -78,6 +78,11 @@ public static OAuthToken AuthenticateWithJwt(string api, string clientId, string
                 });
             }
 
+            if (apiType == ExamplesApiType.WebForms)
+            {
+                scopes.Add("webforms_manage");
+            }
+
             return docuSignClient.RequestJWTUserToken(
                 clientId,
                 impersonatedUserId,

launcher-csharp.Tests/JwtLoginMethodUnitTest.cs

@@ -92,6 +92,9 @@ private string BuildConsentUrl(ExamplesApiType apiType, TestConfig testConfig)
                 scopes += "%20user_read%20user_write%20organization_read%20account_read%20group_read%20"
                             + "permission_read%20identity_provider_read%20domain_read%20user_data_redact%20"
                             + "asset_group_account_read%20asset_group_account_clone_write%20asset_group_account_clone_read";
+            } else if (apiType == ExamplesApiType.WebForms)
+            {
+                scopes += "%20webforms_manage";
             }
 
             string caret = "";

launcher-csharp/Common/IRequestItemsService.cs

@@ -34,6 +34,8 @@ public interface IRequestItemsService
 
         public string TemplateId { get; set; }
 
+        public string WebFormsTemplateId { get; set; }
+
         public string PausedEnvelopeId { get; set; }
 
         public string Status { get; set; }

launcher-csharp/Common/LocalsFilter.cs

@@ -97,6 +97,7 @@ public void OnActionExecuting(ActionExecutingContext context)
                         BasePath = identity.FindFirst(x => x.Type.Equals("base_uri")).Value,
                         RoomsApiBasePath = this.configuration["DocuSign:RoomsApiEndpoint"],
                         AdminApiBasePath = this.configuration["DocuSign:AdminApiEndpoint"],
+                        WebFormsBasePath = this.configuration["DocuSign:WebFormsBasePath"],
                     }
                     :
                     new Session
@@ -106,6 +107,7 @@ public void OnActionExecuting(ActionExecutingContext context)
                         BasePath = this.requestItemsService.Session.BasePath,
                         RoomsApiBasePath = this.configuration["DocuSign:RoomsApiEndpoint"],
                         AdminApiBasePath = this.configuration["DocuSign:AdminApiEndpoint"],
+                        WebFormsBasePath = this.configuration["DocuSign:WebFormsBasePath"],
                     };
 
                 this.requestItemsService.Session = locals.Session;

launcher-csharp/Common/RequestItemsService.cs

@@ -148,6 +148,12 @@ public string TemplateId
             set => this.cache.Set(this.GetKey("TemplateId"), value);
         }
 
+        public string WebFormsTemplateId
+        {
+            get => this.cache.Get<string>(this.GetKey("WebFormsTemplateId"));
+            set => this.cache.Set(this.GetKey("WebFormsTemplateId"), value);
+        }
+
         public string ClickwrapId
         {
             get => this.cache.Get<string>(this.GetKey("ClickwrapId"));
@@ -206,6 +212,7 @@ public void UpdateUserFromJwt()
                 BasePath = account.BaseUri,
                 RoomsApiBasePath = this.Configuration["DocuSign:RoomsApiEndpoint"],
                 AdminApiBasePath = this.Configuration["DocuSign:AdminApiEndpoint"],
+                WebFormsBasePath = this.Configuration["DocuSign:WebFormsBasePath"],
             };
         }
 
@@ -255,6 +262,10 @@ public string IdentifyApiOfCodeExample(string eg)
             {
                 currentApiType = ExamplesApiType.Connect.ToString();
             }
+            else if (eg.Contains(ExamplesApiType.WebForms.ToKeywordString()))
+            {
+                currentApiType = ExamplesApiType.WebForms.ToString();
+            }
             else
             {
                 currentApiType = ExamplesApiType.ESignature.ToString();

launcher-csharp/Startup.cs

@@ -7,11 +7,14 @@ namespace DocuSign.CodeExamples
 {
     using System;
     using System.Collections.Generic;
+    using System.Linq;
     using System.Net.Http;
     using System.Net.Http.Headers;
     using System.Security.Claims;
     using System.Text.Json;
+    using System.Text.RegularExpressions;
     using System.Threading.Tasks;
+    using System.Web;
     using DocuSign.CodeExamples.Common;
     using DocuSign.CodeExamples.Models;
     using DocuSign.Rooms.Api;
@@ -35,7 +38,7 @@ public Startup(IConfiguration configuration)
         {
             this.Configuration = configuration;
 
-            this.apiTypes.Add(ExamplesApiType.ESignature, new List<string> { "signature" });
+            this.apiTypes.Add(ExamplesApiType.ESignature, new List<string> { "signature", });
 
             this.apiTypes.Add(ExamplesApiType.Rooms, new List<string>
             {
@@ -77,6 +80,11 @@ public Startup(IConfiguration configuration)
                     "asset_group_account_clone_write",
                     "asset_group_account_clone_read",
             });
+
+            this.apiTypes.Add(ExamplesApiType.WebForms, new List<string>
+            {
+                "signature", "webforms_manage",
+            });
         }
 
         public IConfiguration Configuration { get; }
@@ -175,28 +183,7 @@ public void ConfigureServices(IServiceCollection services)
                     {
                         List<string> scopesForCurrentApi = this.apiTypes.GetValueOrDefault(Enum.Parse<ExamplesApiType>(this.Configuration["API"]));
 
-                        foreach (var api in this.apiTypes)
-                        {
-                            if (this.Configuration["API"] != api.Key.ToString())
-                            {
-                                foreach (var scope in api.Value)
-                                {
-                                    if (scopesForCurrentApi != null && !scopesForCurrentApi.Contains(scope))
-                                    {
-                                        var scopeWithSeperator = scope + "%20";
-
-                                        if (redirectContext.RedirectUri.Contains(scopeWithSeperator))
-                                        {
-                                            redirectContext.RedirectUri = redirectContext.RedirectUri.Replace(scopeWithSeperator, string.Empty);
-                                        }
-                                        else
-                                        {
-                                            redirectContext.RedirectUri = redirectContext.RedirectUri.Replace(scope, string.Empty);
-                                        }
-                                    }
-                                }
-                            }
-                        }
+                        redirectContext.RedirectUri = this.UpdateRedirectUriScopes(redirectContext.RedirectUri, scopesForCurrentApi);
 
                         redirectContext.HttpContext.Response.Redirect(redirectContext.RedirectUri);
                         return Task.FromResult(0);
@@ -327,5 +314,13 @@ public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
 
             return keyValue;
         }
+
+        private string UpdateRedirectUriScopes(string uri, List<string> wantedScopes)
+        {
+            const string pattern = @"(?:&|\?)scope=([^&]+)";
+
+            var encodedScopes = string.Join(" ", wantedScopes);
+            return Regex.Replace(uri, pattern, $"&scope={HttpUtility.UrlPathEncode(encodedScopes)}");
+        }
     }
 }

launcher-csharp/Views/Home/Index.cshtml

@@ -43,6 +43,7 @@
                     : ((ApIs) api).Name.ToLower() == ExamplesApiType.Monitor.ToString().ToLower()  ? ExamplesApiType.Monitor.ToKeywordString()
                     : ((ApIs) api).Name.ToLower() == ExamplesApiType.Rooms.ToString().ToLower() ? ExamplesApiType.Rooms.ToKeywordString()
                     : ((ApIs) api).Name.ToLower() == ExamplesApiType.Connect.ToString().ToLower() ? ExamplesApiType.Connect.ToKeywordString()
+                    : ((ApIs) api).Name.ToLower() == ExamplesApiType.WebForms.ToString().ToLower() ? ExamplesApiType.WebForms.ToKeywordString()
                     : ExamplesApiType.Admin.ToKeywordString();
 
                 @foreach(var exampleGroup in api.Groups)