melvinodsa/go-iam repository overview

⁠go-iam

go-iam is a lightweight, multi-tenant Identity and Access Management (IAM) server built in Golang. It provides robust authentication and fine-grained authorization for modern applications. With support for custom roles, third-party auth providers, and multi-client setups, go-iam gives you full control over access management in a scalable and modular way.

⁠✨ Features

⁠🔀 Multi-Tenancy

• Create and manage Projects
• Strict isolation of data between tenants

⁠🔐 Authentication Provider Integration

• Google, Microsoft, GitHub OAuth login support
• Easily extendable to add more providers
• Shared credentials support across multiple clients

⁠🧩 Client Management

• Multiple apps (clients) per project
• Avoid duplicate OAuth credentials

⁠🧱 Role-Based Access Control (RBAC)

• Define resources and group them into roles
• Create custom roles and assign to users
• Granular access control for different actions/resources

⁠🛠️ Admin UI

• React-based Admin interface for managing:
  • Projects
  • Users
  • Roles
  • Resources
  • Clients

⁠🧰 Tech Stack

⁠🚀 Getting Started

⁠Option 1: 🔧 Manual Setup (Development)

⁠Prerequisites

• Go 1.21+
• MongoDB
• Redis (optional, recommended)
• Google OAuth Credentials

⁠Run the Backend

git clone https://github.com/melvinodsa/go-iam.git
cd go-iam
cp sample.env .env
go run main.go

⁠Option 2: 🐳 Docker-Based Local Setup (Recommended for Testing)

Use the official go-iam-docker repo to spin up everything with Docker Compose, including:

• MongoDB
• Redis
• go-iam (backend)
• go-iam-ui (admin frontend)

⁠Steps

git clone https://github.com/melvinodsa/go-iam-docker.git
cd go-iam-docker
cp sample.env .env
docker compose up -d

⁠Access

• Admin UI: http://localhost:4173⁠
• API: http://localhost:3000⁠
• API Docs: http://localhost:3000/docs⁠

⁠📦 Environment Variables

Some important environment variables used in .env:

⁠License

• Community Edition: Apache 2.0⁠ (Open Source, free to use)