# f2e-middle-rbac

**Repository Path**: f2e-server/f2e-middle-rbac

## Basic Information

- **Project Name**: f2e-middle-rbac
- **Description**: f2e-server3 的用户角色权限 RBAC 实现
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: http://shy2850.com:8888/admin
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-02
- **Last Updated**: 2025-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# f2e-middle-rbac
f2e-server3 的用户角色权限 RBAC 实现

## 安装
```bash
npm install f2e-middle-rbac --save
```
## 使用
依赖 [f2e-server3](https://gitee.com/f2e-server/f2e-server-3) 服务完成RBAC配置
- 配置正确，服务器首次启动后，会自动完成数据初始化
- 启动服务后，访问 [http://localhost:9120/admin/](http://localhost:9120/admin/) 会自动跳转登录页 `/login`
- 退出登录，访问 `/logout` 即可

### 默认使用文件存储的权限配置
```javascript
import { createServer } from "f2e-server3"
import { createMiddleRBAC, createServiceFile } from 'f2e-middle-rbac'
const service = createServiceFile({});
createServer({
    mode: 'dev',
    port: 9120,
    middlewares: [
        // 创建 RBAC 中间件
        createMiddleRBAC(service),
    ],
    auth: {
        // 指定用户服务, 验证获取登录用户信息
        store: service.userService,
        // 登录成功后跳转的页面， 默认跳转到 /admin 为系统管理页
        redirect: '/admin',
    },
});
```

### 配置MongoDB支持
```javascript
import { createServer } from "f2e-server3"
import { createMiddleRBAC, createServiceMongo } from 'f2e-middle-rbac'
const service = createServiceMongo({
    db: new MongoClient("mongodb://localhost:27017").db("rbac"),
});
createServer({
    mode: 'dev',
    port: 9120,
    middlewares: [
        // 创建 RBAC 中间件
        createMiddleRBAC(service),
    ],
    auth: {
        // 指定用户服务, 验证获取登录用户信息
        store: service.userService,
        // 登录成功后跳转的页面， 默认跳转到 /admin 为系统管理页
        redirect: '/admin',
    },
});
```

## 效果图
![权限管理页面](rbac_permission.png)