Riptide.Platform.Identity.Web 1.2.2

Riptide Platform SDK

Comprehensive enterprise-grade SDK suite for the Riptide Platform ecosystem, built with Clean Architecture principles and designed for high-performance .NET applications.

Platform Overview

The Riptide Platform SDK is a complete collection of enterprise-ready components providing standardized functionality that supports the Riptide Platform ecosystem.

SDK Components

All components are ✅ Production Ready and fully documented. See complete component documentation for detailed information.

🪵 Logging Component

Enterprise-grade structured logging with DataDog integration, compliance features, and multi-provider support.

Key Features:

• Multiple Providers: Console, File, DataDog, and extensible provider architecture
• ASP.NET Core Integration: Middleware pipeline with correlation IDs, request logging, and health checks
• Clean Architecture: Proper separation of concerns with extensive testing (100% coverage achieved)
• PII Sanitization: Automatic compliance features with redaction support

Package: Riptide.Platform.Logging
Documentation: User Guide | API Reference | Examples

⚙️ Configuration Component

Unified configuration management with multi-provider support, secrets management, and tenant-aware configuration patterns.

Key Features:

• Multi-Provider Support: Local files, Azure Key Vault, Strongbox integration
• Secrets Management: Integrated Azure Key Vault support with secure access patterns
• Multi-Tenant Support: Tenant-specific configuration isolation and override patterns
• Hot Reload: Runtime configuration updates without service restart
• Compliance-Grade Audit Trails: Persistent access/change logging with configurable retention

Package: Riptide.Platform.Configuration
Documentation: User Guide | API Reference | Examples

🧩 Dependency Injection Component

Advanced dependency injection patterns with factory support, tenant-scoped services, and multi-tenant service resolution.

Key Features:

• Factory Patterns: Complex object creation with dependency resolution
• Tenant-Scoped Services: Multi-tenant service isolation with proper lifetime management
• Service Location Utilities: Conditional service registration and resolution
• Performance Conscious: Optimized service provider patterns; measure in your environment

Package: Riptide.Platform.DependencyInjection
Documentation: User Guide | API Reference | Examples

📊 Monitoring Component

Comprehensive observability with multi-provider support, DataDog integration, OpenTelemetry, and tenant-aware monitoring.

Key Features:

• Multi-Provider Support: DataDog, OpenTelemetry, Console, Native .NET, File providers
• Distributed Tracing: W3C Trace Context with correlation ID propagation
• Tenant-Aware Monitoring: Complete isolation with tenant context injection
• Business Metrics: KPI tracking and performance monitoring for enterprise applications

Package: Riptide.Platform.Monitoring
Documentation: User Guide | API Reference | Examples

🏢 Tenant Isolation Component

Enterprise-grade multi-tenant functionality with complete data isolation, service isolation, and tenant context management.

Key Features:

• Multi-Strategy Resolution: Headers, subdomains, JWT claims, custom resolvers
• Complete Data Isolation: Tenant-scoped database connections and queries
• Service Isolation: Tenant-aware dependency injection and scoped service resolution
• Configuration Isolation: Tenant-specific configuration namespaces and overrides

Package: Riptide.Platform.TenantIsolation
Documentation: User Guide | API Reference | Examples

🧪 Testing Component

Comprehensive testing framework with xUnit foundation, Playwright UI automation, and strategic BDD support.

Key Features:

• xUnit Foundation: Standardized unit and integration testing patterns
• Playwright UI Testing: Cross-browser automation with modern web application support
• Strategic BDD: Reqnroll integration for business-critical scenarios requiring stakeholder confidence
• TestContainers Integration: Isolated integration testing with containerized dependencies

Package: Riptide.Platform.Testing
Documentation: User Guide | API Reference | Examples

🔐 Identity Component

Flexible identity and authentication system supporting multiple deployment modes for different scenarios.

Key Features:

• Three Identity Modes: Self-Contained, SSO (Azure Entra ID), and Identity Lite
• Database Flexibility: SQLite, PostgreSQL, and SQL Server support
• JWT Authentication: Secure token-based authentication with refresh tokens
• Capability-Based Authorization: Fine-grained access control for enterprise applications
• Multi-Tenancy Support: Tenant isolation with secure authentication

Packages: Riptide.Platform.Identity.Domain, Riptide.Platform.Identity.Infrastructure, Riptide.Platform.Identity.Bootstrap
Documentation: User Guide | API Reference | Examples

🗄️ Persistence Component

Database provider abstraction and Entity Framework Core integration for consistent data access patterns.

Key Features:

• Multi-Database Support: SQLite, PostgreSQL, SQL Server, InMemory providers
• Automatic Provider Configuration: Based on application settings with intelligent defaults
• Intelligent SQLite Resolution: RIPTIDE_DATA_ROOT support with proper path handling
• Retry Policies: Transient error handling with exponential backoff
• Migration Support: Clean Architecture-compatible migration assembly configuration

