public API for organization import (#707)

src/Core/Models/Api/Public/Request/OrganizationImportRequestModel.cs

@@ -0,0 +1,104 @@
+using Bit.Core.Models.Business;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+
+namespace Bit.Core.Models.Api.Public
+{
+    public class OrganizationImportRequestModel
+    {
+        /// <summary>
+        /// Groups to import.
+        /// </summary>
+        public OrganizationImportGroupRequestModel[] Groups { get; set; }
+        /// <summary>
+        /// Members to import.
+        /// </summary>
+        public OrganizationImportMemberRequestModel[] Members { get; set; }
+        /// <summary>
+        /// Determines if the data in this request should overwrite or append to the existing organization data.
+        /// </summary>
+        [Required]
+        public bool? OverwriteExisting { get; set; }
+
+        public class OrganizationImportGroupRequestModel
+        {
+            /// <summary>
+            /// The name of the group.
+            /// </summary>
+            /// <example>Development Team</example>
+            [Required]
+            [StringLength(100)]
+            public string Name { get; set; }
+            /// <summary>
+            /// External identifier for reference or linking this group to another system, such as a user directory.
+            /// </summary>
+            /// <example>external_id_123456</example>
+            [Required]
+            [StringLength(300)]
+            public string ExternalId { get; set; }
+            /// <summary>
+            /// The associated external ids for members in this group.
+            /// </summary>
+            public IEnumerable<string> MemberExternalIds { get; set; }
+
+            public ImportedGroup ToImportedGroup(Guid organizationId)
+            {
+                var importedGroup = new ImportedGroup
+                {
+                    Group = new Table.Group
+                    {
+                        OrganizationId = organizationId,
+                        Name = Name,
+                        ExternalId = ExternalId
+                    },
+                    ExternalUserIds = new HashSet<string>(MemberExternalIds)
+                };
+
+                return importedGroup;
+            }
+        }
+
+        public class OrganizationImportMemberRequestModel : IValidatableObject
+        {
+            /// <summary>
+            /// The member's email address. Required for non-deleted users.
+            /// </summary>
+            /// <example>jsmith@example.com</example>
+            [EmailAddress]
+            [StringLength(50)]
+            public string Email { get; set; }
+            /// <summary>
+            /// External identifier for reference or linking this member to another system, such as a user directory.
+            /// </summary>
+            /// <example>external_id_123456</example>
+            [Required]
+            [StringLength(300)]
+            public string ExternalId { get; set; }
+            /// <summary>
+            /// Determines if this member should be removed from the organization during import.
+            /// </summary>
+            public bool Deleted { get; set; }
+
+            public ImportedOrganizationUser ToImportedOrganizationUser()
+            {
+                var importedUser = new ImportedOrganizationUser
+                {
+                    Email = Email.ToLowerInvariant(),
+                    ExternalId = ExternalId
+                };
+
+                return importedUser;
+            }
+
+            public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
+            {
+                if (string.IsNullOrWhiteSpace(Email) && !Deleted)
+                {
+                    yield return new ValidationResult("Email is required for enabled members.",
+                        new string[] { nameof(Email) });
+                }
+            }
+        }
+    }
+}

src/Core/Services/IOrganizationService.cs

@@ -45,7 +45,7 @@ namespace Bit.Core.Services
         Task UpdateUserGroupsAsync(OrganizationUser organizationUser, IEnumerable<Guid> groupIds);
         Task<OrganizationLicense> GenerateLicenseAsync(Guid organizationId, Guid installationId);
         Task<OrganizationLicense> GenerateLicenseAsync(Organization organization, Guid installationId);
-        Task ImportAsync(Guid organizationId, Guid importingUserId, IEnumerable<ImportedGroup> groups,
+        Task ImportAsync(Guid organizationId, Guid? importingUserId, IEnumerable<ImportedGroup> groups,
             IEnumerable<ImportedOrganizationUser> newUsers, IEnumerable<string> removeUserExternalIds,
             bool overwriteExisting);
         Task RotateApiKeyAsync(Organization organization);

src/Core/Services/Implementations/OrganizationService.cs

@@ -1214,7 +1214,7 @@ namespace Bit.Core.Services
         }
 
         public async Task ImportAsync(Guid organizationId,
-            Guid importingUserId,
+            Guid? importingUserId,
             IEnumerable<ImportedGroup> groups,
             IEnumerable<ImportedOrganizationUser> newUsers,
             IEnumerable<string> removeUserExternalIds,