Configure Tomcat

This library and associated tools do their work via the Tomcat Manager web application included in the Tomcat distribution. This section describes a simple, minimal server configuration to provide authentication, but does not cover the many other ways to deploy and configure Tomcat. See Authentication for a full description of the many ways this library and associated tools can be used to authenticate to Tomcat, no matter how it is configured.

You will need the URL where the Tomcat Manager application is available. You can use the URL that points directly to the container, or the URL of a proxy like nginx or Apache HTTP Server you have deployed in front of Tomcat. TLS is recommended, but it works without if you must.

You will also need to configure authentication for a user, and grant that user permission to access the Tomcat Manager application. The full details of this procedure can be found in the Tomcat Manager Howto. A short summary is included here.

Configure a user in tomcat-users.xml and grant that user the manager-script role. The username and password can be anything of your choosing. Here’s how to configure the user we will use as an example throughout this documentation:

<tomcat-users>
    ...
    <role rolename="manager-script"/>
    <user username="ace" password="newenglandclamchowder" roles="manager-script"/>
    ...
</tomcat-users>