diff --git a/CHANGELOG.md b/CHANGELOG.md index 70079afb8f..af728f3a65 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,6 +14,7 @@ All notable changes to this project will be documented in this file. - **Post-release**: Added troubleshooting steps to the *Virtual Machine (OVA)* installation guide. ([#8562](https://github.com/wazuh/wazuh-documentation/pull/8562)) - **Post-release**: Added a note in the installation guide about firewall configuration to prevent communication issues between Wazuh components. ([#8622](https://github.com/wazuh/wazuh-documentation/pull/8622)) - **Post-release**: Added instruction to run Windows backup commands in CMD (Command Prompt) and not PowerShell. ([#8672](https://github.com/wazuh/wazuh-documentation/pull/8672)) +- **Post-release**: Added a new page on Update DNS certificates ([#2606](https://github.com/wazuh/internal-devel-requests/issues/2606)) ### Changed diff --git a/source/cloud-service/your-environment/custom-dns.rst b/source/cloud-service/your-environment/custom-dns.rst index 11f6038e6f..df99872597 100644 --- a/source/cloud-service/your-environment/custom-dns.rst +++ b/source/cloud-service/your-environment/custom-dns.rst @@ -34,3 +34,9 @@ After providing the above and applying the configuration, create a ``CNAME`` DNS .. note:: Your Wazuh Cloud environment is still accessible through the default URL, even if you have configured a custom domain. + + +.. toctree:: + :maxdepth: 1 + + update-custom-dns \ No newline at end of file diff --git a/source/cloud-service/your-environment/update-custom-dns.rst b/source/cloud-service/your-environment/update-custom-dns.rst new file mode 100644 index 0000000000..792ac6b07e --- /dev/null +++ b/source/cloud-service/your-environment/update-custom-dns.rst @@ -0,0 +1,58 @@ +.. Copyright (C) 2015, Wazuh, Inc. + +.. meta:: + :description: Check out how to update the certificates for your custom domain to access an environment in Wazuh Cloud. Learn more about it in this section of the documentation. + +Update your domain certificates +=============================== +To keep your custom domain secured with a valid SSL/TLS certificate, you'll need to replace your existing certificates in the **Wazuh Cloud Console** from time to time. +The process below walks you through removing the old certificates and uploading new ones, without touching your DNS records. + +- **1. Log in & open the Custom DNS panel**: + + - Sign in to your Wazuh Cloud account. + - From the main dashboard, go to your environment details page → **Manage** → **Custom DNS**. + + .. thumbnail:: ../../images/cloud-service/custom-dns-menu.png + :title: Manage menu + :alt: Manage menu + :align: center + :width: 80% + + - The Custom DNS panel will pop up showing your current domain. + + .. thumbnail:: ../../images/cloud-service/custom-dns-panel.png + :title: Custom DNS panel + :alt: Custom DNS panel + :align: center + :width: 80% + +- **2. Remove the existing certificates**: + + - Click the **Remove configuration** button, and wait for the page to reload. + + .. thumbnail:: ../../images/cloud-service/custom-dns-remove-config.png + :title: Remove old configuration + :alt: Remove old configuration + :align: center + :width: 80% + + - Note that, at this moment, your environment's custom domain will briefly lose its HTTPS certificate, making it temporarily unreachable via that hostname. + +- **3. Upload your new certificates**: + + - Re-open the Custom DNS panel if it closed. + - Enter the desired custom domain name and, paste or upload your new certificate files ``(.crt/.pem)`` and its matching private key. + + .. thumbnail:: ../../images/cloud-service/custom-dns-add-certs.png + :title: Add new certificates + :alt: Add new certificates + :align: center + :width: 80% + + - Click the **Apply** button to start deploying the new cert. + +- **4. Wait for deployment & verify**: + + - The **Apply** button will show a loading spinner. This typically takes just a few seconds. + - Once the configuration is complete, your environment will be accessible again via HTTPS at your custom domain. No DNS or ``CNAME`` changes are required. diff --git a/source/images/cloud-service/custom-dns-add-certs.png b/source/images/cloud-service/custom-dns-add-certs.png new file mode 100644 index 0000000000..92a6030980 Binary files /dev/null and b/source/images/cloud-service/custom-dns-add-certs.png differ diff --git a/source/images/cloud-service/custom-dns-menu.png b/source/images/cloud-service/custom-dns-menu.png new file mode 100644 index 0000000000..e6c1a9eb3b Binary files /dev/null and b/source/images/cloud-service/custom-dns-menu.png differ diff --git a/source/images/cloud-service/custom-dns-panel.png b/source/images/cloud-service/custom-dns-panel.png new file mode 100644 index 0000000000..f15bb56ced Binary files /dev/null and b/source/images/cloud-service/custom-dns-panel.png differ diff --git a/source/images/cloud-service/custom-dns-remove-config.png b/source/images/cloud-service/custom-dns-remove-config.png new file mode 100644 index 0000000000..2edc4d2023 Binary files /dev/null and b/source/images/cloud-service/custom-dns-remove-config.png differ