Hub: add per instance summary api

Author: webprofusion-chrisc

src/Certify.Server/Certify.Server.Hub.Api.Client/Certify.Server.Hub.Api.Client.cs

@@ -1889,8 +1889,7 @@ public virtual async System.Threading.Tasks.Task<StatusSummary> GetManagedCertif
             {
                 using (var request_ = new System.Net.Http.HttpRequestMessage())
                 {
-                    request_.Content = new System.Net.Http.StringContent(string.Empty, System.Text.Encoding.UTF8, "application/json");
-                    request_.Method = new System.Net.Http.HttpMethod("POST");
+                    request_.Method = new System.Net.Http.HttpMethod("GET");
                     request_.Headers.Accept.Add(System.Net.Http.Headers.MediaTypeWithQualityHeaderValue.Parse("text/plain"));
 
                     var urlBuilder_ = new System.Text.StringBuilder();
@@ -1950,6 +1949,95 @@ public virtual async System.Threading.Tasks.Task<StatusSummary> GetManagedCertif
             }
         }
 
+        /// <summary>
+        /// Retrieves the summary of a managed certificate for a specific instance using the provided instance ID.
+        /// </summary>
+        /// <returns>OK</returns>
+        /// <exception cref="ApiException">A server side error occurred.</exception>
+        public virtual System.Threading.Tasks.Task<StatusSummary> GetInstanceManagedCertificateSummaryAsync(string instanceId)
+        {
+            return GetInstanceManagedCertificateSummaryAsync(instanceId, System.Threading.CancellationToken.None);
+        }
+
+        /// <param name="cancellationToken">A cancellation token that can be used by other objects or threads to receive notice of cancellation.</param>
+        /// <summary>
+        /// Retrieves the summary of a managed certificate for a specific instance using the provided instance ID.
+        /// </summary>
+        /// <returns>OK</returns>
+        /// <exception cref="ApiException">A server side error occurred.</exception>
+        public virtual async System.Threading.Tasks.Task<StatusSummary> GetInstanceManagedCertificateSummaryAsync(string instanceId, System.Threading.CancellationToken cancellationToken)
+        {
+            if (instanceId == null)
+                throw new System.ArgumentNullException("instanceId");
+
+            var client_ = _httpClient;
+            var disposeClient_ = false;
+            try
+            {
+                using (var request_ = new System.Net.Http.HttpRequestMessage())
+                {
+                    request_.Method = new System.Net.Http.HttpMethod("GET");
+                    request_.Headers.Accept.Add(System.Net.Http.Headers.MediaTypeWithQualityHeaderValue.Parse("text/plain"));
+
+                    var urlBuilder_ = new System.Text.StringBuilder();
+                    if (!string.IsNullOrEmpty(_baseUrl)) urlBuilder_.Append(_baseUrl);
+                    // Operation Path: "api/v1/certificate/{instanceId}/summary"
+                    urlBuilder_.Append("api/v1/certificate/");
+                    urlBuilder_.Append(System.Uri.EscapeDataString(ConvertToString(instanceId, System.Globalization.CultureInfo.InvariantCulture)));
+                    urlBuilder_.Append("/summary");
+
+                    PrepareRequest(client_, request_, urlBuilder_);
+
+                    var url_ = urlBuilder_.ToString();
+                    request_.RequestUri = new System.Uri(url_, System.UriKind.RelativeOrAbsolute);
+
+                    PrepareRequest(client_, request_, url_);
+
+                    var response_ = await client_.SendAsync(request_, System.Net.Http.HttpCompletionOption.ResponseHeadersRead, cancellationToken).ConfigureAwait(false);
+                    var disposeResponse_ = true;
+                    try
+                    {
+                        var headers_ = new System.Collections.Generic.Dictionary<string, System.Collections.Generic.IEnumerable<string>>();
+                        foreach (var item_ in response_.Headers)
+                            headers_[item_.Key] = item_.Value;
+                        if (response_.Content != null && response_.Content.Headers != null)
+                        {
+                            foreach (var item_ in response_.Content.Headers)
+                                headers_[item_.Key] = item_.Value;
+                        }
+
+                        ProcessResponse(client_, response_);
+
+                        var status_ = (int)response_.StatusCode;
+                        if (status_ == 200)
+                        {
+                            var objectResponse_ = await ReadObjectResponseAsync<StatusSummary>(response_, headers_, cancellationToken).ConfigureAwait(false);
+                            if (objectResponse_.Object == null)
+                            {
+                                throw new ApiException("Response was null which was not expected.", status_, objectResponse_.Text, headers_, null);
+                            }
+                            return objectResponse_.Object;
+                        }
+                        else
+                        {
+                            var responseData_ = response_.Content == null ? null : await response_.Content.ReadAsStringAsync().ConfigureAwait(false);
+                            throw new ApiException("The HTTP status code of the response was not expected (" + status_ + ").", status_, responseData_, headers_, null);
+                        }
+                    }
+                    finally
+                    {
+                        if (disposeResponse_)
+                            response_.Dispose();
+                    }
+                }
+            }
+            finally
+            {
+                if (disposeClient_)
+                    client_.Dispose();
+            }
+        }
+
         /// <summary>
         /// Gets the full settings for a specific managed certificate
         /// </summary>

