In the article Integrating Crowd with Atlassian Confluence, under "2.2 Enable SSO integration with Crowd (Optional)", there are two steps slightly inaccurate:

3 -

Copy the crowd.properties file from CROWD/client/conf/ to CONFLUENCE/confluence/WEB-INF/classes.

I'm not sure why this step would be necessary since the mentioned file is actually found in any Confluence fresh install. Even if the values were changed, the step below tells us to adjust accordingly.

4 -

crowd.base.url

http://localhost:8095/crowd/
If your Crowd server's port is configured differently from the default (i.e. 8095), set it accordingly.

In fact, we must set the full Crowd URL, not only the port. In most cases, the internal Crowd URL indeed is the default, but the proxied address is like http://crowd.mycompany.com/ - which should be used as the actual base url.

Additionally, in the doc Proxying Atlassian server applications with Apache HTTP Server (mod_proxy_http), under "2. Set the context path", we link a KB article to change Crowd's base URL:

In the Tomcat server.xml configuration file for all applications except Crowd

• https://confluence.atlassian.com/crowdkb/how-to-change-the-crowd-base-url-245827278.html

Isn't it the case to "promote" this KB to an official doc?

Thanks!