Skip to content

Commit 46d45b8

Browse files
authored
add auth keyword to auth pages (#841)
* add auth keyword to auth pages * undo format
1 parent 7d3a74d commit 46d45b8

File tree

3 files changed

+51
-41
lines changed

3 files changed

+51
-41
lines changed

authentication-personalization/authentication-setup.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
title: "Authentication setup"
33
description: "Guarantee privacy of your docs by authenticating users"
44
icon: "file-lock"
5+
keywords: ['auth']
56
---
67
Authentication requires users to log in before accessing your documentation. This guide covers setup for each available handshake method.
78

authentication-personalization/overview.mdx

Lines changed: 49 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,19 @@
22
title: "Overview"
33
description: "Control who sees your documentation and customize their experience"
44
icon: "badge-info"
5+
keywords: ["auth"]
56
---
7+
68
<Info>
7-
Authentication methods are available on the [Growth and Enterprise plans](https://mintlify.com/pricing?ref=authentication).
9+
Authentication methods are available on the [Growth and Enterprise
10+
plans](https://mintlify.com/pricing?ref=authentication).
811
</Info>
912

1013
There are three approaches to manage access and customize your documentation based on user information.
1114

12-
* **Authentication**: Complete privacy protection for all content with full content customization.
13-
* **Partial authentication**: Page-by-page access control with full content customization.
14-
* **Personalization**: Content customization with **no security guarantees**. All content remains publicly accessible.
15+
- **Authentication**: Complete privacy protection for all content with full content customization.
16+
- **Partial authentication**: Page-by-page access control with full content customization.
17+
- **Personalization**: Content customization with **no security guarantees**. All content remains publicly accessible.
1518

1619
**Choose authentication** if you need complete security and privacy for all your documentation, including pages, images, search results, and AI assistant features.
1720

@@ -26,50 +29,55 @@ Authentication and personalization offer multiple handshake methods for controll
2629
### Available for all methods
2730

2831
**JSON Web Token (JWT)**: Custom system where you manage user tokens with full control over the login flow.
29-
* Pros of JWT:
30-
* Reduced risk of API endpoint abuse.
31-
* No CORS configuration.
32-
* No restrictions on API URLs.
33-
* Cons of JWT:
34-
* Must be compatible with your existing login flow.
35-
* Dashboard sessions and docs authentication are decoupled, so your team will log into your dashboard and your docs separately.
36-
* When you refresh user data, users must log into your docs again. If your users' data changes frequently, they must log in frequently or risk having stale data in your docs.
32+
33+
- Pros of JWT:
34+
- Reduced risk of API endpoint abuse.
35+
- No CORS configuration.
36+
- No restrictions on API URLs.
37+
- Cons of JWT:
38+
- Must be compatible with your existing login flow.
39+
- Dashboard sessions and docs authentication are decoupled, so your team will log into your dashboard and your docs separately.
40+
- When you refresh user data, users must log into your docs again. If your users' data changes frequently, they must log in frequently or risk having stale data in your docs.
3741

3842
**OAuth 2.0**: Third-party login integration like Google, GitHub, or other OAuth providers.
39-
* Pros of OAuth 2.0:
40-
* Heightened security standard.
41-
* No restrictions on API URLs.
42-
* Cons of OAuth 2.0:
43-
* Requires significant work if setting up an OAuth server for the first time.
44-
* Dashboard sessions and docs authentication are decoupled, so your team will log into your dashboard and your docs separately.
4543

46-
### Available for authentication and partial authentication
44+
- Pros of OAuth 2.0:
45+
- Heightened security standard.
46+
- No restrictions on API URLs.
47+
- Cons of OAuth 2.0:
48+
- Requires significant work if setting up an OAuth server for the first time.
49+
- Dashboard sessions and docs authentication are decoupled, so your team will log into your dashboard and your docs separately.
50+
51+
### Available for authentication and partial authentication
4752

4853
**Mintlify dashboard**: Allow all of your dashboard users to access your docs.
49-
* Pros of Mintlify dashboard:
50-
* No configuration required.
51-
* Enables private preview deployments, restricting access to authenticated users only.
52-
* Cons of Mintlify dashboard:
53-
* Requires all users of your docs to have an account in your Mintlify dashboard.
54+
55+
- Pros of Mintlify dashboard:
56+
- No configuration required.
57+
- Enables private preview deployments, restricting access to authenticated users only.
58+
- Cons of Mintlify dashboard:
59+
- Requires all users of your docs to have an account in your Mintlify dashboard.
5460

5561
**Password**: Shared access with a single global password. Used for access control only. Does not allow for personalization.
56-
* Pros of password:
57-
* Simple setup with no configuration required to add new users, just share the password.
58-
* Cons of password:
59-
* Lose personalization features since there is no way to differentiate users with the same password.
60-
* Must change the password to revoke access.
62+
63+
- Pros of password:
64+
- Simple setup with no configuration required to add new users, just share the password.
65+
- Cons of password:
66+
- Lose personalization features since there is no way to differentiate users with the same password.
67+
- Must change the password to revoke access.
6168

6269
### Available for personalization
6370

6471
**Shared session**: Use the same session token as your dashboard to personalize content.
65-
* Pros of shared session:
66-
* Users that are logged into your dashboard are automatically logged into your docs.
67-
* User sessions are persistent so you can refresh data without requiring a new login.
68-
* Minimal setup.
69-
* Cons of shared session:
70-
* Your docs will make a request to your backend.
71-
* You must have a dashboard that uses session authentication.
72-
* CORS configuration is generally required.
72+
73+
- Pros of shared session:
74+
- Users that are logged into your dashboard are automatically logged into your docs.
75+
- User sessions are persistent so you can refresh data without requiring a new login.
76+
- Minimal setup.
77+
- Cons of shared session:
78+
- Your docs will make a request to your backend.
79+
- You must have a dashboard that uses session authentication.
80+
- CORS configuration is generally required.
7381

7482
## Content customization
7583

@@ -108,10 +116,10 @@ Authentication is an enterprise feature. {
108116
```
109117
110118
<Note>
111-
The information in `user` is only available for logged in users. For
112-
logged out users, the value of `user` will be `{}`. To prevent the page from
113-
crashing for logged out users, always use optional chaining on your `user`
114-
fields. For example, `{user.org?.plan}`.
119+
The information in `user` is only available for logged in users. For logged
120+
out users, the value of `user` will be `{}`. To prevent the page from crashing
121+
for logged out users, always use optional chaining on your `user` fields. For
122+
example, `{user.org?.plan}`.
115123
</Note>
116124
117125
### API key prefilling

authentication-personalization/partial-authentication-setup.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
title: "Partial authentication setup"
33
description: "Control access to specific pages"
44
icon: "file-lock-2"
5+
keywords: ["auth"]
56
---
67

78
Partial authentication lets you protect private documentation while keeping other pages publicly viewable. Users can browse public content freely and authenticate only when accessing protected pages.

0 commit comments

Comments
 (0)