WeCoding IAM

IAM = Identity and Access Management

An identity and access management system developed in Go, used for authorizing resource access.

• Preview: http://iam.wecoding.top (Default login: ADMIN/WECODING)
• FAQ: https://github.com/coding-hui/iam/issues

✨ Features

• RBAC access control model based on Casbin, providing fine-grained permission control down to buttons.

• Multiple authentication methods: JWT, Basic, SecretKey.

• Built on the GIN WEB API framework, providing rich middleware support (user authentication, CORS, access logs, trace ID, etc.).

• Follows RESTful API design specifications.

• Supports Swagger documentation (based on swaggo).

• Database storage based on GORM, extensible to multiple types of databases.

• Supports dynamically loading multiple configuration files.

• Multi-command mode, providing the iamctl command-line tool.

• TODO: Support for multi-tenancy.

• TODO: Unit tests.

🎁 Built-in

• User Management: Users are system operators, this function mainly completes system user configuration.

• Organization Management: Configures system organization (company, department, group).

• Resource Management: Resources are identifiers of specific resources in the business system, which can be an entity, such as a user, or a menu, button, API.

• Permission Policy: Permission policies combine multiple resources, operations, and authorization effects to provide flexible access permission management and control functions for applications.

• Role Management: A role is a collection of permission resources, which can authorize certain resources and operation permissions to the role. When a role is granted to a user, the user will inherit all permissions of this role.

📦 Local Development

Environment Requirements

• go 1.24
• node v16.19.1
• pnpm 8.5.1

Development Directory Creation

mkdir wecoding
cd wecoding

Get Code

# Get backend code
git clone https://github.com/coding-hui/iam.git
# Get frontend code
git clone https://github.com/coding-hui/iam-frontend.git

Start Instructions

Server Start

# Enter iam backend projectcd ./iam
# Build
make build
# Modify configuration# File path iam/configs/iam-apiserver.yaml
vi ./configs/iam-apiserver.yaml
# Start service# macOS or linux
go run ./cmd/iam-apiserver/main.go -c configs/iam-apiserver.yaml
# windows
go run .\cmd\iam-apiserver\main.go -c configs\iam-apiserver.yaml

The built binary file is saved in the _output/platforms/linux/amd64/ directory.

Console UI Start

# Install dependenciescd iam-frontend
npm install -g pnpm
pnpm install
pnpm start

Visit: http://localhost:8000 ADMIN/WECODING

User Guide

IAM Documentation

Contributing

We welcome contributions:

• Submit issues to report bugs or ask questions.
• Propose pull requests to improve our code.