Skip to content

Commit

Permalink
Add stub pages
Browse files Browse the repository at this point in the history
Signed-off-by: Diana <[email protected]>
  • Loading branch information
cloudjumpercat committed Jan 30, 2025
1 parent b4db7f8 commit b3a5522
Show file tree
Hide file tree
Showing 9 changed files with 174 additions and 8 deletions.
16 changes: 8 additions & 8 deletions app/_landing_pages/gateway/security.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -40,18 +40,18 @@ rows:
blocks:
- type: unordered_list
items:
- "[Secure the Admin API](https://docs.konghq.com/gateway/latest/production/running-kong/secure-admin-api/): The Admin API provides a RESTful interface for configuring {{site.base_gateway}} entities. Because this API allows full control of Kong, it is important to secure this API against unwanted access."
- "[Exclude sensitive log data](https://docs.konghq.com/gateway/3.9.x/production/logging/customize-gateway-logs/): Customize the data {{site.base_gateway}} logs to protect private data for GDPR."
- "[Network, firewall, and ports](https://docs.konghq.com/gateway/3.9.x/production/networking/firewall/): Recommended network and firewall settings for {{site.base_gateway}}."
- "[Secure the Admin API](/gateway/secure-the-admin-api/): The Admin API provides a RESTful interface for configuring {{site.base_gateway}} entities. Because this API allows full control of Kong, it is important to secure this API against unwanted access."
- "[Exclude sensitive log data](/gateway/customize-gateway-logs/): Customize the data {{site.base_gateway}} logs to protect private data for GDPR."
- "[Network, firewall, and ports](/gateway/network-ports-firewall/): Recommended network and firewall settings for {{site.base_gateway}}."
- text: "Authentication and authorization"
action:
type: structured_text
config:
blocks:
- type: unordered_list
items:
- "[{{site.konnect_short_name}} SSO](/): Configure single sign-on for {{site.konnect_short_name}}."
- "[{{site.konnect_short_name}} teams and roles](https://docs.konghq.com/konnect/org-management/teams-and-roles/): Use the least priviledge model to by managing authorization with teams and roles."
- "[{{site.konnect_short_name}} SSO](/konnect/sso/): Configure single sign-on for {{site.konnect_short_name}}."
- "[{{site.konnect_short_name}} teams and roles](/konnect/teams-and-roles/): Use the least priviledge model to by managing authorization with teams and roles."
- "[{{site.base_gateway}} RBAC](/gateway/entities/rbac/): Manage {{site.base_gateway}} user permissions with role based access control."
- text: "Data encryption"
action:
Expand All @@ -71,8 +71,8 @@ rows:
blocks:
- type: unordered_list
items:
- "[{{site.base_gateway}} logs](https://docs.konghq.com/gateway/latest/production/logging/log-reference/): Learn how to configure and use {{site.base_gateway}} logs to detect security concerns."
- "[{{site.konnect_short_name}} audit logs](https://docs.konghq.com/konnect/org-management/audit-logging/): Audit logs can help you detect and respond to potential security incidents when they occur."
- "[{{site.base_gateway}} logs](/gateway/logs/): Learn how to configure and use {{site.base_gateway}} logs to detect security concerns."
- "[{{site.konnect_short_name}} audit logs](/konnect/audit-logs/): Audit logs can help you detect and respond to potential security incidents when they occur."
- "[Logging and monitoring plugins](/plugins/?category=analytics-monitoring%2Clogging): Log and monitor {{site.base_gateway}} activity with plugins."

- columns:
Expand Down Expand Up @@ -104,4 +104,4 @@ rows:
See Kong's bug fix policy.
icon: /assets/icons/gateway.svg
cta:
url: "/gateway/latest/support-policy/#bug-fix-guidelines"
url: "/gateway/version-support-policy/"
21 changes: 21 additions & 0 deletions app/_landing_pages/konnect/sso.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
metadata:
title: Konnect single-sign on
content_type: landing_page
description: This page is a sign-post page to the various SSO options with Konnect.

rows:
- header:
type: h1
text: "{{site.konnect_short_name}} SSO"

- header:
type: h2
text: SSO options
columns:
- blocks:
- type: text
config: |
@todo
List of links to SSO how tos for Konnect
18 changes: 18 additions & 0 deletions app/gateway/customize-gateway-logs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
title: Customize Gateway Logs
content_type: reference
layout: reference

