Users

Provisioning of the admin password and user.

• since 1.4

users.xml

<users>
  <!-- name for webserver login -->  
  <user name="admin">
    <!-- password for webserver login, bcryp 10 rounds: "Password" -> $2y$10$EmmSyCKWVIMD/nFAV4l.gOCzCozL6MalD3RWAAhNi8xHJgEZgdFT6 -->  
    <password>$2y$10$EmmSyCKWVIMD/nFAV4l.gOCzCozL6MalD3RWAAhNi8xHJgEZgdFT6</password>
    <role>admin</role>
    <changePassword>false</changePassword>    <!-- force to change the password --> 
  </user>
  <!-- A single user
       parameters:
         name: The name of the user used for login.
               It is at the same time the unique id.
               type: string
               matched against: '^[^:]*$' -->
  <user name="">
    <!-- The name of the user used for display.
         If it is empty, the name will be used.
         type: string -->
    <displayName></displayName>
    <!-- The password for the user.
         If the password is provisioned, you have to
         supply a hashed password.
         You can create a compatible hash using the
         tool provided in the web interface
         at the following url:
         `https:
         Over the api, you send the password over HTTPS
         in clear text, where it gets hashed in the
         webserver.
         type: string -->
    <password></password>
    <!-- The role for the user.
         an admin is allowed to do everything.
         A user is not allowed to configure anything by default,
         additional rights for the user have to be explicitly granted
         type: enum
         accepted values:
           user
           admin -->
    <role>user</role>
    <!-- The image for the user, base64 encoded.
         The image should not exceed 300x300px.
         type: string -->
    <image></image>
    <!-- Indicates whether a user has to change his password.
         This flag will only be evaluated by client side logins
         and any tool handling the login should honour it.
         type: boolean -->
    <changePassword>false</changePassword>
  </user>
</users>