Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New IA - Portal Section #5863

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

New IA - Portal Section #5863

wants to merge 1 commit into from

Conversation

sharadregoti
Copy link
Contributor

@sharadregoti sharadregoti commented Jan 6, 2025

User description

For internal users - Please add a Jira DX PR ticket to the subject!



Preview Link


https://deploy-preview-5863--tyk-docs.netlify.app/docs/nightly/portal/overview/
https://deploy-preview-5863--tyk-docs.netlify.app/docs/nightly/portal/install/
https://deploy-preview-5863--tyk-docs.netlify.app/docs/nightly/portal/developers/
https://deploy-preview-5863--tyk-docs.netlify.app/docs/nightly/portal/api-access/
https://deploy-preview-5863--tyk-docs.netlify.app/docs/nightly/portal/customization/
https://deploy-preview-5863--tyk-docs.netlify.app/docs/nightly/portal/settings/
https://deploy-preview-5863--tyk-docs.netlify.app/docs/nightly/product-stack/tyk-enterprise-developer-portal/api-documentation/tyk-edp-api/

Description


Screenshots (if appropriate)


Checklist

  • I have added a preview link to the PR description.
  • I have reviewed the suggestions made by our AI (PR Agent) and updated them accordingly (spelling errors, rephrasing, etc.)
  • I have reviewed the guidelines for contributing to this repository.
  • I have read the technical guidelines for contributing to this repository.
  • Make sure you have started your change off our latest master.
  • I labeled the PR

PR Type

Documentation


Description

  • Added comprehensive installation guide for Tyk Enterprise Developer Portal.

  • Introduced detailed API consumer management documentation.

  • Enhanced FAQ section with Enterprise Developer Portal-specific questions.

  • Updated configuration settings for improved reference linking.


Changes walkthrough 📝

Relevant files
Documentation
3 files
install.md
Added detailed installation guide for Tyk Enterprise Developer Portal.
+1852/-0
developers.md
Added API consumer management and registration documentation.
+367/-0 
faq.md
Enhanced FAQ with Enterprise Developer Portal-specific questions.
+36/-0   
Configuration changes
1 files
config.toml
Updated configuration for reference linking and error handling.
+2/-0     
Additional files
58 files
api-access.md +308/-27
customization.md +3097/-0
overview.md +417/-0 
settings.md +76/-25 
portal-1.9.0-list-of-endpoints.md +0/-235 
bootstrapping-portal.md +0/-92   
install-tyk-enterprise-portal.md +0/-79   
install-portal-using-docker-compose.md +0/-285 
install-portal-using-docker.md +0/-294 
install-portal-using-helm.md +0/-75   
install-portal-using-new-helm.md +0/-66   
install-portal-using-rpm.md +0/-118 
overview.md +0/-34   
create-api-product-and-plan.md +0/-73   
create-orgs-and-catalogs.md +0/-85   
customize-products-and-plans.md +0/-63   
customize-sign-up-form.md +0/-69   
enterprise-portal-concepts.md +0/-101 
getting-started-with-enterprise-portal.md +0/-28   
setup-email-notifications.md +0/-66   
with-tyk-self-managed-as-provider.md +0/-62   
.placeholder [link]   
configure-webhooks.md +0/-374 
customise-user-model.md +0/-80   
theme-upgrades.md +0/-112 
tyk-enterprise-developer-portal.md +0/-32   
api-consumer-portal.md +0/-21   
access-api-product.md +0/-60   
register-portal.md +0/-45   
reset-password.md +0/-45   
api-access.md +0/-29   
approve-requests.md +0/-42   
configuring-custom-rate-limit-keys.md +0/-74   
manage-apps-credentials.md +0/-36   
content-manager-workflow.md +0/-24   
create-new-page-template.md +0/-142 
developer-workflow.md +0/-25   
edit-manage-page-content.md +0/-44   
email-customization.md +0/-89   
file-structure-concepts.md +0/-189 
full-customisation.md +0/-19   
menus-customisation.md +0/-88   
templates.md +0/-1902
quick-customisation.md +0/-109 
create-api-product-and-plan.md +0/-67   
customise-menus.md +0/-60   
manage-get-started-guides-for-api-products.md +0/-106 
publish-api-products-and-plans.md +0/-78   
with-tyk-self-managed-as-provider.md +0/-55   
add-organisations.md +0/-46   
approve-self-registering-requests.md +0/-45   
invite-codes.md +0/-48   
manage-api-consumer-organisations.md +0/-119 
manage-api-consumers.md +0/-39   
manage-api-users.md +0/-46   
manage-catalogues.md +0/-59   
managing-access.md +0/-23   
menu.yaml +32/-301