products:
- gateway

description: placeholder

related_resources:
- text: "Secure {{site.base_gateway}}"
url: /gateway/security/
---

@todo

Use content from https://docs.konghq.com/gateway/3.9.x/production/logging/customize-gateway-logs/
20 changes: 20 additions & 0 deletions app/gateway/logs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "{{site.base_gateway}} Logs"
content_type: reference
layout: reference

products:
- gateway

description: placeholder

related_resources:
- text: Customize Gateway Logs
url: /gateway/customize-gateway-logs/
- text: "Secure {{site.base_gateway}}"
url: /gateway/security/
---

@todo

Contains content from https://docs.konghq.com/gateway/latest/production/logging/log-reference/ with maybe an examples section with https://docs.konghq.com/gateway/3.9.x/production/logging/update-log-level-dynamically/?
25 changes: 25 additions & 0 deletions app/gateway/network-ports-firewall.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: Network, ports, and firewall for {{site.base_gateway}}
content_type: reference
layout: reference

products:
- gateway

description: placeholder

related_resources:
- text: "Secure {{site.base_gateway}}"
url: /gateway/security/
---

@todo

I don't know if reference is the correct format. Maybe a landing page with separate reference pages?

Possible content:
* https://docs.konghq.com/gateway/3.9.x/production/networking/firewall/
* https://docs.konghq.com/gateway/3.9.x/production/networking/dns-considerations/
* https://docs.konghq.com/gateway/3.9.x/production/networking/cp-dp-proxy/
* https://docs.konghq.com/konnect/network/
* https://docs.konghq.com/gateway/latest/production/networking/default-ports/
18 changes: 18 additions & 0 deletions app/gateway/secure-the-admin-api.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
title: Secure the Admin API
content_type: reference
layout: reference

products:
- gateway

description: placeholder

related_resources:
- text: "Secure {{site.base_gateway}}"
url: /gateway/security/
---

@todo

Use content from https://docs.konghq.com/gateway/latest/production/running-kong/secure-admin-api/
22 changes: 22 additions & 0 deletions app/gateway/version-support-policy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: Kong Gateway Enterprise Version Support

Check failure on line 2 in app/gateway/version-support-policy.md

View workflow job for this annotation

GitHub Actions / Vale

[vale] reported by reviewdog 🐶 [base.Kongterms] Use '{{site.ee_product_name}}' instead of 'Kong Gateway Enterprise'. Raw Output: {"message": "[base.Kongterms] Use '{{site.ee_product_name}}' instead of 'Kong Gateway Enterprise'.", "location": {"path": "app/gateway/version-support-policy.md", "range": {"start": {"line": 2, "column": 8}}}, "severity": "ERROR"}
content_type: reference
layout: reference

tier: enterprise

products:
- gateway

description: placeholder

related_resources:
- text: "Secure {{site.base_gateway}}"
url: /gateway/security/
---

@todo

Content from https://docs.konghq.com/gateway/latest/support-policy/#bug-fix-guidelines


20 changes: 20 additions & 0 deletions app/konnect/audit-logs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "{{site.konnect_short_name}} audit logs"
content_type: reference
layout: reference

products:
- gateway

description: placeholder

related_resources:
- text: "Secure {{site.base_gateway}}"
url: /gateway/security/
---

@todo

Pull content from:
* https://docs.konghq.com/konnect/org-management/audit-logging/
* https://docs.konghq.com/konnect/reference/audit-logs/
22 changes: 22 additions & 0 deletions app/konnect/teams-and-roles.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: Teams and roles
content_type: reference
layout: reference

products:
- gateway

description: placeholder

related_resources:
- text: "Secure {{site.base_gateway}}"
url: /gateway/security/
---

@todo

Pull content from:
* https://docs.konghq.com/konnect/org-management/teams-and-roles/
* https://docs.konghq.com/konnect/org-management/teams-and-roles/manage/
* https://docs.konghq.com/konnect/org-management/teams-and-roles/teams-reference/
* https://docs.konghq.com/konnect/org-management/teams-and-roles/roles-reference/

0 comments on commit b3a5522

Please sign in to comment.