public policy apis

src/Api/Public/Controllers/PoliciesController.cs

@@ -0,0 +1,135 @@
+using System;
+using System.Linq;
+using System.Net;
+using System.Threading.Tasks;
+using Bit.Core;
+using Bit.Core.Models.Api.Public;
+using Bit.Core.Repositories;
+using Bit.Core.Services;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Bit.Api.Public.Controllers
+{
+    [Route("public/policies")]
+    [Authorize("Organization")]
+    public class PoliciesController : Controller
+    {
+        private readonly IPolicyRepository _policyRepository;
+        private readonly IPolicyService _policyService;
+        private readonly CurrentContext _currentContext;
+
+        public PoliciesController(
+            IPolicyRepository policyRepository,
+            IPolicyService policyService,
+            CurrentContext currentContext)
+        {
+            _policyRepository = policyRepository;
+            _policyService = policyService;
+            _currentContext = currentContext;
+        }
+
+        /// <summary>
+        /// Retrieve a policy.
+        /// </summary>
+        /// <remarks>
+        /// Retrieves the details of an existing policy. You need only supply the unique group identifier
+        /// that was returned upon policy creation.
+        /// </remarks>
+        /// <param name="id">The identifier of the policy to be retrieved.</param>
+        [HttpGet("{id}")]
+        [ProducesResponseType(typeof(GroupResponseModel), (int)HttpStatusCode.OK)]
+        [ProducesResponseType((int)HttpStatusCode.NotFound)]
+        public async Task<IActionResult> Get(Guid id)
+        {
+            var policy = await _policyRepository.GetByIdAsync(id);
+            if(policy == null || policy.OrganizationId != _currentContext.OrganizationId)
+            {
+                return new NotFoundResult();
+            }
+            var response = new PolicyResponseModel(policy);
+            return new JsonResult(response);
+        }
+
+        /// <summary>
+        /// List all policies.
+        /// </summary>
+        /// <remarks>
+        /// Returns a list of your organization's policies.
+        /// </remarks>
+        [HttpGet]
+        [ProducesResponseType(typeof(ListResponseModel<PolicyResponseModel>), (int)HttpStatusCode.OK)]
+        public async Task<IActionResult> List()
+        {
+            var policies = await _policyRepository.GetManyByOrganizationIdAsync(_currentContext.OrganizationId.Value);
+            var policyResponses = policies.Select(p => new PolicyResponseModel(p));
+            var response = new ListResponseModel<PolicyResponseModel>(policyResponses);
+            return new JsonResult(response);
+        }
+
+        /// <summary>
+        /// Create a policy.
+        /// </summary>
+        /// <remarks>
+        /// Creates a new policy object.
+        /// </remarks>
+        /// <param name="model">The request model.</param>
+        [HttpPost]
+        [ProducesResponseType(typeof(PolicyResponseModel), (int)HttpStatusCode.OK)]
+        [ProducesResponseType(typeof(ErrorResponseModel), (int)HttpStatusCode.BadRequest)]
+        public async Task<IActionResult> Post([FromBody]PolicyCreateRequestModel model)
+        {
+            var policy = model.ToPolicy(_currentContext.OrganizationId.Value);
+            await _policyService.SaveAsync(policy);
+            var response = new PolicyResponseModel(policy);
+            return new JsonResult(response);
+        }
+
+        /// <summary>
+        /// Update a policy.
+        /// </summary>
+        /// <remarks>
+        /// Updates the specified policy object. If a property is not provided,
+        /// the value of the existing property will be reset.
+        /// </remarks>
+        /// <param name="id">The identifier of the policy to be updated.</param>
+        /// <param name="model">The request model.</param>
+        [HttpPut("{id}")]
+        [ProducesResponseType(typeof(PolicyResponseModel), (int)HttpStatusCode.OK)]
+        [ProducesResponseType(typeof(ErrorResponseModel), (int)HttpStatusCode.BadRequest)]
+        [ProducesResponseType((int)HttpStatusCode.NotFound)]
+        public async Task<IActionResult> Put(Guid id, [FromBody]PolicyUpdateRequestModel model)
+        {
+            var existingPolicy = await _policyRepository.GetByIdAsync(id);
+            if(existingPolicy == null || existingPolicy.OrganizationId != _currentContext.OrganizationId)
+            {
+                return new NotFoundResult();
+            }
+            var updatedPolicy = model.ToPolicy(existingPolicy);
+            await _policyService.SaveAsync(updatedPolicy);
+            var response = new PolicyResponseModel(updatedPolicy);
+            return new JsonResult(response);
+        }
+
+        /// <summary>
+        /// Delete a policy.
+        /// </summary>
+        /// <remarks>
+        /// Permanently deletes a policy. This cannot be undone.
+        /// </remarks>
+        /// <param name="id">The identifier of the policy to be deleted.</param>
+        [HttpDelete("{id}")]
+        [ProducesResponseType((int)HttpStatusCode.OK)]
+        [ProducesResponseType((int)HttpStatusCode.NotFound)]
+        public async Task<IActionResult> Delete(Guid id)
+        {
+            var policy = await _policyRepository.GetByIdAsync(id);
+            if(policy == null || policy.OrganizationId != _currentContext.OrganizationId)
+            {
+                return new NotFoundResult();
+            }
+            await _policyRepository.DeleteAsync(policy);
+            return new OkResult();
+        }
+    }
+}

