You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/deployment/mendix-cloud-deploy/custom-domains.md
+10-7Lines changed: 10 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -126,23 +126,26 @@ Once you have a signed SSL/TLS certificate, you can upload it by following these
126
126
127
127
6. Paste the signed **TLS Certificate** (in PEM format).
128
128
129
-
7. Paste an **Intermediate Certificate Chain**. This is optional, but highly recommended. The intermediate certificate chain is provided by your certificate authority.
129
+
7. Paste an **Intermediate Certificate Chain**. While optional for modern browsers, it is mandatory for programmatic access and service consumption (like OData). The intermediate certificate chain is provided by your certificate authority.
The intermediate certificates of the main certificate authorities are included in the built-in CA databases of modern browsers. Therefore, you do not need to include an intermediate certificate to serve your website through SSL/TLS to users of modern browsers.
136
+
The intermediate certificates of the main certificate authorities are included in the built-in CA databases of modern browsers. Therefore, you do not need to include an intermediate certificate to serve your website through SSL/TLS for users with modern browsers.
137
137
138
-
However, you cannot predict how your users will attempt to connect to your website; not including an intermediate certificate may result in connection issues for some users.
138
+
However, intermediate certificate chains are mandatory for programmatic access and service consumption, such as [OData services](/refguide/consumed-odata-services/), and missing intermediate certificates will cause service consumption failures even when browser access works normally. Tools such as curl, programming languages, and operating systems do not automatically resolve missing intermediate certificates.
139
139
140
-
Tools such as curl do not recognize intermediate certificates automatically. Because of this, intermediate certificates are highly recommended but optional.
141
-
140
+
You cannot predict how your users will attempt to connect to your website, and not including an intermediate certificate may result in connection issues for some users. To this end, Mendix recommends always including the intermediate certificate chain to ensure reliable connectivity for all use cases.
142
141
{{% /alert %}}
143
142
144
143
You can now configure your custom domain. See [Configuring a Custom Domain](#Configuring), below.
145
144
145
+
{{% alert color="info" %}}
146
+
After uploading, always verify your certificate using an SSL checker to identify any missing intermediate certificates before they cause service disruptions.
147
+
{{% /alert %}}
148
+
146
149
## Uploading Your Own Custom Domain Certificate{#Uploading}
147
150
148
151
To upload a custom domain certificate, you need to have the following things prepared:
@@ -163,7 +166,7 @@ To upload the custom domain certificate, follow these steps:
163
166
164
167
5. Paste the **TLS Private Key**.
165
168
166
-
6. Paste an **Intermediate Certificate Chain**. This is optional, but most browsers require it. The intermediate certificate chain is provided by your certificate authority.
169
+
6. Paste an **Intermediate Certificate Chain**. While optional for modern browsers, it is mandatory for programmatic access and service consumption (like OData). The intermediate certificate chain is provided by your certificate authority.
@@ -204,7 +207,7 @@ You can do this by editing an existing custom domain certificate. To update an e
204
207
1. Click the **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) icon on the CSR of interest.
205
208
2. Select **Edit**.
206
209
3. Paste the signed **TLS Certificate**.
207
-
4. Paste the**Intermediate Certificate Chain**. This is optional, but most browsers require it. The intermediate certificate chain is provided by your certificate authority.
210
+
4. Paste an**Intermediate Certificate Chain**. While optional for modern browsers, it is mandatory for programmatic access and service consumption (like OData). The intermediate certificate chain is provided by your certificate authority.
208
211
209
212
{{% alert color="warning" %}}
210
213
To edit an existing custom domain certificate, you need the following:
0 commit comments