Basic authentication

By default, Wazi Image Builder uses a basic registry as the user registry for authentication and provides a default user ID 'wibadmin'. Also, you can add more users to this registry.

If you need to change the default authentication before you modify the basic authentication, see Default authentication and authorization.

To add more users to the basic registry, complete the following steps before you start the server.

1. Find the encryption key that is specified by wlp.password.encryption.key in file <installation_directory>/Liberty/usr/servers/wib-server/bootstrap.properties.
2. If the Java™ path is not set up, you need to set up the path before you run the next command.
3. Run the following command where you installed the web server.

   <installation_directory>/Liberty/bin/securityUtility encode --encoding=aes --key=<encryption_key_found_above> <new password value>

   Copy the following encoded string into file <installation_directory>/Liberty/usr/servers/wib-server/basicauth-conf.xml. For example, replace the text in bold with the new encoded password value.

   <basicRegistry id="wib" realm="wib"> 
           <user name="wibadmin" password="{aes}AM1LZsnwLRNsVtYAiwqhVDO9/RL+NgYthDZXZhQgARtB"/>
   		<user name="new user" password="<new user password>"/>
   		<user name="another new user" password="<another new user password>"/>
       </basicRegistry>

   This step only allows the user to authenticate to the web server. For more information about authorization, see Managing users and roles.