💡 PR-Agent usage: Comment /help "your question" on any pull request to receive relevant information

Copy link
Contributor

github-actions bot commented Jan 6, 2025

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 5 🔵🔵🔵🔵🔵
🧪 No relevant tests
🔒 Security concerns

Sensitive information exposure:
The documentation includes hardcoded sensitive information such as passwords and API secrets in example configurations. These should be replaced with placeholders or instructions to use secure methods for managing sensitive data.

⚡ Recommended focus areas for review

Possible Sensitive Information Exposure

The example configurations in the installation guide include hardcoded sensitive information such as database passwords (secr3t, sup3rsecr3t) and API secrets. Ensure these are replaced with placeholders or environment variables to prevent accidental exposure.

    -- Creating user
    CREATE USER admin WITH ENCRYPTED PASSWORD 'secr3t';
    CREATE DATABASE portal;
    GRANT ALL PRIVILEGES ON DATABASE portal TO admin;
    ```

3. **Create the database volume and launch the database**

    The next step is to launch the PostgreSQL database for the portal. To achieve this, create a data volume for the database first:
    ```console
    docker volume create tyk-portal-postgres-data
    ```

    Then launch the PostgreSQL instance by executing the following command:
    ```container
    docker run \
    -d \
    --name tyk-portal-postgres \
    --restart on-failure:5 \
    -e POSTGRES_PASSWORD=secr3t \
    -e PGDATA=/var/lib/postgresql/data/pgdata \
    --mount type=volume,source=tyk-portal-postgres-data,target=/var/lib/postgresql/data/pgdata \
    --mount type=bind,src=$(pwd)/init.sql,dst=/docker-entrypoint-initdb.d/init.sql \
    --network tyk-portal \
Deprecated SQLite Usage

The documentation mentions SQLite support, which is deprecated as of Tyk 5.7.0. Ensure this is clearly communicated and alternative options are emphasized to avoid confusion for users.

SQLite support will be deprecated from Tyk 5.7.0. To avoid disrupution, please transition to PostgreSQL, MongoDB or one of the listed compatible alternatives.
{{< /note >}}
Duplicate Commands in Docker Compose

The Docker Compose instructions contain duplicate commands for launching and cleaning up containers. This redundancy may confuse users and should be streamlined.

docker-compose --env-file .env up -d
docker-compose --env-file .env up -d

Copy link
Contributor

github-actions bot commented Jan 6, 2025

PR Code Suggestions ✨

Explore these optional code suggestions:

CategorySuggestion                                                                                                                                    Score
General
Configure the refLinksNotFoundURL to handle broken links gracefully

Ensure that the refLinksNotFoundURL value is correctly configured to avoid potential
issues with broken links in the documentation.

tyk-docs/config.toml [11]

-refLinksNotFoundURL = ""
+refLinksNotFoundURL = "/404.html"
Suggestion importance[1-10]: 8

Why: The suggestion improves the configuration by setting a value for refLinksNotFoundURL, which ensures that broken links in the documentation are handled gracefully by redirecting users to a 404 page. This enhances user experience and prevents confusion caused by unresolved links.

8

Copy link

netlify bot commented Jan 6, 2025

PS. Pls add /docs/nightly to the end of url

Name Link
🔨 Latest commit 4736495
🔍 Latest deploy log https://app.netlify.com/sites/tyk-docs/deploys/677b9d691902b800089450a6
😎 Deploy Preview https://deploy-preview-5863--tyk-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

1 similar comment
Copy link

netlify bot commented Jan 6, 2025

PS. Pls add /docs/nightly to the end of url

Name Link
🔨 Latest commit 4736495
🔍 Latest deploy log https://app.netlify.com/sites/tyk-docs/deploys/677b9d691902b800089450a6
😎 Deploy Preview https://deploy-preview-5863--tyk-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Contributor Author

@sharadregoti sharadregoti left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove all the TODOs from this section.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant