User source
All access data (users and passwords) required for authentication are stored in the user database (user source). In the current version, configure the user source in the Admin Portal under Portal > User source. In addition to the local user source (XML database), external user sources such as
are also available for configuration.
Use the Admin Portal to configure the user source whenever possible. Manual editing of conf/server.xml should only be used for recovery or advanced troubleshooting if the Admin Portal is not accessible.
The user source is used when logging in via local authorization using POST /authentication/user/login API {REST}
Example: Requesting an access token by local login for the REST API:
curl -X POST -i -H 'Accept: application/json' -H 'Authorization: Basic YWRtaW46YWRtaW4=' http://localhost:8080/webPDF/rest/authentication/user/login
With the Authorization header the user is logged in via Basic and admin:admin (BASE64 encoded YWRtaW46YWRtaW4=) and his user data is checked against the configured user source.
This registration is
a) for the portal and
b) for the web services
used.
Default user source
After installation, an XML user database is used. If you use webPDF's default installation option, the user database is located in conf/users.xml and can be configured via the Admin Portal under Users.
The default database includes a user called admin (admin group) with the password admin and a user called user (user group) with the password user.