Authentication microservice built with C# and ASP.NET Core. Docker containers and Docker Compose fully supported.

• JWT access tokens
• User database
• Role-based access control
• gRPC services and REST API
• CLI tool

PostgreSQL user database. Users are managed with .NET Entity Framework and Identity system.

These provide production-ready user and database management that can be extended.

BCrypt hashing algorithm with pepper. Pepper is a secret value that is added to passwords before passing them to BCrypt. It provides an additional layer of security.

CLI

/health/summary - Gives service health summary including database status. This endpoint is only available in port 5105. gRPC port 5106 does not have this.

POST /api/v1/auth/login - Login with username and password

GET /api/v1/users - Get all users. Authentication and admin role required.

CLI tool is built with Rust. You need Rust tools to build it.

You can install Rust here: https://www.rust-lang.org/tools/install

Start by setting environment variables in your shell process.

GRPC_API_URL=http://localhost:5106
REST_API_URL=http://localhost:5105/api/v1

If you are using PowerShell

$Env:GRPC_API_URL="http://localhost:5106"
$Env:REST_API_URL="http://localhost:5105/api/v1"

Build the binary

cargo build

Or build more optimized release version

cargo build --release

Login can be done using both gRPC and REST. Login returns JWT access token and it gets saved to a file. After login, you can list all users (Admin role required.).

auth-cli --help

Login using gRPC service

auth-cli login

Login using REST API

auth-cli login --rest

List all users using gRPC service

auth-cli user ls

List all users using REST API

auth-cli user ls --rest

Go to the project root in terminal

cd auth-microservice

Run PostgreSQL

docker compose -f docker-compose.db.yml up -d

Access it from your localhost's port 12345

Run PostgreSQL and microservice

docker compose up -d

gRPC services port 5106

REST API port 5105