src/Certify.Server/Certify.Server.Hub.Api/Controllers/v1/CertificateController.cs

@@ -223,7 +223,7 @@ public async Task<IActionResult> GetManagedCertificates(string? keyword, int? pa
         /// Get summary counts of all managed certs
         /// </summary>
         /// <returns></returns>
-        [HttpPost]
+        [HttpGet]
         [Route("summary")]
         [Authorize(AuthenticationSchemes = JwtBearerDefaults.AuthenticationScheme)]
         [ProducesResponseType(StatusCodes.Status200OK, Type = typeof(StatusSummary))]
@@ -233,6 +233,20 @@ public async Task<IActionResult> GetManagedCertificateSummary()
             return new OkObjectResult(summary);
         }
 
+        /// <summary>
+        /// Retrieves the summary of a managed certificate for a specific instance using the provided instance ID.
+        /// </summary>
+        /// <returns>Returns an IActionResult containing the summary of the managed certificate.</returns>
+        [HttpGet]
+        [Route("{instanceId}/summary")]
+        [Authorize(AuthenticationSchemes = JwtBearerDefaults.AuthenticationScheme)]
+        [ProducesResponseType(StatusCodes.Status200OK, Type = typeof(StatusSummary))]
+        public async Task<IActionResult> GetInstanceManagedCertificateSummary(string instanceId)
+        {
+            var summary = await _mgmtAPI.GetManagedCertificateSummary(instanceId, CurrentAuthContext);
+            return new OkObjectResult(summary);
+        }
+
         /// <summary>
         /// Gets the full settings for a specific managed certificate
         /// </summary>

src/Certify.Server/Certify.Server.Hub.Api/Services/ManagementAPI.cs

@@ -278,6 +278,19 @@ public async Task<StatusSummary> GetManagedCertificateSummary(AuthContext? curre
             return await Task.FromResult(sum);
         }
 
+        /// <summary>
+        /// Gets a summary of the statuses of all managed certificates.
+        /// </summary>
+        /// <param name="instanceId"></param>
+        /// <param name="currentAuthContext">The current authentication context.</param>
+        /// <returns>A <see cref="StatusSummary"/> summarizing certificate statuses.</returns>
+        public async Task<StatusSummary?> GetManagedCertificateSummary(string instanceId, AuthContext? currentAuthContext)
+        {
+            var summary = _mgmtStateProvider.GetManagedInstanceStatusSummary(instanceId);
+
+            return await Task.FromResult(summary);
+        }
+
         /// <summary>
         /// Retrieves the certificate authorities from the target instance.
         /// </summary>

src/Certify.Server/Certify.Server.Hub.Api/SignalR/ManagementHub/InstanceManagementStateProvider.cs

@@ -39,6 +39,7 @@ public interface IInstanceManagementStateProvider
 
         bool HasStatusSummaryForManagedInstance(string instanceId);
         ConcurrentDictionary<string, StatusSummary> GetManagedInstanceStatusSummaries();
+        StatusSummary? GetManagedInstanceStatusSummary(string instanceId);
         void UpdateInstanceConnectionStatus(string instanceId, string status);
 
         void AddOrUpdateSystemStatusItem(ActionStep status);
@@ -295,6 +296,16 @@ public ConcurrentDictionary<string, StatusSummary> GetManagedInstanceStatusSumma
             return _managedInstanceStatusSummary;
         }
 
+        /// <summary>
+        /// Retrieves the status summary of a managed instance based on its identifier.
+        /// </summary>
+        /// <param name="instanceId">The identifier used to locate the specific managed instance's status summary.</param>
+        /// <returns>Returns the status summary associated with the specified managed instance, or null if not found.</returns>
+        public StatusSummary? GetManagedInstanceStatusSummary(string instanceId)
+        {
+            return _managedInstanceStatusSummary.FirstOrDefault(s => s.Key == instanceId).Value;
+        }
+
         /// <summary>
         /// Update a cached managed certificate item for a given instance
         /// </summary>