[SDK-2438] Add support for Organizations in Management API

playground/Auth0.NET5/Auth0.NET5.csproj

@@ -6,9 +6,12 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Auth0.AuthenticationApi" Version="7.5.1" />
-    <PackageReference Include="Auth0.ManagementApi" Version="7.5.1" />
     <PackageReference Include="Swashbuckle.AspNetCore" Version="5.6.3" />
   </ItemGroup>
 
+  <ItemGroup>
+    <ProjectReference Include="..\..\src\Auth0.AuthenticationApi\Auth0.AuthenticationApi.csproj" />
+    <ProjectReference Include="..\..\src\Auth0.ManagementApi\Auth0.ManagementApi.csproj" />
+  </ItemGroup>
+
 </Project>

src/Auth0.ManagementApi/Clients/UsersClient.cs

@@ -17,6 +17,7 @@ public class UsersClient : BaseClient
         readonly JsonConverter[] logsConverters = new JsonConverter[] { new PagedListConverter<LogEntry>("logs", true) };
         readonly JsonConverter[] rolesConverters = new JsonConverter[] { new PagedListConverter<Role>("roles") };
         readonly JsonConverter[] permissionsConverters = new JsonConverter[] { new PagedListConverter<UserPermission>("permissions") };
+        readonly JsonConverter[] organizationsConverters = new JsonConverter[] { new PagedListConverter<Organization>("organizations") };
 
         /// <summary>
         /// Initializes a new instance of <see cref="UsersClient"/>.
@@ -322,5 +323,25 @@ public Task RemovePermissionsAsync(string id, AssignPermissionsRequest request)
         {
             return Connection.SendAsync<object>(HttpMethod.Delete, BuildUri($"users/{EncodePath(id)}/permissions"), request, DefaultHeaders);
         }
+
+        /// <summary>
+        /// Lists organizations for a user.
+        /// </summary>
+        /// <param name="userId">The ID of the user for which you want to retrieve the organizations.</param>
+        /// <param name="pagination">Specifies pagination info to use when requesting paged results.</param>
+        /// <returns>An <see cref="IPagedList{Organization}"/> containing the list of organizations.</returns>
+        public Task<IPagedList<Organization>> GetAllOrganizationsAsync(string userId, PaginationInfo pagination)
+        {
+            if (pagination == null)
+                throw new ArgumentNullException(nameof(pagination));
+
+            return Connection.GetAsync<IPagedList<Organization>>(BuildUri($"users/{EncodePath(userId)}/organizations",
+                new Dictionary<string, string>
+                {
+                    {"page", pagination.PageNo.ToString()},
+                    {"per_page", pagination.PerPage.ToString()},
+                    {"include_totals", pagination.IncludeTotals.ToString().ToLower()},
+                }), DefaultHeaders, organizationsConverters);
+        }
     }
 }

src/Auth0.ManagementApi/ManagementApiClient.cs

@@ -81,6 +81,11 @@ public class ManagementApiClient : IDisposable
         /// </summary>
         public LogStreamsClient LogStreams { get; }
 
+        /// <summary>
+        /// Contains all the methods to call the /organizations endpoints.
+        /// </summary>
+        public OrganizationsClient Organizations { get; }
+
         /// <summary>
         /// Contains all the methods to call the /resource-servers endpoints.
         /// </summary>
