AIC.Core.Data.MongoDb — nugetz
aicukltd/ AIC.Core.Data.MongoDb v2026.3.2.1 .NET 10.0
Shared .NET library for Aerospace, Intelligence, and Cyber solutions.
Get Started dotnet CLI PackageReference Package Manager
$ dotnet add package AIC.Core.Data.MongoDbReadme AIC Core Libraries
Transforming Industry Through Technology
AIC — Aerospace, Intelligence & Cyber — provides cutting-edge, mission-ready software components powering secure, data-driven systems for the UK defence and national security sector.
Executive Summary
This repository contains the comprehensive enterprise .NET 10 library ecosystem developed by AIC (Aerospace Intelligence Cyber) for high-assurance environments spanning Defence, Government, and critical national infrastructure.
The solution provides 50+ modular packages implementing:
Data persistence abstractions supporting Entity Framework Core, MongoDB, MongoDB Realm, and Azure Cosmos DBEnterprise-grade security & cryptography including post-quantum algorithms, asymmetric/symmetric encryption, and certificate managementIdentity & access management with multi-tenant support, RBAC, audit logging, and API key/JWT authenticationVector search & embeddings for AI/ML workloads via MongoDB Atlas Vector SearchAdvanced middleware for rate limiting, geo-IP policies, authentication flows, and quota enforcementComprehensive caching abstractions supporting in-memory and distributed patterns
All packages follow SOLID principles , enforce deterministic builds , include SourceLink tracing , and are published automatically via Azure DevOps CI/CD pipelines .
Core Architecture
Design Principles
Modular & Composable : Each package is independently versioned and can be consumed alone or as part of a larger stackSOLID & DRY : Strict adherence to Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, and Dependency Inversion principlesAsync-First : Full async/await support throughout, enabling scalable server applications
Versions 2026.3.2.1 Latest
Mar 2, 2026 Other versions (376)
Generic Abstractions : Heavy use of generic interfaces (e.g., IRepository<TEntity, TId>, IDataService<TModel>) to reduce boilerplate
High-Assurance Security : Built for air-gapped and connected environments with cryptographic integrity checks
Multi-Tenant Ready : Built-in tenant and organisation scoping, quota enforcement, and organisational audit trails
Dependency Injection Pattern All packages provide extension methods for seamless DI registration:
services
.AddIdentityDataServices()
.AddCachingServices()
.AddCryptographyServices()
.AddDataServices();
Packages & Capabilities
1. Data Access Layer Purpose: Unified abstractions and implementations for persistent storage across multiple database engines.
Core Abstractions
AIC.Core.Data
IRepository<TEntity, TId> — Generic repository interface supporting create, read, update, delete, and complex queriesIEntity, IVectorisedEntity — Base entity contracts with ID and metadata supportIHasDisplayName, IHasId — Composable capability interfacesSortDirection enum for query ordering
Multi-Database Support
AIC.Core.Data.EntityFramework
BaseEntityFrameworkCoreRepository<TEntity, TId> — Full LINQ support with lazy loading, eager loading, and expression treesSupports parameterized queries, complex predicates, and navigation property includes
Automatic change tracking and SaveChanges batching
Vector Search & Embeddings
AIC.Core.Data.MongoDb + Vector Extensions
BaseVectorisedMongoDbRepository<TModel> — Advanced vector search via MongoDB Atlas Vector SearchSearchVectorAsync() — Cosine similarity search over embeddings with configurable topK resultsSearchVectorWithScoreAsync() — Returns both documents and relevance scoresSearchOrganisationVectorAsync() — Scoped vector search per organisation (multi-tenant aware)Support for AI/ML embedding fields, semantic search, and RAG (Retrieval-Augmented Generation) workloads
AIC.Core.Data.CosmosDb
BaseCosmosDbRepository<TEntity, TId> — Cosmos DB SDK integrationPartition key aware queries for global scale
Consistency level configuration and cross-partition query support
Generic Data Services
AIC.Core.Data.Services
BaseDataService<TModel, TId> — Generic CRUD service wrapping repositoriesStandardised naming: GetByIdAsync(), GetAllAsync(), CreateAsync(), UpdateAsync(), DeleteByIdAsync()
Automatic logging and error handling
Supports batch operations and transaction coordination
Expression & Query Utilities
AIC.Core.Data.Extensions.Expressions — Expression tree utilities for composable query buildingAIC.Core.Data.Models.References — Shared model references across solutions
2. Identity & Access Management Purpose: Enterprise-grade user, organisation, tenant, and permission management with audit trails and multi-factor access control.
Core Models & Contracts
AIC.Core.Identity.Models
IIdentityService — Primary identity contract (user provisioning, attribute management, lock/unlock operations)IGetUserRequest, IGetUserResponse — Request/response envelopes with organisation scopingAPI key, JWT, and user attribute models
Comprehensive exception hierarchy: QuotaExceededException, ApiKeyInvalidException, RateLimitExceededException, etc.
User & Vault Management
AIC.Core.Identity.Data.Services
IIdentityService + IdentityService — Full user lifecycle (create, retrieve, update, lock, unlock, provision)IVaultService + VaultService — Secure credential storage, key derivation, and secrets managementIUserService + UserService — User-specific operations with organisational scopingIAuditService + AuditService — Comprehensive audit logging for all identity operations
Multi-Tenancy & RBAC
AIC.Core.Identity.Data.Services
BaseRbacDataService<TModel, TId> — Role-Based Access Control base service with resource-level permissionsBaseRbacTenantDataService — Tenant-specific RBAC (all operations scoped to tenant)BaseRbacTenantOrganisationDataService — Organisation-wide RBAC with cross-tenant boundaries
Subscriptions Management
AIC.Core.Identity.Subscriptions.Models — Subscription domain modelsAIC.Core.Identity.Subscriptions.Models.MongoDb — MongoDB-specific subscription persistenceAIC.Core.Identity.Subscriptions.Services — Subscription lifecycle and entitlement logicAIC.Core.Identity.Subscriptions.Models.References — Reference data for subscription types
Multi-Tenant Organization Hierarchy
AIC.Core.Identity.Tenants.Models — Tenant domain modelsAIC.Core.Identity.Tenants.Models.MongoDb — MongoDB tenant persistenceAIC.Core.Identity.Tenants.Models.References — Reference data and lookup tables
Audit & Compliance
AIC.Core.Identity.Data.Services
AuditService — Tracks all identity operations with user IDs, timestamps, actions, and resultsOrganisational audit trail segregation
Immutable audit log append-only design
Extension Methods
AIC.Core.Identity.Extensions — Helper methods for identity operations, token generation, and claim extraction
3. Authentication & Authorization
JWT (JSON Web Tokens)
API Key Management
JWT access tokens embed ApiKeyMetadata as claims
Rate limit quotas per API key (requests per time window)
Geo-IP restrictions (CIDR-based IP matching)
Signature and expiration validation
Extensible metadata for custom policies
Authentication Middleware
AIC.Core.Identity.Data.Services.Middleware
AuthenticationServiceContextMiddleware — Extracts and validates auth tokens, populates user contextTokenValidationErrorMiddleware — Handles JWT validation failures with detailed error responsesClaims extraction and principal construction
Authorization & Audit Middleware
AuthorizationAuditMiddleware — Logs all authenticated requests with action, resource, outcome, and timingMulti-tenant scoping ensures audit logs are segregated
Geo-IP & Network Policies
IpGeoPolicyMiddleware — Validates IP address geolocation against API key restrictionsIGeoResolver + DefaultGeoResolver — Geolocation lookup (extensible for custom providers)IIpMatcher + CidrIpMatcher — CIDR block matching for IP validation
Rate Limiting
QuotaMiddleware — Enforces per-user and per-API-key rate limitsPartitioned rate limiters with configurable windows and permit counts
RateLimitExceededException for backpressure signaling
Web API Extensions
AIC.Core.Identity.Extensions.WebApi
WebApiExtensions — Comprehensive ASP.NET Core integrationProblem Details mapping for standardised error responses
Rate limiting configuration with API key metadata integration
Middleware registration helpers
Service discovery and dependency injection orchestration
Controllers
AIC.Core.Identity.Data.Controllers.Authentication
AuthenticationController — RESTful endpoints for login, token refresh, logout
4. Security & Cryptography Purpose: Enterprise cryptographic primitives supporting post-quantum algorithms, certificate management, and secure key operations.
Core Abstractions
AIC.Core.Security.Cryptography
IAsymmetricCryptographyProvider<TAlgorithm> — RSA, ECDSA, post-quantum algorithm abstractionISymmetricCryptographyProvider<TAlgorithm> — AES and other symmetric cipher abstractionIHashProvider — Cryptographic hash function abstraction (SHA-256, SHA-3, BLAKE2, etc.)ICryptographicAsyncStream — Stream-based encryption/decryption for large payloads
Asymmetric Cryptography
AIC.Core.Security.Cryptography.Asymmetric.RSA
Full RSA-2048, RSA-3072, RSA-4096 support
Signing, verification, encryption, decryption
PKCS#1 v1.5 and OAEP padding modes
AIC.Core.Security.Cryptography.Asymmetric.QuantumAIC.Core.Security.Cryptography.Asymmetric.Quantum.BouncyCastle
CRYSTALS-Kyber (key encapsulation) — quantum-resistant key exchange
CRYSTALS-Dilithium (signatures) — quantum-resistant digital signatures
ML-KEM, ML-DSA standards support
Hybrid classical+quantum signing for transition strategies
AIC.Core.Security.Cryptography.Asymmetric.Certificates
Certificate generation, parsing, validation
Distinguished name handling, extension management
Self-signed and CA-signed certificate chains
AIC.Core.Security.Cryptography.Asymmetric.Certificates.Quantum
AIC.Core.Security.Cryptography.Asymmetric.Certificates.Quantum.BouncyCastle
Post-quantum certificate generation and validation
Quantum algorithm OIDs and ASN.1 encoding
Future-proof PKI infrastructure support
Symmetric Cryptography
AIC.Core.Security.Cryptography.Symmetric.AES
AES-128, AES-192, AES-256 support
CBC, CTR, GCM modes
Single-round and double-round (nested) encryption for additional security
BouncyCastle implementations as alternative to .NET native
Hashing & Message Digests
Extension Methods & Utilities
AIC.Core.Security.Cryptography.Asymmetric.Extensions — Helper methods for key generation, encoding, format conversionAIC.Core.Security.Cryptography.Hashing.Extensions — Hash computation shortcuts and verification helpers
5. Caching Purpose: Flexible caching abstractions supporting in-memory and distributed cache implementations.
Core Abstractions
AIC.Core.Caching
ICache — Generic cache interface with Get, Set, Remove, Clear operationsITypedCache<T> — Strongly-typed cache for specific model typesTTL (time-to-live) support with automatic expiration
Cache statistics and monitoring
Implementations
AIC.Core.Caching.InMemory
InMemoryCache — .NET MemoryCache wrapperProcess-local caching suitable for single-instance deployments
Fast, low-latency access with eviction policies
Microsoft Memory Cache Adapter
AIC.Core.Caching.MicrosoftMemoryCache
Wrapper around Microsoft.Extensions.Caching.Memory.IMemoryCache
Integrates with standard .NET Core DI
Sliding expiration and absolute expiration support
Cache Extensions & Utilities
AIC.Core.Caching Extensions
CacheExtensions — Convenience methods for cache-aside pattern, lazy loading, bulk operationsAsync-friendly cache access patterns
Typed cache helpers
6. Logging & Observability
Core Logging
AIC.Core.Logging
Abstraction over Microsoft.Extensions.Logging
Structured logging with context propagation
Serilog Integration
AIC.Core.Logging.Serilog
SerilogLoggingPolicyMiddleware — Middleware for structured request/response loggingEvent enrichment with request context, user IDs, tenant IDs
Sink configuration for console, file, Azure Monitor, Seq
Extension Methods
AIC.Core.Logging.Extensions — Helper methods for common logging patterns
7. Utilities & Extensions
AIC.Core.Extensions — General-purpose extension methods for strings, collections, reflection, and domain operations
Advanced Features
Multi-Tenant Architecture Every data service includes built-in organisational and tenant scoping:
public class TenantDataService : BaseRbacTenantDataService<Model>
{
public async Task GetAsync(Guid tenantId)
{
// Automatically scoped to tenantId; cross-tenant access rejected
return await GetByIdAsync(modelId);
}
}
Quota & Rate Limiting API keys carry quota metadata:
Rate limiting : Requests per time window (1-minute, 5-minute windows, custom)Enforcement : Partitioned rate limiters by API key or userRejection handling : Returns HTTP 429 (Too Many Requests) with retry-after headers // Automatically enforced by middleware
services.AddRateLimiter(options => { /* configured per API key */ });
Audit Logging Every identity operation is logged:
User performing action
Resource affected
Action type (create, update, delete, etc.)
Timestamp and duration
Success/failure status
IP address and user agent
Vector Search & AI Integration MongoDB Atlas vector search enables semantic queries:
var results = await repository.SearchVectorAsync(embeddingVector, topK: 10);
var withScores = await repository.SearchVectorWithScoreAsync(embeddingVector);
Semantic search over document collections
Recommendation engines
RAG (Retrieval-Augmented Generation) pipelines
Anomaly detection
Organisational Catch-All Quotas TargetType.Any quotas act as wildcards:
// This quota applies to all request types
var catchAllQuota = quotas.Where(q => q.TargetType == TargetType.Any || q.TargetType == targetType);
Enables org-level policies with user-level overrides.
Security Posture
High-Assurance Design
Built for air-gapped and connected environments
No external dependencies for core cryptography
BouncyCastle alternative implementations for FIPS-140 compliance
Deterministic, reproducible builds with embedded SourceLink
Cryptographic Agility
Support for both classical (RSA, AES, SHA-256) and post-quantum algorithms
Hybrid signing strategies for gradual transition
Algorithm OID flexibility for future standardization
Secrets Management
VaultService for secure credential storageKey derivation with salted hashing
Audit-logged credential operations
No plaintext secrets in logs
Network & Access Control
Geo-IP restriction enforcement via CIDR blocks
Rate limiting with per-user/per-key quotas
API key metadata tainting (can't be used elsewhere without permission)
Organisational boundary enforcement
Getting Started
Installation Each package is available via NuGet with the AIC.Core.* prefix:
# Identity & Access
dotnet add package AIC.Core.Identity.Data.Services
dotnet add package AIC.Core.Identity.Extensions.Jwt
dotnet add package AIC.Core.Identity.Extensions.WebApi
# Data Persistence
dotnet add package AIC.Core.Data.Services
dotnet add package AIC.Core.Data.MongoDb
dotnet add package AIC.Core.Data.EntityFramework
# Security & Cryptography
dotnet add package AIC.Core.Security.Cryptography.Asymmetric.RSA
dotnet add package AIC.Core.Security.Cryptography.Asymmetric.Quantum.BouncyCastle
dotnet add package AIC.Core.Security.Cryptography.Symmetric.AES
# Caching
dotnet add package AIC.Core.Caching.MicrosoftMemoryCache
# Logging
dotnet add package AIC.Core.Logging.Serilog
Complete Startup Example using AIC.Core.Identity.Extensions;
using AIC.Core.Identity.Extensions.Jwt;
using AIC.Core.Identity.Extensions.WebApi;
using AIC.Core.Data.Services;
using AIC.Core.Caching;
using Microsoft.Extensions.DependencyInjection;
// Build service collection
var services = new ServiceCollection();
// Register all AIC services
services
.AddIdentityDataServices()
.AddIdentityJwtServices(Configuration)
.RegisterWebApiDependencies(Configuration)
.AddDataServices()
.AddCachingServices()
.AddLoggingServices();
var provider = services.BuildServiceProvider();
// Use services
var identityService = provider.GetRequiredService<IIdentityService>();
var userResponse = await identityService.GetUserAsync(getUserRequest);
var userService = provider.GetRequiredService<IUserService>();
var user = await userService.GetByIdAsync(userId);
var cache = provider.GetRequiredService<ICache>();
await cache.SetAsync("key", "value", TimeSpan.FromMinutes(5));
Building Locally # Restore dependencies
dotnet restore
# Build the solution
dotnet build -c Release
# Run all tests
dotnet test
# Generate NuGet packages locally
dotnet pack -c Release
DLL assemblies : bin/Release/net10.0/Symbol packages : artifacts/packages/*.snupkgNuGet packages : artifacts/packages/*.nupkg
Typical Project Structure MyApplication/
├── MyApplication.Web/ # ASP.NET Core / Blazor app
│ ├── Program.cs # DI & middleware registration
│ └── Controllers/ # API controllers
├── MyApplication.Services/ # Business logic layer
│ ├── UserService.cs # Orchestrates identity operations
│ └── DataService.cs # Data access wrapper
└── MyApplication.Models/ # Domain models
├── User.cs
└── Tenant.cs
// Program.cs registration
services
.AddIdentityDataServices()
.AddIdentityExtensions()
.AddDataServices()
.AddCachingServices();
app.UseWebApi(); // Registers middleware pipeline
Architecture Patterns
Repository Pattern All data access flows through IRepository<TEntity, TId>:
public interface IRepository<TEntity, in TId> where TEntity : class where TId : struct
{
Task<TEntity> GetModelAsync(TId id);
Task<IEnumerable<TEntity>> GetModelsAsync();
Task<TEntity> CreateOrUpdateAsync(TEntity entity);
Task<bool> DeleteAsync(TId id);
}
BaseEntityFrameworkCoreRepository — EF Core with LINQ supportBaseMongoDbRepository — MongoDB with document queriesBaseCosmosDbRepository — Cosmos DB with partition-aware queriesBaseVectorisedMongoDbRepository — Vector search extension
Service Layer Generic BaseDataService<TModel, TId> wraps repositories:
public class BaseDataService<TModel, TId> where TModel : class where TId : struct
{
public async ValueTask<TModel> GetByIdAsync(TId id) { /* delegates to repository */ }
public async ValueTask<IEnumerable<TModel>> GetAllAsync(Expression<Func<TModel, bool>>? predicate = null) { }
public async ValueTask<TModel> CreateAsync(TModel model) { }
public async ValueTask<TModel> UpdateAsync(TModel model) { }
public async ValueTask<bool> DeleteByIdAsync(TId id) { }
}
Consistent method naming (Get*Async, Create*Async, Delete*Async)
Automatic logging and error handling
Scoped lifetime for security
RBAC (Role-Based Access Control) BaseRbacDataService<TModel, TId> enforces permissions:
public class BaseRbacDataService<TModel, TId> : BaseDataService<TModel, TId>
{
// All operations respect user roles and resource permissions
public async Task<TModel> GetByIdAsync(TId id)
{
var model = await base.GetByIdAsync(id);
// Check user has read permission on model
await authorizationService.AuthorizeAsync(user, model, "Read");
return model;
}
}
Middleware Pipeline Authentication and authorization are applied via middleware:
→ AuthenticationServiceContextMiddleware (Extract JWT, populate HttpContext.User)
→ AuthorizationAuditMiddleware (Log authenticated action)
→ IpGeoPolicyMiddleware (Validate geo restrictions)
→ QuotaMiddleware (Rate limiting)
→ TokenValidationErrorMiddleware (Error mapping)
→ Application Logic (Controllers, Services)
Testing The solution includes comprehensive test suites:
AIC.Core.Data.MongoDb.Tests — Repository and query testsAIC.Core.Data.CosmosDb.Tests — Cosmos DB integration testsAIC.Core.Security.Cryptography.*.Tests — Cryptography algorithm testsAIC.Core.Identity.Data.Services.Middleware.Tests — Middleware pipeline testsAIC.Core.Identity.Data.Services.Jwt.Tests — JWT token tests Test Framework : xUnit (with Fluent Assertions, Moq, NUnit conventions)
Unit tests for cryptographic operations
Integration tests for database operations
Middleware pipeline tests
Rate limiting and quota tests
RBAC permission enforcement tests
Build & Packaging
Versioning Strategy Versions follow CalVer (Calendar Versioning):
Format: YYYY.MM.DD.patch
Example: 2025.11.20.3 (November 20, 2025, patch 3)
Automatically injected by Azure DevOps build pipeline
Deterministic Builds <!-- Directory.Build.props -->
<Deterministic>true</Deterministic>
<PublishRepositoryUrl>true</PublishRepositoryUrl>
<EmbedUntrackedSources>true</EmbedUntrackedSources>
Reproducible binaries across machines
SourceLink integration for source-level debugging
Build timestamp consistency
No environment-dependent artifacts
NuGet Packaging Each project auto-generates NuGet packages:
Package : .nupkg (DLL + dependencies)Symbols : .snupkg (debugging support)Metadata : Embedded README, license, release notesRegistry : Published to AIC NuGet Feed
Local Packing dotnet pack -c Release
# Outputs to ./artifacts/packages/
Repository Structure src/
├── Data/ # Data layer abstractions & implementations
│ ├── AIC.Core.Data/ # Core interfaces (IRepository, IEntity)
│ ├── AIC.Core.Data.Services/ # Generic CRUD services
│ ├── AIC.Core.Data.EntityFramework/ # EF Core repository
│ ├── AIC.Core.Data.MongoDb/ # MongoDB repository
│ ├── AIC.Core.Data.MongoDb.Realm/ # MongoDB Realm offline support
│ ├── AIC.Core.Data.CosmosDb/ # Azure Cosmos DB repository
│ ├── AIC.Core.Data.Models.References/ # Shared model references
│ └── AIC.Core.Data.Extensions.Expressions/ # Expression tree utilities
│
├── Caching/ # Caching abstractions & implementations
│ ├── AIC.Core.Caching/ # Core cache interfaces
│ ├── AIC.Core.Caching.InMemory/ # In-memory implementation
│ └── AIC.Core.Caching.MicrosoftMemoryCache/ # MS.Extensions.Caching adapter
│
├── Security/ # Cryptography & security
│ └── Cryptography/
│ ├── AIC.Core.Security.Cryptography/ # Core crypto abstractions
│ ├── AIC.Core.Security.Cryptography.Streams/ # Stream-based encryption
│ ├── Asymmetric/
│ │ ├── AIC.Core.Security.Cryptography.Asymmetric/ # RSA, ECDSA abstractions
│ │ ├── AIC.Core.Security.Cryptography.Asymmetric.RSA/ # RSA implementation
│ │ ├── AIC.Core.Security.Cryptography.Asymmetric.Extensions/ # RSA helpers
│ │ ├── AIC.Core.Security.Cryptography.Asymmetric.Quantum/ # Post-quantum base
│ │ ├── AIC.Core.Security.Cryptography.Asymmetric.Quantum.BouncyCastle/ # PQ implementations
│ │ ├── AIC.Core.Security.Cryptography.Asymmetric.NBitcoin/ # Bitcoin crypto support
│ │ ├── Certificates/
│ │ │ ├── AIC.Core.Security.Cryptography.Asymmetric.Certificates/ # X.509 support
│ │ │ ├── AIC.Core.Security.Cryptography.Asymmetric.Certificates.Models/
│ │ │ ├── AIC.Core.Security.Cryptography.Asymmetric.Certificates.Quantum/ # PQ certificates
│ │ │ └── AIC.Core.Security.Cryptography.Asymmetric.Certificates.Quantum.BouncyCastle/
│ ├── Symmetric/
│ │ ├── AIC.Core.Security.Cryptography.Symmetric/ # Symmetric abstractions
│ │ └── AIC.Core.Security.Cryptography.Symmetric.AES/ # AES implementation
│ ├── Hashing/
│ │ ├── AIC.Core.Security.Cryptography.Hashing/ # Hash abstractions
│ │ ├── AIC.Core.Security.Cryptography.Hashing.BouncyCastle/ # BC implementations
│ │ └── AIC.Core.Security.Cryptography.Hashing.Extensions/ # Hash helpers
│ └── FIDO2/
│ └── AIC.Core.Security.Cryptography.Fido2/ # WebAuthn/FIDO2 support
│
├── Identity/ # Identity & access management
│ ├── AIC.Core.Identity.Models/ # Core identity domain models & exceptions
│ ├── AIC.Core.Identity.Models.Jwt/ # JWT models (AccessToken, RefreshToken, etc.)
│ ├── AIC.Core.Identity.Models.MongoDb/ # MongoDB-persisted identity models
│ ├── AIC.Core.Identity.Data/ # Identity repositories
│ ├── AIC.Core.Identity.Data.Services/ # Identity business logic (User, Vault, Audit)
│ ├── AIC.Core.Identity.Data.Services.Jwt/ # JWT token generation & validation
│ ├── AIC.Core.Identity.Data.Services.Middleware/ # Auth middleware (context, audit, geo-ip, quota)
│ ├── AIC.Core.Identity.Data.Controllers.Authentication/ # REST controllers
│ ├── AIC.Core.Identity.Extensions/ # Identity extension methods
│ ├── AIC.Core.Identity.Extensions.Jwt/ # JWT DI extensions
│ ├── AIC.Core.Identity.Extensions.WebApi/ # WebApi integration
│ ├── AIC.Core.Identity.Services.Web/ # Web-specific services (GeoResolver, IpMatcher)
│ ├── AIC.Core.Identity.Extensions.Web/ # Web extension methods
│ ├── Subscriptions/
│ │ ├── AIC.Core.Identity.Subscriptions.Models/
│ │ ├── AIC.Core.Identity.Subscriptions.Models.MongoDb/
│ │ ├── AIC.Core.Identity.Subscriptions.Models.References/
│ │ └── AIC.Core.Identity.Subscriptions.Services/
│ └── Tenants/
│ ├── AIC.Core.Identity.Tenants.Models/
│ ├── AIC.Core.Identity.Tenants.Models.MongoDb/
│ └── AIC.Core.Identity.Tenants.Models.References/
│
├── Logging/ # Logging & observability
│ ├── AIC.Core.Logging/ # Core logging abstractions
│ ├── AIC.Core.Logging.Extensions/ # Logging extension methods
│ └── AIC.Core.Logging.Serilog/ # Serilog structured logging
│
├── Extensions/ # Utilities & extensions
│ └── AIC.Core.Extensions/ # General-purpose extension methods
│
└── Encoding/ # Future: Text encoding & compression utilities
Repository Metadata
Contributing This repository is managed internally by AIC.https://aicuk.ltd#contact .
Security
Responsible Disclosure All packages are produced within a clean cloud build environment with:
Reproducible, deterministic builds
SourceLink source-level tracing
Cryptographic signature verification
Audit logging of all build operations
Vulnerability Reporting Security vulnerabilities can be reported privately through official AIC channels only. Do not disclose security issues in public GitHub issues or discussions.
Design Principles for High-Assurance
Air-gapped ready : Supports offline environments with no external service dependenciesFIPS-140 compliance : BouncyCastle implementations available for strict COTS environmentsPost-quantum safe : Quantum-resistant algorithms available alongside classical onesZero-trust architecture : All operations require authentication, authorization, and audit loggingDefence & National Security focus : Built for systems handling classified and sensitive data
License Licensed under the MIT License .LICENSE file for full terms.
Copyright © 2025 AIC Professional Services UK Ltd
All rights reserved. This software and its associated artefacts are proprietary to AIC. No part of this material may be used, reproduced, or distributed without explicit written authorisation from AIC.
Roadmap & Future Expansion
Planned Capabilities
Encoding utilities — Base32, Base64url, Protobuf supportGraphQL API generator — Automatic API surface generationMulti-language SDKs — TypeScript/JavaScript, Python, Go clientsKubernetes operators — Managed deployment and scalingOpenTelemetry integration — Distributed tracing and metricsAdditional crypto algorithms — EdDSA, ChaCha20-Poly1305Hardware security module (HSM) support — PKCS#11 integrationEvent sourcing — Audit-log-as-database patterns
Support & Documentation
Last Updated: January 2026Framework Version: .NET 10Status: Production Ready
Feb 11, 2026