Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Changing the Master Password

    March 23, 2025
    + 12
    The master password can be changed, by means of the REST API.

    HTTP Method and URI

    POST /node/controller/changeMasterPassword

    Description

    This command sets the master password for the current node. The Full Admin, Local User Security Admin, or External User Security Admin role is required.

    For a full description of system secrets and their management, see Manage System Secrets.

    Curl Syntax

    curl -X POST http://127.0.0.1:8091/node/controller/changeMasterPassword
 -u Administrator:password
 -d newPassword=<new-password>

    Responses

    Success returns 200 OK. Failure to authenticate due to incorrect credentials returns 401 Unauthorized. Attempt to authenticate with the wrong role returns 403 Forbidden, and a message such as {"message":"Forbidden. User needs the following permissions","permissions":["cluster.admin.security!write"]}. An incorrectly expressed URI fails with 404 Object Not Found.

    Example

    The following example changes the master password.

    curl -v -X POST http://localhost:8091/node/controller/changeMasterPassword \
-u Administrator:password \
-d newPassword=o12m2Bb?ufh3*a

    See Also

    For a full description of system secrets and their management, see Manage System Secrets.