Compare commits
7 Commits
rowa97-pat
...
rowa97-pat
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3b87411246 | ||
|
|
a54073c148 | ||
|
|
190ae8cf8b | ||
|
|
34d440f60d | ||
|
|
6e7497bf41 | ||
|
|
39754e693a | ||
|
|
f6349afbbd |
48
articles/hubs/auth0-integration.md
Normal file
48
articles/hubs/auth0-integration.md
Normal file
@@ -0,0 +1,48 @@
|
||||
# Auth0 Integration
|
||||
|
||||
## What
|
||||
Auth0 allows you to add a login form with user access management to your documentation.
|
||||
|
||||
## How
|
||||
1. Create an account or login to [Auth0](https://auth0.com/)
|
||||
2. Select **Applications** in the Auth0 menu
|
||||
|
||||

|
||||
|
||||
3. Click **+ Create Application**
|
||||
|
||||

|
||||
|
||||
4. Input a **Name** for your application
|
||||
|
||||

|
||||
|
||||
5. Select **Regular Web Applications**
|
||||
6. Click **Create**
|
||||
7. Select **Application Settings**
|
||||
|
||||

|
||||
|
||||
8. Copy the **Domain** and paste it in **Hosted Login Page**
|
||||
9. Input a **?client=** at the end of the pasted **Domain** from above
|
||||
10. Copy the **Client ID** and paste it after the **?client=** in **Hosted Login Page** from above
|
||||
|
||||
> Example Hosted Login Page: robertwallach.auth0.com?client=XwYWVMLp7rJOkJ6iU51MwJHm2w2AAfGl
|
||||
|
||||
11. Copy the **Client Secret** and paste it in **Client Secrets** in Hubs
|
||||
|
||||

|
||||
|
||||
12. Copy the **Callback URL** generated by Hubs in **Authorizations** and paste it in **Allowed Callback URLs** in Auth0
|
||||
|
||||
> Make sure the callbacks start with https instead of http and that they match
|
||||
|
||||

|
||||
|
||||
13. Select **Hosted Pages** in the Auth0 menu
|
||||
|
||||
> Make sure **Customize Login Page** is turned on
|
||||
|
||||
14. Click on **Build** to start the Publishing process
|
||||
|
||||
> To login to your Hub with Auth0, make sure you add users in the Auth0 Dashboard
|
||||
16
articles/modeling/grouping-tagging.md
Normal file
16
articles/modeling/grouping-tagging.md
Normal file
@@ -0,0 +1,16 @@
|
||||
# Grouping & Tagging Endpoints in OpenAPI
|
||||
|
||||

|
||||
|
||||
## What
|
||||
|
||||
Use tags to group API endpoints and provide an additional layer of organization in your OpenAPI files. When rendering your OpenAPI in read view, Stoplight will group API endpoints by their first tag.
|
||||
|
||||
## How
|
||||
|
||||
1. Click **Tag** in the top Modeling toolbar
|
||||
2. Input a **Name**
|
||||
3. Input a **Tag description** (optional)
|
||||
4. Select the endpoint you want to tag
|
||||
5. Open the **tags** dropdown, and select the tag that you just created
|
||||
6. Switch to read view and you should see the endpoint grouped under that tag in the sidebar
|
||||
BIN
assets/gifs/modeling-tagging.gif
Normal file
BIN
assets/gifs/modeling-tagging.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 958 KiB |
Reference in New Issue
Block a user