From 7eb4b49f5492d1e40aeb49b3ba44404bda402384 Mon Sep 17 00:00:00 2001 From: Adrian Machado Date: Wed, 27 Dec 2023 20:30:52 -0500 Subject: [PATCH 1/3] Document the enabled setting for DP --- docs/articles/dev-portal-json.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/articles/dev-portal-json.md b/docs/articles/dev-portal-json.md index b623e663..e7060f42 100644 --- a/docs/articles/dev-portal-json.md +++ b/docs/articles/dev-portal-json.md @@ -5,7 +5,7 @@ title: Config (dev-portal.json) The `dev-portal.json` file is the code that drives most of the configuration of your Zuplo Gateway. The primary uses of the `dev-portal.json` file are: -- Enabling or disabling features of the Gateway +- Enabling or disabling features of the Developer Portal - Setting custom values to various configuration - Mapping environment variables to settings @@ -37,6 +37,8 @@ authentication to the [Developer Portal](../articles/developer-portal). ## Properties +- **enabled** - Determines whether the Developer Portal is enabled or disabled. + Default: true - **pageTitle** - The title of the Developer Portal as seen in the tabs of most browsers. Default: Zuplo Dev Portal. - **faviconUrl** - The icon or 'favicon' for your Developer Portal, as seen in From b4fc9ca88b0968d41bdc732873c9efba7ee6896f Mon Sep 17 00:00:00 2001 From: Adrian Machado Date: Wed, 27 Dec 2023 20:34:50 -0500 Subject: [PATCH 2/3] Add link to auth --- docs/articles/dev-portal-json.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/articles/dev-portal-json.md b/docs/articles/dev-portal-json.md index e7060f42..78922411 100644 --- a/docs/articles/dev-portal-json.md +++ b/docs/articles/dev-portal-json.md @@ -55,7 +55,8 @@ authentication to the [Developer Portal](../articles/developer-portal). Portal? This is required to enable self-serve of API keys. You must select an Auth Provider if this is enabled - by default we give you a demo Auth0 configuration (you should not use this in production). -- **authentication** - Authentication settings +- **authentication** - Authentication settings. Checkout the + [setup guide](./dev-portal-auth.md) to get started. - **provider** - Choose your preferred identity provider (Auth0, Okta, etc.). Note, we provide you with a demonstration identity provider - this is fine for learning how Zuplo works but should not be used in production or on real From 6adfd1285a2d0a23018553e6aef875ca65731d32 Mon Sep 17 00:00:00 2001 From: Adrian Machado Date: Wed, 27 Dec 2023 20:37:56 -0500 Subject: [PATCH 3/3] Fix bolding on auth page --- docs/articles/dev-portal-auth.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/articles/dev-portal-auth.md b/docs/articles/dev-portal-auth.md index 27b33b7a..d8d08677 100644 --- a/docs/articles/dev-portal-auth.md +++ b/docs/articles/dev-portal-auth.md @@ -38,7 +38,7 @@ Web Applications" You must set the following fields in the Auth0 application: -** Application URIs** +**Application URIs** - **Allowed Callback URLs**: Add your docs site url (i.e. `https://my-app.zuplo.app/docs/`). Note, you should include the trailing @@ -48,14 +48,14 @@ You must set the following fields in the Auth0 application: - **Allowed Web Origins**: Add your docs site url without the path (i.e. `https://my-app.zuplo.app`) -** Refresh Token Rotation** +**Refresh Token Rotation** - **Rotation**: Enabled - **Reuse Interval**: Leave at `0` -** Refresh Token Expiration** +**Refresh Token Expiration** - **Absolute Expiration**: Enabled - **Absolute Lifetime**: Can be whatever time you want, default is `2592000`