Adds support for /branding endpoints (#475)

* Supports Branding endpoints

* Revert TenantSettings file

* Renames BrandingTemplate to UniversalLoginTemplate

* UniversalLoginTemplateUpdateRequest should use Template property

* Update docs

* Add tests for BrandingClient

* Update tests

Co-authored-by: Frederik <frederik.prijck@gmail.com>
Co-authored-by: Frederik Prijck <frederik.prijck@auth0.com>

src/Auth0.ManagementApi/Clients/BrandingClient.cs

@@ -0,0 +1,77 @@
+using Auth0.ManagementApi.Models;
+using System;
+using System.Collections.Generic;
+using System.Net.Http;
+using System.Threading.Tasks;
+
+namespace Auth0.ManagementApi.Clients
+{
+    /// <summary>
+    /// Contains methods to access the /branding endpoints.
+    /// </summary>
+    public class BrandingClient : BaseClient
+    {
+        /// <summary>
+        /// Initializes a new instance of <see cref="BrandingClient"/>.
+        /// </summary>
+        /// <param name="connection"><see cref="IManagementConnection"/> used to make all API calls.</param>
+        /// <param name="baseUri"><see cref="Uri"/> of the endpoint to use in making API calls.</param>
+        /// <param name="defaultHeaders">Dictionary containing default headers included with every request this client makes.</param>
+        public BrandingClient(IManagementConnection connection, Uri baseUri, IDictionary<string, string> defaultHeaders)
+            : base(connection, baseUri, defaultHeaders)
+        {
+        }
+
+        /// <summary>
+        /// Retrieves branding settings for a tenant.
+        /// </summary>
+        /// <returns>A <see cref="Branding"/> containing the branding for the tenant.</returns>
+        public Task<Branding> GetAsync()
+        {
+            return Connection.GetAsync<Branding>(BuildUri("branding"), DefaultHeaders);
+        }
+
+        /// <summary>s
+        /// Updates the branding for a tenant.
+        /// </summary>
+        /// <param name="request">A <see cref="BrandingUpdateRequest" /> containing the branding information to update.</param>
+        /// <returns>The newly updated <see cref="Branding"/>.</returns>
+        public Task<Branding> UpdateAsync(BrandingUpdateRequest request)
+        {
+            return Connection.SendAsync<Branding>(new HttpMethod("PATCH"), BuildUri("branding"), request, DefaultHeaders);
+        }
+
+        /// <summary>
+        /// Retrieves the template for the New Universal Login Experience.
+        /// </summary>
+        /// <returns>The <see cref="UniversalLoginTemplate"/> for the new universal login experience.</returns>
+        public Task<UniversalLoginTemplate> GetUniversalLoginTemplateAsync()
+        {
+            return Connection.GetAsync<UniversalLoginTemplate>(BuildUri("branding/templates/universal-login"), DefaultHeaders);
+        }
+
+        /// <summary>
+        /// Delete the template for the New Universal Login Experience
+        /// </summary>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
+        public Task DeleteUniversalLoginTemplateAsync()
+        {
+            return Connection
+                    .SendAsync<object>(
+                            HttpMethod.Delete,
+                            BuildUri("branding/templates/universal-login"),
+                            null,
+                            DefaultHeaders);
+        }
+
+        /// <summary>
+        /// Sets the template for the New Universal Login Experience.
+        /// </summary>
+        /// <param name="request">The <see cref="UniversalLoginTemplateUpdateRequest"/> containing details of the template to set.</param>
+        /// <returns>The newly updated <see cref="UniversalLoginTemplate"/>.</returns>
+        public Task<UniversalLoginTemplate> SetUniversalLoginTemplateAsync(UniversalLoginTemplateUpdateRequest request)
+        {
+            return Connection.SendAsync<UniversalLoginTemplate>(HttpMethod.Put, BuildUri("branding/templates/universal-login"), request, DefaultHeaders);
+        }
+    }
+}

src/Auth0.ManagementApi/ManagementApiClient.cs

@@ -20,6 +20,11 @@ public class ManagementApiClient : IDisposable
         /// </summary>
         public BlacklistedTokensClient BlacklistedTokens { get; }
 
+        /// <summary>
+        /// Contains all the methods to call the /branding endpoints.
+        /// </summary>
+        public BrandingClient Branding { get; }
+
         /// <summary>
         /// Contains all the methods to call the /client-grants endpoints
         /// </summary>
@@ -139,6 +144,7 @@ public ManagementApiClient(string token, Uri baseUri, IManagementConnection mana
             var defaultHeaders = CreateDefaultHeaders(token);
 
             BlacklistedTokens = new BlacklistedTokensClient(managementConnection, baseUri, defaultHeaders);
+            Branding = new BrandingClient(managementConnection, baseUri, defaultHeaders);
             ClientGrants = new ClientGrantsClient(managementConnection, baseUri, defaultHeaders);
             Clients = new ClientsClient(managementConnection, baseUri, defaultHeaders);
             Connections = new ConnectionsClient(managementConnection, baseUri, defaultHeaders);

src/Auth0.ManagementApi/Models/Branding.cs

@@ -0,0 +1,9 @@
+namespace Auth0.ManagementApi.Models
+{
+    /// <summary>
+    /// Represents the Auth0 Tenant's branding settings
+    /// </summary>
+    public class Branding : BrandingBase
+    {
+    }
+}

src/Auth0.ManagementApi/Models/BrandingBase.cs

@@ -0,0 +1,31 @@
+using Newtonsoft.Json;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class BrandingBase
+    {
+        /// <summary>
+        /// Custom color settings.
+        /// </summary>
+        [JsonProperty("colors")]
+        public BrandingColors Colors { get; set; }
+
+        /// <summary>
+        /// URL for the favicon. Must use HTTPS.
+        /// </summary>
+        [JsonProperty("favicon_url")]
+        public string FaviconUrl { get; set; }
+
+        /// <summary>
+        /// URL for the logo. Must use HTTPS.
+        /// </summary>
+        [JsonProperty("logo_url")]
+        public string LogoUrl { get; set; }
+
+        /// <summary>
+        /// Custom font settings.
+        /// </summary>
+        [JsonProperty("font")]
+        public BrandingFont Font{ get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/BrandingColors.cs

@@ -0,0 +1,19 @@
+using Newtonsoft.Json;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class BrandingColors
+    {
+        /// <summary>
+        /// Accent color.
+        /// </summary>
+        [JsonProperty("primary")]
+        public string Primary { get; set; }
+
+        /// <summary>
+        /// Page Background Color or Gradient.
+        /// </summary>
+        [JsonProperty("page_background")]
+        public string PageBackground { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/BrandingFont.cs

@@ -0,0 +1,13 @@
+using Newtonsoft.Json;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class BrandingFont
+    {
+        /// <summary>
+        /// URL for the custom font. The URL must point to a font file and not a stylesheet. Must use HTTPS.
+        /// </summary>
+        [JsonProperty("url")]
+        public string Url { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/BrandingUpdateRequest.cs

@@ -0,0 +1,7 @@
+namespace Auth0.ManagementApi.Models
+{
+    public class BrandingUpdateRequest : BrandingBase
+    {
+
+    }
+}

src/Auth0.ManagementApi/Models/UniversalLoginTemplate.cs

@@ -0,0 +1,13 @@
+using Newtonsoft.Json;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class UniversalLoginTemplate
+    {
+        /// <summary>
+        /// The custom page template for the new universal login experience.
+        /// </summary>
+        [JsonProperty("body")]
+        public string Body { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/UniversalLoginTemplateUpdateRequest.cs

@@ -0,0 +1,16 @@
+using Newtonsoft.Json;
+
+namespace Auth0.ManagementApi.Models
+{
+    /// <summary>
+    /// Request for updating the template for the New Universal Login Experience.
+    /// </summary>
+    public class UniversalLoginTemplateUpdateRequest
+    {
+        /// <summary>
+        /// Gets or sets the custom page template for the New Universal Login Experience
+        /// </summary>
+        [JsonProperty("template")]
+        public string Template { get; set; }
+    }
+}

tests/Auth0.ManagementApi.IntegrationTests/BrandingClientTests.cs

@@ -0,0 +1,105 @@
+using System;
+using System.Threading.Tasks;
+using Auth0.Core.Exceptions;
+using Auth0.Tests.Shared;
+using Xunit;
+
+namespace Auth0.ManagementApi.IntegrationTests
+{
+    public class BrandingClientTests : TestBase, IAsyncLifetime
+    {
+        private ManagementApiClient _apiClient;
+
+        public async Task InitializeAsync()
+        {
+            string token = await GenerateManagementApiToken();
+
+            _apiClient = new ManagementApiClient(token, GetVariable("AUTH0_MANAGEMENT_API_URL"));
+        }
+
+        public Task DisposeAsync()
+        {
+            return Task.CompletedTask;
+        }
+
+        [Fact]
+        public async Task Test_Branding_Reand_And_Update()
+        {
+            try
+            {
+                // Update branding
+                await _apiClient.Branding.UpdateAsync(new Models.BrandingUpdateRequest
+                {
+                    LogoUrl = "https://cdn.auth0.com/website/press/resources/auth0-logo-monotone-white.svg",
+                    FaviconUrl = "https://cdn.auth0.com/website/press/resources/auth0-logo-monotone-black.svg",
+                    Colors = new Models.BrandingColors
+                    {
+                        PageBackground = "#ffffff",
+                        Primary = "#ff0000"
+                    },
+                    Font = new Models.BrandingFont
+                    {
+                        Url = "https://fonts.googleapis.com/css2?family=Open+Sans&display=swap"
+                    }
+                });
+
+                var updatedBranding = await _apiClient.Branding.GetAsync();
+
+                Assert.Equal("https://cdn.auth0.com/website/press/resources/auth0-logo-monotone-white.svg", updatedBranding.LogoUrl);
+                Assert.Equal("https://cdn.auth0.com/website/press/resources/auth0-logo-monotone-black.svg", updatedBranding.FaviconUrl);
+                Assert.Equal("https://fonts.googleapis.com/css2?family=Open+Sans&display=swap", updatedBranding.Font.Url);
+                Assert.Equal("#ff0000", updatedBranding.Colors.Primary);
+                Assert.Equal("#ffffff", updatedBranding.Colors.PageBackground);
+
+            }
+            finally
+            {
+                // Rollback
+                await _apiClient.Branding.UpdateAsync(new Models.BrandingUpdateRequest
+                {
+                    Colors = new Models.BrandingColors { 
+                        Primary = "#0059d6",
+                        PageBackground = "#000000"
+                    },
+                    LogoUrl = "https://cdn.auth0.com/website/press/resources/auth0-logo-monotone-black.svg",
+                    FaviconUrl = "https://cdn2.auth0.com/styleguide/latest/lib/logos/img/favicon.png",
+                    Font = new Models.BrandingFont
+                    {
+                        Url = "https://fonts.googleapis.com/css2?family=Roboto&display=swap"
+                    },
+                });
+            }
+        }
+
+        [Fact(Skip = "Enable when migrated to new Tenant because missing permissions on current")]
+        public async Task Test_Branding_ULPTemplate_Reand_Update_Delete()
+        {
+            // var temp = await _apiClient.Branding.GetUniversalLoginTemplateAsync();
+            try
+            {
+                var newTemplateBody = @"<!DOCTYPE html><html>
+                  <head>
+                    {%- auth0:head -%}
+                  </head>
+                  <body>
+                    {%- auth0:widget -%}
+                  </body></html> ";
+
+                await _apiClient.Branding.SetUniversalLoginTemplateAsync(new Models.UniversalLoginTemplateUpdateRequest
+                {
+                    Template = newTemplateBody
+                });
+
+                var updatedTemplate = await _apiClient.Branding.GetUniversalLoginTemplateAsync();
+
+                Assert.Equal(newTemplateBody, updatedTemplate.Body);
+            }
+            finally
+            {
+                await _apiClient.Branding.DeleteUniversalLoginTemplateAsync();
+
+                await Assert.ThrowsAsync<ErrorApiException>(() => _apiClient.Branding.GetUniversalLoginTemplateAsync());
+            }
+        }
+    }
+}