From a15a1311e4aa7bfb49fa8f07925514ee8b24e7f3 Mon Sep 17 00:00:00 2001 From: Amber Alston Date: Mon, 20 Oct 2025 11:25:07 -0600 Subject: [PATCH 1/6] Update enterprise-portal-about.mdx Add note about handling Safe Link users --- docs/vendor/enterprise-portal-about.mdx | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/vendor/enterprise-portal-about.mdx b/docs/vendor/enterprise-portal-about.mdx index 4881e8a967..faccb3a585 100644 --- a/docs/vendor/enterprise-portal-about.mdx +++ b/docs/vendor/enterprise-portal-about.mdx @@ -33,10 +33,10 @@ For information about using the Enterprise Portal, see [Access and Use the Enter * The Enterprise Portal is Beta. The features and functionality of the Enterprise Portal are subject to change. -* Air gap instance records do not appear in the Enterprise Portal until the end customer creates an air gap instance record by either uploading a support bundle for that instance or manually entering instance information. For more information, see [View Active and Inactive Instances](/vendor/enterprise-portal-use#view-active-and-inactive-instances) in _Access and Use the Enterprise Portal_. - * Installation and upgrade instructions are available only for Embedded Cluster and Helm installations. The Enterprise Portal does not provide instructions for installing and upgrading with KOTS in existing clusters. +* Air gap instance records do not appear in the Enterprise Portal until the end customer creates an air gap instance record by either uploading a support bundle for that instance or manually entering instance information. For more information, see [View Active and Inactive Instances](/vendor/enterprise-portal-use#view-active-and-inactive-instances) in _Access and Use the Enterprise Portal_. + ## Comparison to the Download Portal The Enterprise Portal is the next generation version of the Replicated Download Portal. Compared to the Download Portal, the Enterprise Portal not only provides access to installation assets and instructions, but also allows users to track available updates, manage their team and service accounts, view the status of their instances, view license details, and more. These features are designed to make it easier for your customers to manage their instances of your application from a centralized location outside of the installation environment. @@ -51,7 +51,9 @@ You can configure the Enterprise Portal to use a custom domain, add links and co For more information about customizing the Enterprise Portal, see [Customize the Enterprise Portal](enterprise-portal-configure). -For information about how to set a custom domain for the Enterprise Portal, see [Use Custom Domains](/vendor/custom-domains-using). +For information about how to set a custom domain for the Enterprise Portal, see [Use Custom Domains](/vendor/custom-domains-using). + +For any enterprise customers using link transformers such as Microsoft Defender Safe Links, it is recommended that you ask to have your custom Enterprise Portal domain added to their list of trusted domains to prevent issues with rewrapping breaking legitimate URLs in Enterprise generated emails. You can enable and disable access to the Enterprise Portal for all customers, or on a per-customer basis. For more information about how to enable access, see [Manage Customer Access](/vendor/enterprise-portal-invite#manage-ep-access). From 6cdece815c1e2e1a8ec1476ce8d1518365184f6d Mon Sep 17 00:00:00 2001 From: Amber Alston Date: Mon, 20 Oct 2025 11:32:30 -0600 Subject: [PATCH 2/6] Update enterprise-portal-about.mdx --- docs/vendor/enterprise-portal-about.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/vendor/enterprise-portal-about.mdx b/docs/vendor/enterprise-portal-about.mdx index faccb3a585..6e624fecb4 100644 --- a/docs/vendor/enterprise-portal-about.mdx +++ b/docs/vendor/enterprise-portal-about.mdx @@ -53,7 +53,7 @@ For more information about customizing the Enterprise Portal, see [Customize the For information about how to set a custom domain for the Enterprise Portal, see [Use Custom Domains](/vendor/custom-domains-using). -For any enterprise customers using link transformers such as Microsoft Defender Safe Links, it is recommended that you ask to have your custom Enterprise Portal domain added to their list of trusted domains to prevent issues with rewrapping breaking legitimate URLs in Enterprise generated emails. +For any enterprise customers using link transformers such as Microsoft Defender Safe Links, you may need to request a "Do not rewrite the following URLs" exclusion policy for your custom Enterprise Portal domain in order to prevent issues with rewrapping breaking legitimate URLs in Enterprise generated emails. You can enable and disable access to the Enterprise Portal for all customers, or on a per-customer basis. For more information about how to enable access, see [Manage Customer Access](/vendor/enterprise-portal-invite#manage-ep-access). From 9d9141518d05385679da6491b8565f57d5e745da Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Mon, 20 Oct 2025 12:00:05 -0600 Subject: [PATCH 3/6] docs edits --- docs/vendor/custom-domains-using.md | 10 ++++++++++ docs/vendor/enterprise-portal-about.mdx | 6 ++---- 2 files changed, 12 insertions(+), 4 deletions(-) diff --git a/docs/vendor/custom-domains-using.md b/docs/vendor/custom-domains-using.md index 1738f4518b..d0672b3961 100644 --- a/docs/vendor/custom-domains-using.md +++ b/docs/vendor/custom-domains-using.md @@ -6,6 +6,12 @@ For information about adding and managing custom domains with the Vendor API v3, For more information about custom domains, see [About Custom Domains](custom-domains). +## Known Issue + +If you use a custom domain for the Replicated Enterprise Portal and any of your customers use link transformers such as Microsoft Defender Safe Links, then there is a known issue where legitimate URLs in emails generated by the Enterprise Portal can break due to rewrapping. To avoid this issue, request a "Do not rewrite the following URLs" exclusion policy for your custom Enterprise Portal domain. + +For more information, see [About the Enterprise Portal](enterprise-portal-about). + ## Add a Custom Domain in the Vendor Portal {#add-domain} To add and verify a custom domain: @@ -14,6 +20,10 @@ To add and verify a custom domain: 1. In the **Add custom domain** dropdown, select the target Replicated endpoint. + :::note + There is a known issue when using a custom domain for the Enterprise Portal if any of your customers use link transformers such as Microsoft Defender Safe Links. See [Known Issue](#known-issue) above. + ::: + The **Configure a custom domain** wizard opens. custom domain wizard diff --git a/docs/vendor/enterprise-portal-about.mdx b/docs/vendor/enterprise-portal-about.mdx index 6e624fecb4..5ac58a498e 100644 --- a/docs/vendor/enterprise-portal-about.mdx +++ b/docs/vendor/enterprise-portal-about.mdx @@ -27,6 +27,8 @@ The following diagram shows how customers can use the Enterprise Portal to acces As shown in the diagram above, your licensed customers can access the installation and update instructions for one or more application releases by logging in to the Enterprise Portal. The Enterprise Portal tracks the customer's installation attempts and progress, and shares those insights back to the Vendor Portal. After installing, customers can also upload support bundles in the Enterprise Portal. Support bundles uploaded to the Enterprise Portal are automatically made available to you in the Vendor Portal. +You can enable and disable access to the Enterprise Portal for all customers, or on a per-customer basis. For more information about how to enable access, see [Manage Customer Access](/vendor/enterprise-portal-invite#manage-ep-access). + For information about using the Enterprise Portal, see [Access and Use the Enterprise Portal](enterprise-portal-use). ## Limitations @@ -53,10 +55,6 @@ For more information about customizing the Enterprise Portal, see [Customize the For information about how to set a custom domain for the Enterprise Portal, see [Use Custom Domains](/vendor/custom-domains-using). -For any enterprise customers using link transformers such as Microsoft Defender Safe Links, you may need to request a "Do not rewrite the following URLs" exclusion policy for your custom Enterprise Portal domain in order to prevent issues with rewrapping breaking legitimate URLs in Enterprise generated emails. - -You can enable and disable access to the Enterprise Portal for all customers, or on a per-customer basis. For more information about how to enable access, see [Manage Customer Access](/vendor/enterprise-portal-invite#manage-ep-access). - ## About Instance Reporting with the Enterprise Portal This section describes the instance reporting functionality of the Enterprise Portal. From 6e4c9e5cb5d2bf0882fc4dbf6b9ade6cbd63bd73 Mon Sep 17 00:00:00 2001 From: Amber Alston Date: Mon, 20 Oct 2025 14:26:20 -0600 Subject: [PATCH 4/6] Update custom-domains-using.md --- docs/vendor/custom-domains-using.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/vendor/custom-domains-using.md b/docs/vendor/custom-domains-using.md index d0672b3961..e84c14ec84 100644 --- a/docs/vendor/custom-domains-using.md +++ b/docs/vendor/custom-domains-using.md @@ -10,8 +10,6 @@ For more information about custom domains, see [About Custom Domains](custom-dom If you use a custom domain for the Replicated Enterprise Portal and any of your customers use link transformers such as Microsoft Defender Safe Links, then there is a known issue where legitimate URLs in emails generated by the Enterprise Portal can break due to rewrapping. To avoid this issue, request a "Do not rewrite the following URLs" exclusion policy for your custom Enterprise Portal domain. -For more information, see [About the Enterprise Portal](enterprise-portal-about). - ## Add a Custom Domain in the Vendor Portal {#add-domain} To add and verify a custom domain: From 145c12b0b27cfac9ce71e3405d448e47ca3d91a0 Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Mon, 20 Oct 2025 14:45:57 -0600 Subject: [PATCH 5/6] edits --- docs/vendor/custom-domains-using.md | 6 +----- docs/vendor/custom-domains.md | 6 +++++- docs/vendor/enterprise-portal-about.mdx | 2 ++ 3 files changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/vendor/custom-domains-using.md b/docs/vendor/custom-domains-using.md index e84c14ec84..a7dd385c1c 100644 --- a/docs/vendor/custom-domains-using.md +++ b/docs/vendor/custom-domains-using.md @@ -6,10 +6,6 @@ For information about adding and managing custom domains with the Vendor API v3, For more information about custom domains, see [About Custom Domains](custom-domains). -## Known Issue - -If you use a custom domain for the Replicated Enterprise Portal and any of your customers use link transformers such as Microsoft Defender Safe Links, then there is a known issue where legitimate URLs in emails generated by the Enterprise Portal can break due to rewrapping. To avoid this issue, request a "Do not rewrite the following URLs" exclusion policy for your custom Enterprise Portal domain. - ## Add a Custom Domain in the Vendor Portal {#add-domain} To add and verify a custom domain: @@ -19,7 +15,7 @@ To add and verify a custom domain: 1. In the **Add custom domain** dropdown, select the target Replicated endpoint. :::note - There is a known issue when using a custom domain for the Enterprise Portal if any of your customers use link transformers such as Microsoft Defender Safe Links. See [Known Issue](#known-issue) above. + There is a known issue when using a custom domain for the Enterprise Portal if any of your customers use link transformers such as Microsoft Defender Safe Links. For more information, see [Known Issue](custom-domains-using#known-issue) in _About Custom Domains_. ::: The **Configure a custom domain** wizard opens. diff --git a/docs/vendor/custom-domains.md b/docs/vendor/custom-domains.md index fc50146740..e54a44634e 100644 --- a/docs/vendor/custom-domains.md +++ b/docs/vendor/custom-domains.md @@ -38,4 +38,8 @@ Using custom domains has the following limitations: - Each custom domain can only be used by one team. -- For [Replicated Embedded Cluster](/vendor/embedded-overview) installations, any Helm [`extensions`](/reference/embedded-config) that you add in the Embedded Cluster Config do not use custom domains. During deployment, Embedded Cluster pulls both the repo for the given chart and any images in the chart as written. Embedded Cluster does not rewrite image names to use custom domains. \ No newline at end of file +- For [Replicated Embedded Cluster](/vendor/embedded-overview) installations, any Helm [`extensions`](/reference/embedded-config) that you add in the Embedded Cluster Config do not use custom domains. During deployment, Embedded Cluster pulls both the repo for the given chart and any images in the chart as written. Embedded Cluster does not rewrite image names to use custom domains. + +## Known Issue + +If you use a custom domain for the Replicated [Enterprise Portal](/vendor/enterprise-portal-about) and any of your customers use link transformers such as Microsoft Defender Safe Links, then there is a known issue where legitimate URLs in emails generated by the Enterprise Portal can break due to rewrapping. To avoid this issue, request a "Do not rewrite the following URLs" exclusion policy for your custom Enterprise Portal domain. \ No newline at end of file diff --git a/docs/vendor/enterprise-portal-about.mdx b/docs/vendor/enterprise-portal-about.mdx index 5ac58a498e..fefd2c921a 100644 --- a/docs/vendor/enterprise-portal-about.mdx +++ b/docs/vendor/enterprise-portal-about.mdx @@ -39,6 +39,8 @@ For information about using the Enterprise Portal, see [Access and Use the Enter * Air gap instance records do not appear in the Enterprise Portal until the end customer creates an air gap instance record by either uploading a support bundle for that instance or manually entering instance information. For more information, see [View Active and Inactive Instances](/vendor/enterprise-portal-use#view-active-and-inactive-instances) in _Access and Use the Enterprise Portal_. +* There is a known issue when using a custom domain for the Enterprise Portal if any of your customers use link transformers such as Microsoft Defender Safe Links. For more information, see [Known Issue](custom-domains-using#known-issue) in _About Custom Domains_. + ## Comparison to the Download Portal The Enterprise Portal is the next generation version of the Replicated Download Portal. Compared to the Download Portal, the Enterprise Portal not only provides access to installation assets and instructions, but also allows users to track available updates, manage their team and service accounts, view the status of their instances, view license details, and more. These features are designed to make it easier for your customers to manage their instances of your application from a centralized location outside of the installation environment. From f75330265c2d0b6e6a5e9e681926cd812d0dcbf8 Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Mon, 20 Oct 2025 14:49:03 -0600 Subject: [PATCH 6/6] fix link --- docs/vendor/custom-domains-using.md | 2 +- docs/vendor/enterprise-portal-about.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/vendor/custom-domains-using.md b/docs/vendor/custom-domains-using.md index a7dd385c1c..16f6d0e5df 100644 --- a/docs/vendor/custom-domains-using.md +++ b/docs/vendor/custom-domains-using.md @@ -15,7 +15,7 @@ To add and verify a custom domain: 1. In the **Add custom domain** dropdown, select the target Replicated endpoint. :::note - There is a known issue when using a custom domain for the Enterprise Portal if any of your customers use link transformers such as Microsoft Defender Safe Links. For more information, see [Known Issue](custom-domains-using#known-issue) in _About Custom Domains_. + There is a known issue when using a custom domain for the Enterprise Portal if any of your customers use link transformers such as Microsoft Defender Safe Links. For more information, see [Known Issue](custom-domains#known-issue) in _About Custom Domains_. ::: The **Configure a custom domain** wizard opens. diff --git a/docs/vendor/enterprise-portal-about.mdx b/docs/vendor/enterprise-portal-about.mdx index fefd2c921a..dc3331fde4 100644 --- a/docs/vendor/enterprise-portal-about.mdx +++ b/docs/vendor/enterprise-portal-about.mdx @@ -39,7 +39,7 @@ For information about using the Enterprise Portal, see [Access and Use the Enter * Air gap instance records do not appear in the Enterprise Portal until the end customer creates an air gap instance record by either uploading a support bundle for that instance or manually entering instance information. For more information, see [View Active and Inactive Instances](/vendor/enterprise-portal-use#view-active-and-inactive-instances) in _Access and Use the Enterprise Portal_. -* There is a known issue when using a custom domain for the Enterprise Portal if any of your customers use link transformers such as Microsoft Defender Safe Links. For more information, see [Known Issue](custom-domains-using#known-issue) in _About Custom Domains_. +* There is a known issue when using a custom domain for the Enterprise Portal if any of your customers use link transformers such as Microsoft Defender Safe Links. For more information, see [Known Issue](custom-domains#known-issue) in _About Custom Domains_. ## Comparison to the Download Portal