src/Core/Models/Api/Public/PolicyBaseModel.cs

@@ -0,0 +1,19 @@
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+
+namespace Bit.Core.Models.Api.Public
+{
+    public abstract class PolicyBaseModel
+    {
+        /// <summary>
+        /// Determines if this policy is enabled and enforced.
+        /// </summary>
+        [Required]
+        public bool? Enabled { get; set; }
+        /// <summary>
+        /// Data for the policy.
+        /// </summary>
+        [StringLength(300)]
+        public Dictionary<string, object> Data { get; set; }
+    }
+}

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

@@ -0,0 +1,23 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using Bit.Core.Models.Table;
+
+namespace Bit.Core.Models.Api.Public
+{
+    public class PolicyCreateRequestModel : PolicyUpdateRequestModel
+    {
+        /// <summary>
+        /// The type of policy.
+        /// </summary>
+        [Required]
+        public Enums.PolicyType? Type { get; set; }
+
+        public Policy ToPolicy(Guid orgId)
+        {
+            return ToPolicy(new Policy
+            {
+                OrganizationId = orgId
+            });
+        }
+    }
+}

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

@@ -0,0 +1,15 @@
+using Bit.Core.Models.Table;
+using Newtonsoft.Json;
+
+namespace Bit.Core.Models.Api.Public
+{
+    public class PolicyUpdateRequestModel : PolicyBaseModel
+    {
+        public virtual Policy ToPolicy(Policy existingPolicy)
+        {
+            existingPolicy.Enabled = Enabled.GetValueOrDefault();
+            existingPolicy.Data = Data != null ? JsonConvert.SerializeObject(Data) : null;
+            return existingPolicy;
+        }
+    }
+}

src/Core/Models/Api/Public/Response/PolicyResponseModel.cs

@@ -0,0 +1,48 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+using Bit.Core.Models.Table;
+using Newtonsoft.Json;
+
+namespace Bit.Core.Models.Api.Public
+{
+    /// <summary>
+    /// A policy.
+    /// </summary>
+    public class PolicyResponseModel : PolicyBaseModel, IResponseModel
+    {
+        public PolicyResponseModel(Policy policy)
+        {
+            if(policy == null)
+            {
+                throw new ArgumentNullException(nameof(policy));
+            }
+
+            Id = policy.Id;
+            Type = policy.Type;
+            Enabled = policy.Enabled;
+            if(!string.IsNullOrWhiteSpace(policy.Data))
+            {
+                Data = JsonConvert.DeserializeObject<Dictionary<string, object>>(policy.Data);
+            }
+        }
+
+        /// <summary>
+        /// String representing the object's type. Objects of the same type share the same properties.
+        /// </summary>
+        /// <example>policy</example>
+        [Required]
+        public string Object => "policy";
+        /// <summary>
+        /// The policy's unique identifier.
+        /// </summary>
+        /// <example>539a36c5-e0d2-4cf9-979e-51ecf5cf6593</example>
+        [Required]
+        public Guid Id { get; set; }
+        /// <summary>
+        /// The type of policy.
+        /// </summary>
+        [Required]
+        public Enums.PolicyType? Type { get; set; }
+    }
+}