XML Database
The default installation of webPDF employs a user database based on an XML file. The file users.xml is located in the folder conf/.
This default user database contains the following:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users xmlns="http://schema.webpdf.de/1.0/configuration/users">
<user username="admin" password="0cb9e55873a01279f33ccc9e9c61a866:24ef2b38e641189cc5315378b5775005835b1da4" roles="admin,user" uniqueId="dd042dab283143e6a9b689d13136bfe1"/>
<user username="user" password="672faa37fa2e4386dfe24739fba7b99c:3084f65bf6bab3ec04032fc6dc8591bb7aa68eb9" roles="user" uniqueId="6654ffebbbe644c5acb17a816ec73eae"/>
</users>
The following two default users (login) are entered in the user database:
| Login | Password | Group |
|---|---|---|
| admin | admin | admin |
| user | user | user |
To create new users or edit existing ones, use the portal's administration page.
Troubleshooting
The administrator login or password is no longer available
If the local XML user source is active and no administrator can sign in anymore, restore access by editing conf/users.xml directly. For file locations on Windows and Linux, see Directories.
Create a backup copy of conf/users.xml before editing the file manually.
Add the default administrator user again, or replace the existing administrator entry if it no longer works:
<user username="admin" password="0cb9e55873a01279f33ccc9e9c61a866:24ef2b38e641189cc5315378b5775005835b1da4" roles="admin,user" uniqueId="dd042dab283143e6a9b689d13136bfe1"/>
After saving the file, restart the webPDF server. The restored user can then sign in with login admin and password admin.
Use this only as a recovery step. After signing in, change the administrator password or create a new administrator account in the Admin Portal under Users.
Make sure that no other user entry uses the same uniqueId. If the complete local user database is damaged or no local user can be used, replace conf/users.xml with a known valid default file and restart the server.
If an external user source such as LDAP or Active Directory is currently active, first switch the server back to the local XML user source as described in LDAP Server and Active Directory troubleshooting.