@@ -160,6 +165,7 @@ public ManagementApiClient(string token, Uri baseUri, IManagementConnection mana
             Jobs = new JobsClient(managementConnection, baseUri, defaultHeaders);
             Logs = new LogsClient(managementConnection, baseUri, defaultHeaders);
             LogStreams = new LogStreamsClient(managementConnection, baseUri, defaultHeaders);
+            Organizations = new OrganizationsClient(managementConnection, baseUri, defaultHeaders);
             ResourceServers = new ResourceServersClient(managementConnection, baseUri, defaultHeaders);
             Roles = new RolesClient(managementConnection, baseUri, defaultHeaders);
             Rules = new RulesClient(managementConnection, baseUri, defaultHeaders);

src/Auth0.ManagementApi/Models/ClientBase.cs

@@ -1,4 +1,5 @@
 using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
 
 namespace Auth0.ManagementApi.Models
 {
@@ -169,6 +170,21 @@ public abstract class ClientBase
         /// </summary>
         [JsonProperty("refresh_token")]
         public RefreshToken RefreshToken { get; set; }
+
+        /// <summary>
+        /// Organization usage for a client
+        /// </summary>
+        [JsonProperty("organization_usage")]
+        [JsonConverter(typeof(StringEnumConverter))]
+        public OrganizationUsage? OrganizationUsage { get; set; }
+
+        /// <summary>
+        /// Defines how to proceed during an authentication transaction when organization usage is required.
+        /// </summary>
+        [JsonProperty("organization_require_behavior")]
+        [JsonConverter(typeof(StringEnumConverter))]
+        public OrganizationRequireBehavior? OrganizationRequireBehavior { get; set; }
     }
+
 }
 

src/Auth0.ManagementApi/Models/EmailVerificationTicketRequest.cs

@@ -34,6 +34,15 @@ public class EmailVerificationTicketRequest
         /// </summary>
         [JsonProperty("identity")]
         public EmailVerificationIdentity Identity { get; set; }
+
+        /// <summary>
+        /// The organization ID.
+        /// </summary>
+        /// <summary>
+        /// If provided the organization_id and organization_name will be included in the redirection URL querystring
+        /// </summary>
+        [JsonProperty("organization_id")]
+        public string OrganizationId { get; set; }
     }
 
 }

src/Auth0.ManagementApi/Models/Organization.cs

