Please use the form below, leaving the prefilled data to help us. Thank you.
Page link: certificates
Document link: _index.md
My Issue/Suggestion
The documentation listed in the certificates page does not match the documentation listed in the client certificate section for REST Calls specifically in regard to Private Cloud implementation. From the docs:
REST call section says use the custom runtime config:
"When you deploy the app elsewhere, the identifier is set in the custom setting ClientCertificateUsages. For testing locally, this can be set as a custom server setting in a Configuration."
Network tab section says uploading in the certificates tab is fine:
"If you are using a custom certificate when setting your Client certificate in your Call REST Service or Call Web Service action, you can set a Web Service Call Name and use it for the service by setting the Web Service Call Name to the call's Client certificate identifier."
From my Mendix Support and Mendix development experience, this confuses developers as it's unclear what the "recommended" method is. Also, talking to some other teammates, it's confusing if Private Cloud even uses that runtime configuration setting at all. I think it would be better to either list both options, or have both sections match.
Additionally, the runtime configuration section is confusing for Private Cloud. It mentions that when configuring to:
set the value of ClientCertificateUsages must be a comma-separated list of key/value items. A key/value item must be specified as "identifier": "path to certificate".
For web services, use the imported web service name as the identifier.
For REST services, use the host name of the remote server as the identifier.
For Private Cloud specifically, this is confusing as there's no documentation of where to put the certificates or what this file path would be. I know from development experience that you can just put things in the Resources folder of the app directory and use things there, but that is not listed and I found that via trial and error. It's also confusing when using Private Cloud what that file path would be if you use that folder. This confusion leads to people using the Certificates/Network tab since it's easier (and also, I believe, it's the reason we added it in the first place for Private Cloud) I think it would be good to add documentation either in the Resources folder section, or here, or both, detailing that.
Thank you!
Please use the form below, leaving the prefilled data to help us. Thank you.
Page link: certificates
Document link: _index.md
My Issue/Suggestion
The documentation listed in the certificates page does not match the documentation listed in the client certificate section for REST Calls specifically in regard to Private Cloud implementation. From the docs:
REST call section says use the custom runtime config:
Network tab section says uploading in the certificates tab is fine:
From my Mendix Support and Mendix development experience, this confuses developers as it's unclear what the "recommended" method is. Also, talking to some other teammates, it's confusing if Private Cloud even uses that runtime configuration setting at all. I think it would be better to either list both options, or have both sections match.
Additionally, the runtime configuration section is confusing for Private Cloud. It mentions that when configuring to:
For Private Cloud specifically, this is confusing as there's no documentation of where to put the certificates or what this file path would be. I know from development experience that you can just put things in the Resources folder of the app directory and use things there, but that is not listed and I found that via trial and error. It's also confusing when using Private Cloud what that file path would be if you use that folder. This confusion leads to people using the Certificates/Network tab since it's easier (and also, I believe, it's the reason we added it in the first place for Private Cloud) I think it would be good to add documentation either in the Resources folder section, or here, or both, detailing that.
Thank you!