peekaboo51490/rozgaar.ai-identity-service repository overview

⁠rozgaar.ai Identity Service

Enterprise-grade Identity & Authentication Service built for cloud-native, Kubernetes-first environments.

Designed as a core building block for distributed systems that need secure authentication, authorization, and observability out of the box.

⁠🚀 Features

• OAuth2 / OpenID Connect (OIDC)
• JWT-based authentication (access & refresh tokens)
• Role-based access control (RBAC)
• PostgreSQL-backed persistence
• Kubernetes & microservice friendly
• Prometheus metrics & health probes
• Production-ready defaults (no dev shortcuts)

⁠🐳 Docker Images

Repository

peekaboo51490/rozgaar.ai-identity-service

⁠Available Tags

✅ Always prefer versioned tags (vX.Y.Z) in production to enable safe rollbacks.

⁠📥 Pull the Image

docker pull peekaboo51490/rozgaar.ai-identity-service:latest

Or a pinned version:

docker pull peekaboo51490/rozgaar.ai-identity-service:v1.0.0

⁠▶️ Run Locally (Example)

docker run -d \
  --name rozgaar-identity-service \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DB_URL=jdbc:postgresql://host.docker.internal:5432/rozgaar_identity \
  -e DB_USERNAME=postgres \
  -e DB_PASSWORD=postgres \
  -e JWT_SECRET=super-secret-key \
  -e JWT_ACCESS_TOKEN_EXP_MINUTES=15 \
  -e JWT_REFRESH_TOKEN_EXP_DAYS=7 \
  -e NOTIFICATION_SERVICE_BASE_URL=http://localhost:8081 \
  peekaboo51490/rozgaar.ai-identity-service:latest

⁠⚙️ Configuration

Timeouts & retries are preconfigured for production reliability.

⁠📊 Observability & Monitoring

• Health checks: /api/actuator/health
• Prometheus metrics: /api/actuator/prometheus
• Metrics server port: 10103

Prometheus:

• Exemplars disabled
• Tracing sampling: 100%

⁠🛡️ Mandatory Headers

Certain routes enforce mandatory headers for security.

Skipped routes:

/api/actuator
/api/actuator/**

⁠☸️ Kubernetes & Production Usage

• Designed to run behind an API Gateway / Ingress
• Works with horizontal scaling
• Compatible with Helm-based deployments
• Safe to use with immutable image tags

⁠📦 Versioning Strategy

• Semantic Versioning (vMAJOR.MINOR.PATCH)
• Versions are automatically generated from commit messages
• Each release is immutable
• Rollbacks are as simple as pulling a previous tag