vite-plugin-auto-login
v4.2.0
Published
Vite plugin for automatic login during development
Downloads
144
Maintainers
Readme
vite-plugin-auto-login
一个 Vite 插件,用于在开发服务器启动时自动执行登录流程,获取访问令牌并更新到环境变量文件。
安装
npm install vite-plugin-auto-login --save-dev快速开始
- 克隆仓库并构建插件:
git clone <repository-url>
cd vite-plugin-auto-login
npm run setup- 运行示例:
# 基础示例
npm run examples:basic
# 高级示例
npm run examples:advanced使用
在 vite.config.ts 文件中配置插件:
import { defineConfig } from 'vite';
import autoLogin from 'vite-plugin-auto-login';
export default defineConfig({
plugins: [
autoLogin({
// 认证凭据
username: 'your-username',
password: 'your-password',
// 可选:自定义 API 端点
// baseUrl: 'https://your-api.com',
// loginPath: '/login',
// tokenPath: '/token',
// authPath: '/user/info',
// 可选:环境变量配置
// envFile: '.env.development.local', // 默认根据 NODE_ENV 自动确定
// tokenKey: 'VITE_ACCESS_TOKEN', // 存储令牌的环境变量键名
// 可选:行为配置
// enabled: true, // 是否启用插件
// silent: false, // 是否静默模式(不输出日志)
// timeout: 10000, // 请求超时时间(毫秒)
})
]
});环境变量
你也可以通过环境变量来配置插件:
# .env 文件
VITE_AUTO_LOGIN_USERNAME=your-username
VITE_AUTO_LOGIN_PASSWORD=your-password
VITE_AUTO_LOGIN_REQUEST_SECRET=your-request-secret
VITE_AUTO_LOGIN_BASE_URL=https://your-api.com
VITE_AUTO_LOGIN_LOGIN_PATH=/login
VITE_AUTO_LOGIN_TOKEN_PATH=/token
VITE_AUTO_LOGIN_AUTH_PATH=/user/info
VITE_AUTO_LOGIN_ENABLED=true
VITE_AUTO_LOGIN_TOKEN_KEY=VITE_ACCESS_TOKEN工作原理
- 插件在 Vite 开发服务器启动时自动执行
- 调用登录 API 获取 requestSecret 和 secretSign
- 使用 requestSecret 和 secretSign 调用获取令牌 API
- 将获取的 access_token 写入到
.env.[environment].local文件中 - 应用可以通过环境变量使用这个令牌
配置选项
| 选项 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| username | string | - | 登录用户名 |
| password | string | - | 登录密码 |
| loginType | 'PASSWORD' \| 'MOBILE' | 'PASSWORD' | 登录类型 |
| requestSecret | string | '' | 请求密钥 |
| createCompany | 0 \| 1 | 0 | 是否创建公司 |
| baseUrl | string | 'https://cs-utwin.bwton-console.cn' | API 基础地址 |
| loginPath | string | '/oauth2/website/userLogin' | 登录 API 路径 |
| tokenPath | string | '/oauth2/website/getAccessToken' | 获取令牌 API 路径 |
| authPath | string | '/api/enterpriseadmin/v1/user/info' | 用户信息验证 API 路径 |
| envFile | string | .env.[mode].local | 环境变量文件路径 |
| tokenKey | string | 'VITE_ACCESS_TOKEN' | 存储令牌的环境变量键名 |
| enabled | boolean | true | 是否启用插件 |
| silent | boolean | false | 是否静默模式(不输出日志) |
| timeout | number | 10000 | 请求超时时间(毫秒) |
许可证
MIT
