Changing the admin Password

uvuyo currently only uses one user to connect to the system. The user is the admin user and when installed the default password for the admin user is 2Yetis. In a customer environment you would like to change the password to restrict users from accessing the system.

To change the password of the admin user you first need to encode the new password. Therefor you need to use the rest API to encode the password. Running a Rest call is done in two steps. First you need to Authenticate yourself using a REST call. In return you will receive a token which you can use in sequent REST calls.

Login #

To authenticate yourself you need to run the following curl call:

curl --request POST \
  --url https://<url>/uvuyo/api/v1.0/login \
  --header 'Content-Type: application/json' \
  --data '{
	"username": "<username",
	"password": "<password>"
}'

You will need to replace the <username> and <password> with the username and password of your system. The default username and password when uvuyo is freshly installed are admin/2Yetis.

Also you need to set the correct url to your installation.

In return you will receive a token that you the use in the authentication header of subsequent REST calls.

Sample Response:

{
	"token": "eyJhbGciOiJIUzUxMiJ9.eyJyb2xlIjpb..."
}

Encode the password #

To now encode a password you need to run the following curl command:

curl --request GET \
  --url 'https://uvuyo.on2yetis.net/uvuyo/api/v1.0/encode?password=<password>' \
  --header 'Authorization: Bearer <beared>

You will need to replace <password> with the password you want to encode. Also you need to change <bearer> in the authorization of the header to the token you received during the login call described above.

Sample Response:

xhi6JKF08G/MtICgLNmrTHy87cKC013o+KFCzmzwOzQ=

Setting the password in the default.properties file #

Copy the password you received and edit the $UVUYO_HOME/etc/default.properties file. Where $UVUYO_HOME is the directory where you installed uvuyo. The file should exist since it also contains your license key. If it does not exist, you would need to create the file. When creating the file make sure that it only can be read by the user running the uvuyo node, since it might contain security relevant information – like the encrypted password you are just about to set.

Add the following entry to the $UVUYO_HOME/etc/default.properties file or find the entry and override the value:

uvuyo.user.password=<value>

You will need to replace <value> with the value you received from the curl command when encoding the password.

After chaning the admin password you need to restart the uvuyo node.