Skip to content

Commit b512b04

Browse files
authored
Docs: update docs (#275)
1 parent 2e412cc commit b512b04

File tree

11 files changed

+125
-17
lines changed

11 files changed

+125
-17
lines changed
101 KB
Loading
54 KB
Loading
6.81 KB
Loading

docs/guide/advanced/sso.md

Lines changed: 52 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ Click on the new application and we will see the application credentials option,
9999

100100
- Just fill in the corresponding parameters in the Alist background single sign-on
101101

102-
Go to the left column and find `Login and Share` == Fill in the callback parameters **`http://127.0.0.1:5234/api/auth/sso_callback`**==
102+
Go to the left column and find `Login and Share` ==Fill in the callback parameters **`http://127.0.0.1:5234/api/auth/sso_callback`**==
103103

104104
```Callback parameter example
105105
http://127.0.0.1:5244/api/auth/sso_callback
@@ -359,4 +359,54 @@ Don't worry, after using single sign-on to register and log in to AList, log in
359359
This is because [Single Sign-On Automatic Registration](#sso-auto-register) is not enabled for the AList account, and the single sign-on cannot be registered as an AList account
360360

361361
- If you are an administrator, you can turn it on
362-
- If you are a user, you can contact the administrator to enable
362+
- If you are a user, you can contact the administrator to enable
363+
364+
<br/>
365+
366+
## **Sso compatibility mode**
367+
368+
AList single -point login is bound to Dingtalk, and then opens Alist in the **`Dingtalk`** application, When you log in, choose Dingtalk login and jump to your computer browser. After authorization, you find that there is no response, because the browser cannot jump to the Dingtalk application inner browser page
369+
370+
At this time, you need to open the **`sso compatability mode`** again to click on the login to log in successfully
371+
372+
**AList applied in Dingtalk and opened as shown in the figure:**
373+
374+
![](/img/advanced/sso_cm.png)
375+
376+
<br/>
377+
378+
### **How to create the application in Dingtalk workbench**
379+
380+
A picture teaches you to create a new application and add it
381+
382+
- LOGO is not modified when the newly -built newly built, you can wait for the newly built and then modify ^(See_Figure_2)^
383+
- If you just browse AList in the Dingtalk application, you do n’t need a single -point login management, you do n’t need to set up a single -point login configuration, you can just add an application
384+
385+
![](/img/advanced/sso_add_app.png)
386+
387+
<br/>
388+
389+
#### Modify the application logo
390+
391+
Open [**DingTalk open platform management**](https://open-dev.dingtalk.com/fe/app#/corp/app) Find your newly built app to modify the logo.
392+
393+
![](/img/advanced/sso_fix_logo.png)
394+
395+
<br/>
396+
397+
398+
399+
### **redirect url**
400+
401+
After turning on **`Sso compatibility mode`** Then you need to log in to the corresponding software to modify the redirect url to change it to the two redirect url below
402+
403+
- `GitHub` only needs to add one:`http(s)://You_Url/api/auth/sso_get_token`
404+
- `Microsoft` and` Google` both need to be added, you can add multiple Redirect urls, so you only need to add two Redirect URLs.
405+
406+
```New
407+
http(s)://You_Url/api/auth/get_sso_id
408+
http(s)://You_Url/api/auth/sso_get_token
409+
```
410+
411+
If you enable the **Sso compatibility mode** if you do not modify it, you will prompt `Invalid Redirect URL` Error
412+

docs/guide/drivers/Terabox.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,18 +25,17 @@ star: true
2525

2626
![terabox](/img/drivers/terabox/terabox1.png)
2727

28+
<br/>
2829

2930

30-
<br/>
3131

32-
## **JS Token**
32+
## **Download api**
3333

34-
1. Find the copied `jsToken` value for the tag with the `Payload` page in the request
35-
2. Search for `jsToken` directly in the search bar to immediately find the request with the `Payload` page
34+
**Download api needs to choose ==`Crack`==** ,before you can use ^(v3.29)^
3635

37-
![terabox](/img/drivers/terabox/terabox_js_token.png)
3836

3937

38+
<br/>
4039

4140
#### **Note: The default root file path is /**
4241

docs/guide/drivers/alias.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@ Test other:/test4/video/tv
132132
```
133133
134134
- local1 local2 merged together
135-
- If 2 uses a local proxy and 1 uses `302`, call 2 first
135+
- If 2 uses a local proxy and 1 uses `302`, call 1 first
136136
- Test 3 and Test 4 merged together
137137
- If 3 uses a local proxy and 4 uses `302`, call 4 first
138138
- In the above two cases, two different folders will appear for display, which will be displayed as follows without interfering with each other

docs/guide/drivers/aliyundrive_open.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ typeof fetch !== "undefined" && getLimit()
4141

4242
**Aliyundrive VIP**[https://www.aliyundrive.com/cpx/member](https://www.aliyundrive.com/cpx/member?userCode=MzAwMDM1&disableNav=YES)
4343

44-
- <i class="fa-solid fa-lightbulb fa-bounce" style="color: orange;"></i> Click the link to get [**Coupon**](https://www.aliyundrive.com/cpx/member?userCode=MzAwMDM1&disableNav=YES), which is cheaper than buying directly on Alibaba Cloud Disk~ `20T`Large -capacity package, sale in a limited time~
44+
- <i class="fa-solid fa-lightbulb fa-bounce" style="color: orange;"></i> Click the link to get [**Coupon**](https://www.aliyundrive.com/cpx/member?userCode=MzAwMDM1&disableNav=YES), which is cheaper than buying directly on Alibaba Cloud Disk~ `20TB`Large -capacity package, sale in a limited time~ There are also oversized `50TB` capacity
4545

4646
<img src="/img/drivers/aliyun/vip2.png" alt="vip2" style="zoom:20%;" />
4747

@@ -65,7 +65,7 @@ typeof fetch !== "undefined" && getLimit()
6565
:::danger About Alibaba Cloud OAUTH verification API cannot be connected
6666

6767
1. Since the original API `https://api.nn.ci` is blocked by SNI, resulting in the case that cannot be connected, two new APIs are provided for use:
68-
- `https://api-cf.nn.ci` (A layer of Cloudflare)
68+
- `https://api-cf.nn.ci` (A layer of Cloudflare)
6969
- `https://api.xhofe.top` (LiaoNing multi -line, Sponsored by [Asia Cloud](https://www.asiayun.com/aff/QQCOOQKZ))
7070

7171
2. You need to replace the OAUTH token link in the ALIYUNDRIVE_OPEN configuration to
@@ -75,6 +75,10 @@ typeof fetch !== "undefined" && getLimit()
7575

7676
3. check the details:https://github.com/alist-org/alist/discussions/4572
7777

78+
4. Can I create an authorized OAUTH verification API by themselves?
79+
- The is not available at present, but you can reverse proxy [Source Station](https://api.nni.ci)
80+
81+
7882

7983
:::
8084

docs/zh/guide/advanced/sso.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -352,3 +352,53 @@ Alist 后台参数也记得写好保存,写好保存后也要回到个人资
352352

353353
- 如果你是管理员,你可以开启一下
354354
- 如果你是用户,你可以去联系管理员开启
355+
356+
<br/>
357+
358+
## **SSO兼容模式**
359+
360+
AList单点登录绑定了钉钉,然后在 **`钉钉`** 应用内打开AList,登录时选择钉钉登录会跳到自己电脑浏览器,授权后你会发现没有后续反应了,因为浏览器无法跳回钉钉应用內浏览器页面
361+
362+
这时候就需要打开 **`SSO兼容模式`** 再去点击登录就可以登录成功了
363+
364+
**AList应用在钉钉软件内打开如图所示:**
365+
366+
![](/img/advanced/sso_cm.png)
367+
368+
<br/>
369+
370+
### **如何创建钉钉工作台內应用**
371+
372+
一张图教你新建一个应用并且添加
373+
374+
- LOGO是默认的新建时不可修改,可以等新建好后再修改 ^(看图二)^
375+
- 如果你只是在钉钉应用內浏览AList,不使用单点登录后台管理,可以不用设置单点登录配置只添加应用就可以
376+
377+
![](/img/advanced/sso_add_app.png)
378+
379+
<br/>
380+
381+
#### 修改应用LOGO
382+
383+
打开 [**钉钉开放平台后台**](https://open-dev.dingtalk.com/fe/app#/corp/app) 找到你新建的应用进去修改LOGO就可以
384+
385+
![](/img/advanced/sso_fix_logo.png)
386+
387+
<br/>
388+
389+
390+
391+
### **回调参数(重定向链接)**
392+
393+
开启 **`SSO兼容模式`** 后需要将单点登录对应的软件内修改一下回调参数链接改成下面的两个回调参数
394+
395+
- `GitHub` 只需要添加一条:`http(s)://You_Url/api/auth/sso_get_token`
396+
- `微软``谷歌`两个都需要添加,可以添加多个,所以只需要新增两条就可以不用删除旧的
397+
398+
```New
399+
http(s)://You_Url/api/auth/get_sso_id
400+
http(s)://You_Url/api/auth/sso_get_token
401+
```
402+
403+
如果启用 SSO兼容模式 不修改则会提示 `invalid redirect url` 错误
404+

docs/zh/guide/drivers/Terabox.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,15 +28,16 @@ star: true
2828

2929
<br/>
3030

31-
## **JS Token**
3231

33-
1. 在请求中找到带有`载荷`页面的标签的复制`jsToken`
34-
2. 直接在搜索栏搜索`jsToken`即可立刻找到带有`载荷`页面的请求
3532

36-
![terabox](/img/drivers/terabox/terabox_js_token.png)
33+
## **下载接口**
3734

35+
**下载接口需要选择 ==`非官方`==** ,才可以使用 ^(v3.29)^
3836

3937

38+
39+
<br/>
40+
4041
#### **注意事项:根文件路径默认是 /**
4142

4243
- 如果你不想写根目录 **/** 要写其他目录

docs/zh/guide/drivers/alias.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -140,7 +140,7 @@ star: true
140140
```
141141
142142
- 本地1 本地2 合并在一起了
143-
- 如果2 使用的本地代理,1 使用的`302`,优先调用 2
143+
- 如果2 使用的本地代理,1 使用的`302`,优先调用 1
144144
- 测试3 测试4 合并在一起了
145145
- 如果3 使用的本地代理,4 使用的`302`,优先调用 4
146146
- 以上两种情况会出现两个不同的文件夹来展示,会如下展示,不会互相干扰

0 commit comments

Comments
 (0)