@@ -0,0 +1,11 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class Organization : OrganizationBase
+    {
+        [JsonProperty("id")]
+        public string Id { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationAddMemberRolesRequest.cs

@@ -0,0 +1,14 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationAddMemberRolesRequest
+    {
+        /// <summary>
+        /// List of role IDs to associated with the user.
+        /// </summary>
+        [JsonProperty("roles")]
+        public IList<string> Roles { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationAddMembersRequest.cs

@@ -0,0 +1,14 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationAddMembersRequest
+    {
+        /// <summary>
+        /// List of user IDs to add to the organization as members.
+        /// </summary>
+        [JsonProperty("members")]
+        public IList<string> Members { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationBase.cs

@@ -0,0 +1,28 @@
+using Newtonsoft.Json;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationBase
+    {
+        /// <summary>
+        /// The name of the organization
+        /// </summary>
+        [JsonProperty("name")]
+        public string Name { get; set; }
+        /// <summary>
+        /// The display name of the organization
+        /// </summary>
+        [JsonProperty("display_name")]
+        public string DisplayName { get; set; }
+        /// <summary>
+        /// Organization specific branding settings
+        /// </summary>
+        [JsonProperty("branding")]
+        public OrganizationBranding Branding { get; set; }
+        /// <summary>
+        /// Organization specific metadata
+        /// </summary>
+        [JsonProperty("metadata")]
+        public dynamic Metadata { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationBranding.cs

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

src/Auth0.ManagementApi/Models/OrganizationConnection.cs

@@ -0,0 +1,20 @@
+using Newtonsoft.Json;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationConnection
+    {
+        /// <summary>
+        /// ID of the connection.
+        /// </summary>
+        [JsonProperty("connection_id")]
+        public string ConnectionId { get; set; }
+
+        /// <summary>
+        /// Whether or not users that login will automatically be granted membership to the organization.
+        /// </summary>
+        [JsonProperty("assign_membership_on_login")]
+        public bool AssignMembershipOnLogin { get; set; }
+
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationConnectionCreateRequest.cs

@@ -0,0 +1,21 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationConnectionCreateRequest
+    {
+        /// <summary>
+        /// ID of the connection.
+        /// </summary>
+        [JsonProperty("connection_id")]
+        public string ConnectionId { get; set; }
+
+        /// <summary>
+        /// Whether or not users that login will automatically be granted membership to the organization.
+        /// </summary>
+        [JsonProperty("assign_membership_on_login")]
+        public bool AssignMembershipOnLogin { get; set; }
+
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationConnectionUpdateRequest.cs

@@ -0,0 +1,13 @@
+using Newtonsoft.Json;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationConnectionUpdateRequest
+    {
+        /// <summary>
+        /// Whether or not users that login will automatically be granted membership to the organization.
+        /// </summary>
+        [JsonProperty("assign_membership_on_login")]
+        public bool AssignMembershipOnLogin { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationCreateInvitationRequest.cs

@@ -0,0 +1,68 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+
+namespace Auth0.ManagementApi.Models
+{
+    /// <summary>
+    /// Requests structure for creating a new organization invitation.
+    /// </summary>
+    public class OrganizationCreateInvitationRequest
+    {
+        /// <summary>
+        /// Information about the person that is creating the invitation
+        /// </summary>
+        [JsonProperty("inviter")]
+        public OrganizationInvitationInviter Inviter { get; set; }
+
+        /// <summary>
+        /// Information about the person being invited
+        /// </summary>
+        [JsonProperty("invitee")]
+        public OrganizationInvitationInvitee Invitee { get; set; }
+
+        /// <summary>
+        /// The id of the connection to force invitee to authenticate with.
+        /// </summary>
+        [JsonProperty("connection_id")]
+        public string ConnectionId { get; set; }
+
+        /// <summary>
+        /// Auth0 client ID. Used to resolve the application's login initiation endpoint.
+        /// </summary>
+        [JsonProperty("client_id")]
+        public string ClientId { get; set; }
+
+        /// <summary>
+        /// Contains app meta data. The user has read/write access to this.
+        /// </summary>
+        [JsonProperty("app_metadata")]
+        public dynamic AppMetadata { get; set; }
+
+        /// <summary>
+        /// Contains user meta data. The user has read/write access to this.
+        /// </summary>
+        [JsonProperty("user_metadata")]
+        public dynamic UserMetadata { get; set; }
+
+        /// <summary>
+        /// Number of seconds for which the invitation is valid before expiration.
+        /// </summary>
+        /// <remarks>
+        /// If unspecified or set to 0, this value defaults to 604800 seconds (7 days). Max value: 2592000 seconds (30 days).
+        /// </remarks>
+        [JsonProperty("ttl_sec")]
+        public int TimeToLive { get; set; }
+
+        /// <summary>
+        /// Whether the user will receive an invitation email (true) or no email (false), true by default
+        /// </summary>
+        [JsonProperty("send_invitation_email")]
+        public bool SendInvitationEmail { get; set; }
+
+        /// <summary>
+        /// List of role IDs to associated with the user.
+        /// </summary>
+        [JsonProperty("roles")]
+        public IList<string> Roles { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationCreateRequest.cs

@@ -0,0 +1,16 @@
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
+using Newtonsoft.Json.Linq;
+using System;
+using System.Collections.Generic;
+
+namespace Auth0.ManagementApi.Models
+{
+    /// <summary>
+    /// Requests structure for creating a new organization.
+    /// </summary>
+    public class OrganizationCreateRequest : OrganizationBase
+    {
+
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationDeleteMemberRolesRequest.cs

@@ -0,0 +1,14 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationDeleteMemberRolesRequest
+    {
+        /// <summary>
+        /// List of role IDs to remove from the user.
+        /// </summary>
+        [JsonProperty("roles")]
+        public IList<string> Roles { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationDeleteMembersRequest.cs

@@ -0,0 +1,14 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationDeleteMembersRequest
+    {
+        /// <summary>
+        /// List of user IDs to remove from the organization as members.
+        /// </summary>
+        [JsonProperty("members")]
+        public IList<string> Members { get; set; }
+    }
+}

src/Auth0.ManagementApi/Models/OrganizationGetAllRequest.cs

@@ -0,0 +1,14 @@
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationGetAllRequest : OrganizationGetRequest
+    {
+        /// <summary>
+        /// Field to sort by.
+        /// </summary>
+        /// <remarks>
+        /// Use field:order where order is 1 for ascending and -1 for descending Defaults to created_at:-1.
+        /// </remarks>
+        public string Sort { get; set; } = null;
+
+    }
+}