lsm/OpenAuth.Net
1
0
Fork 0
mirror of https://gitee.com/dotnetchina/OpenAuth.Net.git synced 2025-09-18 17:48:01 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

📃docs: 文档更新

Browse Source
This commit is contained in:
yubaolee
2025-07-21 23:14:38 +08:00
parent 6b2c50252b
commit 87866d08fb
3 changed files with 11 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
newdocs/docs/notes/core/changesdk.md
View File

@@ -4,7 +4,7 @@ createTime: 2025/04/23 21:03:10
permalink: /core/changesdk/
---
OpenAuth.Net最新版默认使用.Net SDK 9.0.100。如果你使用的是其他版本的sdk（如.net 6.0/7.0等）打开项目，需要调整csproj项目文件的TargetFramework。用记事本等工具，打开 `Infrastructure.csproj` `OpenAuth.Repository.csproj` `OpenAuth.App.csproj` `OpenAuth.Mvc.csproj` `OpenAuth.WebApi.csproj` `OpenAuth.IdentityServer.csproj`，将
OpenAuth.Net最新版默认使用.Net SDK 9.0.100。如果你使用的是其他版本的sdk（如.net 6.0/7.0等）打开项目，需要调整csproj项目文件的TargetFramework。用记事本等工具，打开 `Infrastructure.csproj` `OpenAuth.Repository.csproj` `OpenAuth.App.csproj` `OpenAuth.WebApi.csproj` `OpenAuth.IdentityServer.csproj`，将
```csharp
<PropertyGroup>
<TargetFramework>net9.0</TargetFramework>

13
newdocs/docs/notes/core/identity.md
View File

@@ -32,19 +32,11 @@ OpenAuth.Net支持两种登录认证方式：Token认证和==自己搭建=={.tip
不同于其他项目的统一登录（如微信登录、支付宝登录等）,OpenAuth.Net的统一登录指的是自己搭建一套OAuth登录服务，提供给其他项目使用。即OpenAuth.IdentityServer。启动后，直接访问[http://localhost:12796](http://localhost:12796)，效果如下：
![2025-03-18-23-12-18](http://img.openauth.net.cn/2025-03-18-23-12-18.png)
这时我们修改OpenAuth.WebApi/Mvc的IdentityServerUrl配置：
这时我们修改OpenAuth.WebApi的IdentityServerUrl配置：
```json
"IdentityServerUrl": "http://localhost:12796", //IdentityServer服务器地址。
```
### OpenAuth.Mvc效果
当启用了Identity时，mvc启动后界面如下：
![2025-04-24-00-24-28](http://img.openauth.net.cn/2025-04-24-00-24-28.png)
这时点击登录超链接，会跳转到OpenAuth.Identity登录界面。效果如下：
![2025-04-24-00-24-40](http://img.openauth.net.cn/2025-04-24-00-24-40.png)
### OpenAuth.WebApi效果
@@ -66,7 +58,8 @@ VITE_OIDC_AUTOMATICSILENTRENEW = true #自动续期
如果服务端启用了Identity认证，则打开登录界面如下：
![2025-03-10-14-46-47](http://img.openauth.net.cn/2025-03-10-14-46-47.png)
这时点击登录超链接，操作同OpenAuth.Mvc一样。
这时点击登录超链接，会跳转到OpenAuth.Identity登录界面。效果如下：
![2025-04-24-00-24-40](http://img.openauth.net.cn/2025-04-24-00-24-40.png)
#### SwaggerUI

13
newdocs/docs/notes/pro/selectusercom.md
View File

@@ -6,7 +6,7 @@ permalink: /pro/selectusercom/
SelectUsersCom是一个用于选择用户或角色的基础组件。如下图：
![2025-05-24-12-15-46](http://img.openauth.net.cn/2025-05-24-12-15-46.png)
![2025-07-21-22-58-52](http://img.openauth.net.cn/2025-07-21-22-58-52.png)
一般通过按钮触发弹框进行选择，如下：
@@ -31,12 +31,12 @@ const ignoreAuth = ref(false)
还有一种通过输入框触发弹框进行选择，这时需要回填数据到文本框中。如下：
![2025-05-24-11-44-26](http://img.openauth.net.cn/2025-05-24-11-44-26.png)
![2025-07-21-23-05-22](http://img.openauth.net.cn/2025-07-21-23-05-22.png)
```vue
<el-input @click="selectDialog = true" readonly v-model="names" :placeholder="placeholder"></el-input>
<el-dialog :destroy-on-close="true" width="850px" title="选择用户" v-model="selectDialog">
<selectUsersCom v-if="selectDialog" :ignore-auth="ignoreAuth" v-model:show="selectDialog" :loginKey="'loginUser'"
<selectUsersCom v-if="selectDialog" :ignore-auth="ignoreAuth" v-model:show="selectDialog" :selectType="'User'"
v-model:users="selectUsers" v-model:userNames="names"></selectUsersCom>
</el-dialog>
@@ -71,12 +71,13 @@ const roles = ref([])
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| show | Boolean | false | 控制组件显示/隐藏 |
| loginKey | String | - | 选择类型，'loginUser'表示选择用户，其他值表示选择角色 |
| selectType | String | - | 选择类型，'User'表示选择用户，'Role'表示选择角色 |
| orgId | String | - | 组织ID，如果为空则显示左侧树状结构 |
| ignoreAuth | Boolean | false | 是否忽略登录用户权限，直接获取全部数据，用于可以跨部门选择用户、角色的场景 |
| hiddenFooter | Boolean | false | 是否隐藏底部的确定/取消按钮 |
| userNames | String | - | 已选用户/角色名称，逗号分隔 |
| users | Array | [] | 已选用户/角色ID列表 |
| users | Array | [] | 已选用户/角色ID或对象列表 |
| inType | String | 'id' | 传入的users参数类型，'id'表示ID数组，'object'表示对象数组 |
## 事件
@@ -99,7 +100,7 @@ const roles = ref([])
```vue
<el-input @click="selectDialog = true" readonly v-model="names" :placeholder="placeholder"></el-input>
<el-dialog :destroy-on-close="true" width="850px" title="选择角色" v-model="selectDialog">
<selectUsersCom v-if="selectDialog" :ignore-auth="ignoreAuth" v-model:show="selectDialog" :loginKey="'loginRole'"
<selectUsersCom v-if="selectDialog" :ignore-auth="ignoreAuth" v-model:show="selectDialog" :selectType="'Role'"
v-model:users="selectRoles" v-model:userNames="names"></selectUsersCom>
</el-dialog>