last ...

Configurations/XIdentityConfiguration.cs

@@ -1,5 +1,5 @@
-using System.Collections.Generic;
 using xIdentityModels.Dtos;
+using System.Collections.Generic;
 
 namespace xIdentityModels.Configurations {
     public class XIdentityConfiguration {

Constants/XApiKeyScope.cs

@@ -0,0 +1,19 @@
+using xExceptions.Attributes;
+
+namespace xIdentityModels.Constants
+{
+    public enum XApiKeyScope
+    {
+        [StringValue("read")]
+        Read,
+
+        [StringValue("write")]
+        Write,
+
+        [StringValue("admin")]
+        Admin,
+
+        [StringValue("manage")]
+        Manage
+    }
+}

Constants/XApplicationType.cs

@@ -0,0 +1,7 @@
+namespace xIdentityModels.Constants
+{
+    public enum XApplicationType
+    {
+        Web, Mobile, Desktop, IoT, ThirdParty, Service
+    }
+}

Dtos/XApiKeyDto.cs

@@ -0,0 +1,74 @@
+using System;
+using xModels.Base;
+
+namespace xIdentityModels.Dtos
+{
+    /// <summary>
+    /// an Specified Api Key ...
+    /// </summary>
+    public class XApiKeyDto : XBaseGuidIDEntityDto
+    {
+        /// <summary>
+        /// Related Application Id ...
+        /// </summary>
+        public int ApplicationId { get; set; }
+
+        /// <summary>
+        /// Hash ...
+        /// SHA256 of ApiKey ...
+        /// </summary>
+        public string KeyHash { get; set; }
+
+        /// <summary>
+        /// a Prefix ...
+        /// </summary>
+        public string KeyPrefix { get; set; }
+
+        /// <summary>
+        /// Expiration Type ...
+        /// </summary>
+        public DateTime ExpiresAt { get; set; }
+
+        /// <summary>
+        /// Cration Time ...
+        /// </summary>
+        public DateTime CreatedOn { get; set; }
+
+        /// <summary>
+        /// Last Usage Date ...
+        /// </summary>
+        public DateTime? LastUsedAt { get; set; }
+
+        /// <summary>
+        /// Revoked Time ...
+        /// </summary>
+        public DateTime? RevokedAt { get; set; }
+
+        /// <summary>
+        /// Revoker User Id ...
+        /// </summary>
+        public string RevokedBy { get; set; }
+
+        /// <summary>
+        /// a Json Array String ...
+        /// XApiKeyScope ...
+        /// </summary>
+        public string AllowedScopes { get; set; }
+
+        /// <summary>
+        /// a Comma-separated List which Specified White List IP ...
+        /// </summary>
+        public string AllowedIPs { get; set; }
+
+        /// <summary>
+        /// Rate Limit Per Minute ...
+        /// </summary>
+        public int RateLimitPerMinute { get; set; } = 60;
+
+        // 
+        /// <summary>
+        /// Related Application ...
+        /// </summary>
+        public virtual XApplicationDto Application { get; set; }
+    }
+}

Dtos/XApiKeyUsageDto.cs

@@ -0,0 +1,43 @@
+using System;
+using xModels.Base;
+
+namespace xIdentityModels.Dtos
+{
+    public class XApiKeyUsageDto : XBaseLongIDEntityDto
+    {
+        /// <summary>
+        /// Api Key Id ...
+        /// </summary>
+        public Guid ApiKeyId { get; set; }
+
+        /// <summary>
+        /// Called Endpoint ...
+        /// </summary>
+        public string Endpoint { get; set; }
+
+        /// <summary>
+        /// Called Http Method ...
+        /// </summary>
+        public string HttpMethod { get; set; }
+
+        /// <summary>
+        /// Client IP Address ...
+        /// </summary>
+        public string ClientIP { get; set; }
+
+        /// <summary>
+        /// Status Code ...
+        /// </summary>
+        public int StatusCode { get; set; }
+
+        /// <summary>
+        /// Request Time ...
+        /// </summary>
+        public DateTime RequestedOn { get; set; }
+
+        /// <summary>
+        /// Response Time in Milliseconds ...
+        /// </summary>
+        public long ResponseTimeMs { get; set; }        
+    }
+}

Dtos/XApplicationDto.cs

@@ -0,0 +1,49 @@
+using System;
+using xModels.Base;
+using xModels.Dtos;
+using xIdentityModels.Constants;
+
+namespace xIdentityModels.Dtos
+{
+    /// <summary>
+    /// an Application in xDashboard ...
+    /// </summary>
+    public class XApplicationDto : XBaseIntIDEntityDto
+    {
+        /// <summary>
+        /// Name ...
+        /// </summary>
+        public string Name { get; set; }
+
+        /// <summary>
+        /// Descriptor ...
+        /// </summary>
+        public string Description { get; set; }
+
+        /// <summary>
+        /// Owner Id ...
+        /// </summary>
+        public string OwnerId { get; set; }
+        public virtual XPersonDto Owner { get; set; }
+
+        /// <summary>
+        /// Application Type ...
+        /// </summary>
+        public XApplicationType Type { get; set; }
+
+        /// <summary>
+        /// Specified Application is Active or not ...
+        /// </summary>
+        public bool IsActive { get; set; } = true;
+
+        /// <summary>
+        /// Application Create Time ...
+        /// </summary>
+        public DateTime CreatedOn { get; set; }
+
+        /// <summary>
+        /// Application Update Type ...
+        /// </summary>
+        public DateTime UpdatedAt { get; set; }
+    }
+}

Dtos/XDiscoveryDocumentDto.cs

@@ -1,5 +1,5 @@
-using System.Collections.Generic;
 using Newtonsoft.Json;
+using System.Collections.Generic;
 
 namespace xIdentityModels.Dtos
 {

Dtos/XFriendDto.cs

@@ -1,5 +1,5 @@
-using xIdentityModels.Constants;
 using xModels.Base;
+using xIdentityModels.Constants;
 
 namespace xIdentityModels.Dtos
 {

Dtos/XOpenActionDto.cs

@@ -1,7 +1,7 @@
 using System;
-using xCommons.Extensions;
 using xModels.Base;
 using xModels.Dtos;
+using xCommons.Extensions;
 
 namespace xIdentityModels.Dtos
 {

Dtos/XProfileImageDto.cs

@@ -1,6 +1,6 @@
 using System;
-using Newtonsoft.Json;
 using xModels.Base;
+using Newtonsoft.Json;
 
 namespace xIdentityModels.Dtos {
     public class XProfileImageDto : XBaseDto {

Dtos/XUserNameIdRequest.cs

@@ -1,5 +1,5 @@
-using System.Collections.Generic;
 using xModels.Base;
+using System.Collections.Generic;
 
 namespace xIdentityModels.Dtos {
     public class XUserNameIdRequest : XBaseDto {

Dtos/XUserProfileDto.cs

@@ -1,8 +1,8 @@
 using System;
-using System.Collections.Generic;
+using xModels.Base;
 using Newtonsoft.Json;
 using xIdentityModels.Constants;
-using xModels.Base;
+using System.Collections.Generic;
 
 namespace xIdentityModels.Dtos {
     public class XUserProfileDto : XBaseDto {

Extensions/DIExtensions.cs

@@ -1,7 +1,7 @@
-using Microsoft.Extensions.DependencyInjection;
 using xCommons.Extensions;
-using xIdentityModels.Interfaces;
 using xIdentityModels.Providers;
+using xIdentityModels.Interfaces;
+using Microsoft.Extensions.DependencyInjection;
 
 namespace xIdentityModels.Extensions {
     public static class DIExtensions {
@@ -10,6 +10,7 @@ namespace xIdentityModels.Extensions {
         /// user not provided we create this helper ...
         /// </summary>
         /// <param name="services"></param>
+        /// <param name="helper"></param>
         public static void AddXUserRoleHandler (
             this IServiceCollection services,
             IXUserRoleHelper helper = null

Extensions/XIdentityExtensions.cs

@@ -1,8 +1,8 @@
-using System.Collections.Generic;
 using xCommons.Extensions;
 using xExceptions.Constants;
-using xIdentityModels.Constants;
 using xIdentityModels.Models;
+using xIdentityModels.Constants;
+using System.Collections.Generic;
 
 namespace xIdentityModels.Extensions {
     public static class XIdentityExtensions {

Extensions/XModelExtensions.cs

@@ -1,8 +1,8 @@
 using System;
-using System.Collections.Generic;
 using xCommons.Extensions;
-using xIdentityModels.Descriptors;
 using xIdentityModels.Models;
+using System.Collections.Generic;
+using xIdentityModels.Descriptors;
 using xIdentityModels.Navigations;
 
 namespace xIdentityModels.Extensions {

Extensions/XTokenExtensions.cs

@@ -1,20 +1,20 @@
 using System;
-using System.IdentityModel.Tokens.Jwt;
 using System.Linq;
 using System.Net.Http;
-using System.Net.Http.Headers;
-using System.Security.Claims;
-using System.Threading.Tasks;
-using IdentityModel.Client;
-using Microsoft.AspNetCore.Authentication;
-using Microsoft.AspNetCore.Http;
-using Microsoft.AspNetCore.Mvc.Filters;
-using Microsoft.IdentityModel.Tokens;
 using xCommons.Constants;
 using xCommons.Extensions;
+using IdentityModel.Client;
 using xExceptions.Constants;
-using xIdentityModels.Constants;
+using System.Security.Claims;
+using System.Threading.Tasks;
 using xIdentityModels.Models;
+using System.Net.Http.Headers;
+using Microsoft.AspNetCore.Http;
+using xIdentityModels.Constants;
+using Microsoft.IdentityModel.Tokens;
+using System.IdentityModel.Tokens.Jwt;
+using Microsoft.AspNetCore.Mvc.Filters;
+using Microsoft.AspNetCore.Authentication;
 
 namespace xIdentityModels.Extensions {
     public static class XTokenExtensions {
@@ -440,6 +440,7 @@ namespace xIdentityModels.Extensions {
         /// </summary>
         /// <param name="source"></param>
         /// <param name="model"></param>
+        /// <param name="secret"></param>
         public static void SetXAuthenticationTokens (
             this IHeaderDictionary source,
             XLoginResponse model,
@@ -469,6 +470,7 @@ namespace xIdentityModels.Extensions {
         /// </summary>
         /// <param name="source"></param>
         /// <param name="model"></param>
+        /// <param name="secret"></param>
         public static void SetXAuthenticationTokens (
             this IHeaderDictionary source,
             XTokenResponse model,
@@ -596,6 +598,7 @@ namespace xIdentityModels.Extensions {
         /// </summary>
         /// <param name="source"></param>
         /// <param name="model"></param>
+        /// <param name="secret"></param>
         public static void SetXAuthenticationTokens (
             this HttpResponse source,
             XLoginResponse model,
@@ -612,6 +615,7 @@ namespace xIdentityModels.Extensions {
         /// </summary>
         /// <param name="source"></param>
         /// <param name="model"></param>
+        /// <param name="secret"></param>
         public static void SetXAuthenticationTokens (
             this HttpResponse source,
             XTokenResponse model,

Extensions/xIdentityModelsExtensions.cs

@@ -1,10 +1,12 @@
-using System.Collections.Generic;
 using System.Linq;
 using xCommons.Extensions;
-using xIdentityModels.Configurations;
-using xIdentityModels.Constants;
 using xIdentityModels.Dtos;
 using xIdentityModels.Models;
+using xIdentityModels.Constants;
+using System.Collections.Generic;
+using xIdentityModels.Configurations;
+using Microsoft.OpenApi.Expressions;
+using System;
 
 namespace xIdentityModels.Extensions
 {
@@ -161,7 +163,7 @@ namespace xIdentityModels.Extensions
         )
         {
             //
-            var result = 
+            var result =
                 !source.IsNullOrDefault() &&
                 source.Roles
                     .Any(r => roles
@@ -195,5 +197,54 @@ namespace xIdentityModels.Extensions
             //
             return result;
         }
+
+        /// <summary>
+        /// Check Specified Api Key is Revoked or not ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <returns></returns>
+        public static bool IsRevoked(this XApiKey source)
+        {
+            //
+            var result = 
+                !source.IsNullOrDefault() &&
+                source.RevokedAt.HasValue;
+
+            //
+            return result;
+        }
+
+        /// <summary>
+        /// Check Specified Api Key is Expired or not ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <returns></returns>
+        public static bool IsExpired(this XApiKey source)
+        {
+            //
+            var result =
+                !source.IsNullOrDefault() &&
+                DateTime.UtcNow >= source.ExpiresAt;
+
+            //
+            return result;
+        }
+
+        /// <summary>
+        /// Check Specified Api Key is Active or not ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <returns></returns>
+        public static bool IsActive(this XApiKey source)
+        {
+            //
+            var result =
+                !source.IsNullOrDefault() &&
+                !source.IsRevoked() &&
+                !source.IsExpired();
+
+            //
+            return result;
+        }
     }
 }

Models/XApiKey.cs

@@ -0,0 +1,84 @@
+using System;
+using xModels.Base;
+using System.ComponentModel.DataAnnotations;
+
+namespace xIdentityModels.Models
+{
+    /// <summary>
+    /// an Specified Api Key ...
+    /// </summary>
+    public class XApiKey : XBaseGuidIDEntity
+    {
+        /// <summary>
+        /// Related Application Id ...
+        /// </summary>
+        [Required]
+        public int ApplicationId { get; set; }
+
+        /// <summary>
+        /// Hash ...
+        /// SHA256 of ApiKey ...
+        /// </summary>
+        [Required]
+        [StringLength(512)]
+        public string KeyHash { get; set; }
+
+        /// <summary>
+        /// a Prefix ...
+        /// </summary>
+        [StringLength(100)]
+        public string KeyPrefix { get; set; }
+
+        /// <summary>
+        /// Expiration Type ...
+        /// </summary>
+        [Required]
+        public DateTime ExpiresAt { get; set; }
+
+        /// <summary>
+        /// Cration Time ...
+        /// </summary>
+        public DateTime CreatedOn { get; set; }
+
+        /// <summary>
+        /// Last Usage Date ...
+        /// </summary>
+        public DateTime? LastUsedAt { get; set; }
+
+        /// <summary>
+        /// Revoked Time ...
+        /// </summary>
+        public DateTime? RevokedAt { get; set; }
+
+        /// <summary>
+        /// Revoker User Id ...
+        /// </summary>
+        public string RevokedBy { get; set; }
+
+        /// <summary>
+        /// a Json Array String ...
+        /// XApiKeyScope ...
+        /// </summary>
+        [StringLength(1000)]
+        public string AllowedScopes { get; set; }
+
+        /// <summary>
+        /// a Comma-separated List which Specified White List IP ...
+        /// </summary>
+        [StringLength(2000)]
+        public string AllowedIPs { get; set; }
+
+        /// <summary>
+        /// Rate Limit Per Minute ...
+        /// </summary>
+        public int RateLimitPerMinute { get; set; } = 60;
+
+        // 
+        #region Navigation ...
+        /// <summary>
+        /// Related Application ...
+        /// </summary>
+        public virtual XApplication Application { get; set; }
+        #endregion
+    }
+}

Models/XApiKeyUsage.cs

@@ -0,0 +1,43 @@
+using System;
+using xModels.Base;
+
+namespace xIdentityModels.Models
+{
+    public class XApiKeyUsage : XBaseLongIDEntity
+    {
+        /// <summary>
+        /// Api Key Id ...
+        /// </summary>
+        public Guid ApiKeyId { get; set; }
+
+        /// <summary>
+        /// Called Endpoint ...
+        /// </summary>
+        public string Endpoint { get; set; }
+
+        /// <summary>
+        /// Called Http Method ...
+        /// </summary>
+        public string HttpMethod { get; set; }
+
+        /// <summary>
+        /// Client IP Address ...
+        /// </summary>
+        public string ClientIP { get; set; }
+
+        /// <summary>
+        /// Status Code ...
+        /// </summary>
+        public int StatusCode { get; set; }
+
+        /// <summary>
+        /// Request Time ...
+        /// </summary>
+        public DateTime RequestedOn { get; set; }
+
+        /// <summary>
+        /// Response Time in Milliseconds ...
+        /// </summary>
+        public long ResponseTimeMs { get; set; }
+    }
+}

Models/XApplication.cs

@@ -0,0 +1,62 @@
+using System;
+using xModels.Base;
+using xIdentityModels.Constants;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+
+namespace xIdentityModels.Models
+{
+    /// <summary>
+    /// an Application in xDashboard ...
+    /// </summary>
+    public class XApplication : XBaseIntIDEntity
+    {
+        /// <summary>
+        /// Name ...
+        /// </summary>
+        [Required]
+        [StringLength(255)]
+        public string Name { get; set; }
+
+        /// <summary>
+        /// Descriptor ...
+        /// </summary>
+        [StringLength(1000)]
+        public string Description { get; set; }
+
+        /// <summary>
+        /// Owner Id ...
+        /// </summary>
+        [Required]
+        [StringLength(255)]
+        public string OwnerId { get; set; }
+
+        /// <summary>
+        /// Application Type ...
+        /// </summary>
+        public XApplicationType Type { get; set; }
+
+        /// <summary>
+        /// Specified Application is Active or not ...
+        /// </summary>
+        public bool IsActive { get; set; } = true;
+
+        /// <summary>
+        /// Application Create Time ...
+        /// </summary>
+        public DateTime CreatedOn { get; set; }
+
+        /// <summary>
+        /// Application Update Type ...
+        /// </summary>
+        public DateTime UpdatedAt { get; set; }
+
+        // 
+        #region Navigation ...
+        /// <summary>
+        /// a Collection of ApiKeys which Related to this Application ...
+        /// </summary>
+        public virtual ICollection<XApiKey> ApiKeys { get; set; }
+        #endregion
+    }
+}

Models/XBannedDevice.cs

@@ -1,8 +1,8 @@
 using System;
-using System.ComponentModel.DataAnnotations.Schema;
+using xModels.Base;
 using xCommons.Extensions;
 using xIdentityModels.Navigations;
-using xModels.Base;
+using System.ComponentModel.DataAnnotations.Schema;
 
 namespace xIdentityModels.Models {
     public class XBannedDevice : XBaseIntIDEntity {

Models/XLoginRequest.cs

@@ -1,5 +1,5 @@
-using System.ComponentModel.DataAnnotations;
 using xIdentityModels.Navigations;
+using System.ComponentModel.DataAnnotations;
 
 namespace xIdentityModels.Models {
     /// <summary>

Models/XProfileUpdateRequest.cs

@@ -1,6 +1,6 @@
 using System;
-using System.Collections.Generic;
 using xIdentityModels.Constants;
+using System.Collections.Generic;
 
 namespace xIdentityModels.Models {
     public class XProfileUpdateRequest {

Models/XToken.cs

@@ -1,8 +1,8 @@
-using System.ComponentModel.DataAnnotations.Schema;
+using xModels.Base;
 using xCommons.Extensions;
 using xIdentityModels.Constants;
 using xIdentityModels.Navigations;
-using xModels.Base;
+using System.ComponentModel.DataAnnotations.Schema;
 
 namespace xIdentityModels.Models {
     public class XToken : XBaseIntIDEntity {

Models/XUserClaimsInfoDto.cs

@@ -1,13 +1,13 @@
 using System;
-using System.Collections.Generic;
 using System.Linq;
-using System.Security.Claims;
+using xModels.Base;
+using xCommons.Helpers;
 using xCommons.Constants;
 using xCommons.Extensions;
-using xCommons.Helpers;
 using xExceptions.Constants;
+using System.Security.Claims;
 using xIdentityModels.Constants;
-using xModels.Base;
+using System.Collections.Generic;
 
 namespace xIdentityModels.Models
 {

Models/XVerificationRequest.cs

@@ -1,9 +1,9 @@
 using System;
-using System.ComponentModel.DataAnnotations;
-using System.ComponentModel.DataAnnotations.Schema;
+using xModels.Base;
 using xCommons.Extensions;
 using xIdentityModels.Navigations;
-using xModels.Base;
+using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
 
 namespace xIdentityModels.Models {
     public class XVerificationRequest : XBaseIntIDEntity {

Navigations/XDevice.cs

@@ -1,6 +1,6 @@
-using System.ComponentModel.DataAnnotations.Schema;
-using xCommons.Constants;
 using xModels.Base;
+using xCommons.Constants;
+using System.ComponentModel.DataAnnotations.Schema;
 
 namespace xIdentityModels.Navigations {
     /// <summary>

Navigations/XFriendshipFollower.cs

@@ -1,6 +1,6 @@
-using System.ComponentModel.DataAnnotations.Schema;
-using xIdentityModels.Constants;
 using xModels.Base;
+using xIdentityModels.Constants;
+using System.ComponentModel.DataAnnotations.Schema;
 
 namespace xIdentityModels.Navigations {
     /// <summary>

Navigations/XFriendshipFollowing.cs

@@ -1,6 +1,6 @@
-using System.ComponentModel.DataAnnotations.Schema;
-using xIdentityModels.Constants;
 using xModels.Base;
+using xIdentityModels.Constants;
+using System.ComponentModel.DataAnnotations.Schema;
 
 namespace xIdentityModels.Navigations {
     /// <summary>

Navigations/XProfileImage.cs

@@ -1,7 +1,7 @@
 using System;
+using xModels.Base;
 using System.ComponentModel.DataAnnotations;
 using System.ComponentModel.DataAnnotations.Schema;
-using xModels.Base;
 
 namespace xIdentityModels.Navigations {
     /// <summary>

XApiToken.cs

@@ -1,7 +1,7 @@
-using System.ComponentModel.DataAnnotations.Schema;
-using xCommons.Extensions;
 using xModels.Base;
+using xCommons.Extensions;
 using xIdentityModels.Models;
+using System.ComponentModel.DataAnnotations.Schema;
 
 namespace xIdentityModels {
     public class XApiToken : XBaseIntIDEntity {

XUser.cs

@@ -1,10 +1,10 @@
 using System;
+using xIdentityModels.Constants;
 using System.Collections.Generic;
+using xIdentityModels.Navigations;
+using Microsoft.AspNetCore.Identity;
 using System.ComponentModel.DataAnnotations;
 using System.ComponentModel.DataAnnotations.Schema;
-using Microsoft.AspNetCore.Identity;
-using xIdentityModels.Constants;
-using xIdentityModels.Navigations;
 
 namespace xIdentityModels
 {

xIdentityModels.csproj

@@ -41,9 +41,9 @@
 
   <!-- For XML Documentation Support -->
   <PropertyGroup>
-    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
-    <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <NoWarn>$(NoWarn);1591</NoWarn>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
   </PropertyGroup>
 
 </Project>