Packages: Riptide.Platform.Persistence.Domain, Riptide.Platform.Persistence.Infrastructure, Riptide.Platform.Persistence.Bootstrap
Documentation: User Guide | API Reference | Examples

📜 Licensing Component

Platform-wide licensing system with tamper-proof validation and hierarchical feature management.

Key Features:

• Cryptographically Signed Licenses: RSA-4096 signatures for tamper-proof validation
• Offline Validation: No phone-home requirement; works in air-gapped environments
• Hierarchical Licensing: Platform-level and application-specific feature management
• Centralized Validation: Consistent licensing across all Riptide Platform applications
• Feature Management: Granular capability control with automatic enforcement

Package: Riptide.Platform.Licensing
Documentation: User Guide | API Reference | Examples

Planned Components

🛡️ Security Component

Status: 🚧 Planned for Q3 2025

Additional security utilities for Riptide Platform services (complementing the Identity component).

Planned Features:

• Security headers and CORS management
• CSRF protection and validation
• Content security policy utilities
• Rate limiting and throttling

🌐 HTTP Client Component

Status: 🚧 Planned for Q4 2025

Standardized HTTP client configuration with retry policies, circuit breakers, and observability.

Planned Features:

• Pre-configured HttpClient with best practices
• Retry policies with exponential backoff
• Circuit breaker pattern implementation
• Request/response logging and correlation

Cross-Component Integration

The Riptide Platform SDK suite is designed with shared infrastructure principles:

• Configuration Component: Provides unified configuration management for all other components
• Dependency Injection Component: Manages service registration and lifetime for all SDK components
• Monitoring Component: Collects telemetry and performance metrics from all SDK operations
• Tenant Isolation Component: Ensures multi-tenant data and service isolation across all components
• Testing Component: Provides testing utilities and patterns for all SDK components
• Logging Component: Captures structured logs from all SDK operations
• Identity Component: Provides authentication and authorization for applications using SDK components
• Persistence Component: Provides database abstraction and migration support for data-driven components
• Licensing Component: Enforces platform-wide licensing and feature management across all applications

Quick Start

Installation

All components are available as NuGet packages:

dotnet add package Riptide.Platform.Logging
dotnet add package Riptide.Platform.Configuration
dotnet add package Riptide.Platform.Monitoring
dotnet add package Riptide.Platform.TenantIsolation
dotnet add package Riptide.Platform.DependencyInjection
dotnet add package Riptide.Platform.Testing
dotnet add package Riptide.Platform.Identity.Bootstrap
dotnet add package Riptide.Platform.Persistence.Bootstrap
dotnet add package Riptide.Platform.Licensing

Getting Started Guides

Each component has a comprehensive getting started guide:

• Logging Quick Start - Structured logging in 5 minutes
• Configuration Quick Start - Configuration management in 5 minutes
• Monitoring Quick Start - Enterprise monitoring in 5 minutes
• Tenant Isolation Quick Start - Multi-tenancy in 5 minutes
• Dependency Injection Quick Start - Advanced DI patterns in 5 minutes
• Testing Quick Start - Testing setup in 5 minutes
• Identity Quick Start - Authentication in 5 minutes
• Persistence Quick Start - Database setup in 5 minutes
• Licensing Quick Start - License validation in 5 minutes

Documentation Hub

📚 Complete Documentation - Comprehensive documentation for all SDK components

For detailed information about the SDK, see:

• AI Agent Context - Context for AI-assisted development
• Test Runner Quick Start - Quick reference for running tests
• Build Guide - Building and packaging the SDK
• Distribution Strategy - SDK distribution and versioning
• Component Overview - All component documentation in one place

Component Status Reference

Development Standards

Code Quality Requirements

• Test Coverage: Minimum 90% unit test coverage (Logging component achieved 100%)
• Clean Architecture: Strict dependency flow enforcement with architecture tests
• Performance: Defined SLA targets for each component with monitoring integration
• Documentation: Comprehensive user guides, API references, and examples for all components

Release Criteria

• Build Success: Zero compilation errors and warnings
• Test Success: 100% test pass rate required for production deployment
• Performance: All SLA targets met with monitoring validation
• Documentation Completeness: User guides, API documentation, and examples available

Architecture Standards

All components follow Clean Architecture principles:

• Domain Layer: Core business logic with no external dependencies
• Application Layer: Use cases and application services depending only on Domain
• Infrastructure Layer: External integrations and implementations
• Bootstrap Layer: Service registration and dependency injection configuration
• Adapters Layer: ASP.NET Core integration and middleware (where applicable)

Contributing

We welcome contributions to the Riptide Platform SDK! See CONTRIBUTING.md for guidelines.

License

Licensed under the MIT License. See LICENSE for details.

Support

• Documentation: docs/
• Issues: Report bugs via GitHub Issues
• Discussions: Join conversations in GitHub Discussions
• Enterprise Support: Contact the Riptide Platform team

Last Updated: November 22, 2025
SDK Version: 1.2.2 (All Production Components)