👁 Image
Hexalith.IdentityStores 1.4.5

Hexalith.IdentityStores

👁 License: MIT
👁 Discord

Build Status

👁 Codacy Badge
👁 Quality Gate Status
👁 Security Rating
👁 Maintainability Rating
👁 Code Smells
👁 Lines of Code
👁 Technical Debt
👁 Reliability Rating
👁 Duplicated Lines (%)
👁 Vulnerabilities
👁 Bugs

👁 Build status

Overview

This repository contains Hexalith Identity Stores components for user identity management, authentication, and authorization within the Hexalith ecosystem. It includes class libraries and an example app for integrating identity services into applications.

Dapr Integration

Dapr is used to provide building blocks around state, service invocation, pub/sub, and secrets. The libraries in this repo include helpers and actor-based stores designed to work with Dapr.

Key Dapr Building Blocks Used

• State Management: Persist identity-related data using pluggable state stores.
• Service-to-Service Invocation: Communicate between identity actors/services and consumers.
• Pub/Sub Messaging: Publish identity-related events.
• Secrets Management: Store sensitive configuration securely.

Dapr Architecture in Hexalith.IdentityStores

Identity data and operations are implemented using Dapr actors and services. Applications interact via standard Dapr APIs or client SDKs.

Repository Structure

• src/: Core source code.
  • src/libraries/: Class libraries packaged as NuGet.
    • Hexalith.IdentityStores (library): Dapr actor-based identity stores, models, helpers, and services.
    • Hexalith.IdentityStores.Abstractions (library): Public abstractions, configurations, and constants shared across the ecosystem.
    • Hexalith.IdentityStores.UI (library): UI components and helpers (Blazor) for account flows.
  • src/examples/: Sample projects demonstrating usage.
    • Hexalith.IdentityStores.Example (console example): Minimal example wiring identity stores.
  • src/servers/: Documentation placeholder. No server projects are present in this repository at the moment. See src/servers/README.md.
• test/: Tests.
  • Hexalith.IdentityStores.Tests: Unit tests.
• tools/: Utility scripts.
• Hexalith.Builds/: Git submodule for shared build configurations.
• .github/: GitHub workflows and templates.
• Root files: Solution, props, package, license, and documentation.

Getting Started

Prerequisites

• .NET 10 SDK or later
• PowerShell 7 or later
• Git
• Dapr (optional but recommended for actor/state features)
• Docker (optional, for running Dapr locally)

Initialization

1. Clone the repository:

   git clone --recurse-submodules https://github.com/Hexalith/Hexalith.IdentityStores.git
   cd Hexalith.IdentityStores
   

   If you cloned without --recurse-submodules, run:

   git submodule update --init --recursive
   

Building the Code

Build the entire solution using the .NET CLI:

dotnet build Hexalith.IdentityStores.sln

Development

Running Tests

Execute tests using the .NET CLI:

dotnet test Hexalith.IdentityStores.sln

Contributing

Refer to contribution guidelines if available before submitting pull requests. Ensure code adheres to the project's coding standards and passes all tests.

License

MIT License. See LICENSE for details.