SDK
SDK Javascript v7.x
2

updateCredentials #

Updates a user credentials for the specified authentication strategy.


updateCredentials(strategy, kuid, credentials, [options]);

PropertyTypeDescription
strategy
string
Strategy to use
kuid
string
User kuid
credentials
object
New credentials
options
object
Query options

credentials #

The credentials to send. The expected properties depend on the target authentication strategy.

Example for the local strategy:

{
  username: 'foo',
  password: 'bar'
}

options #

Additional query options

PropertyType
(default)
Description
queuable
boolean

(true)
If true, queues the request during downtime, until connected to Kuzzle again
refresh
boolean

(false)
If set to wait_for, Kuzzle will not respond until the credentials are indexed
timeout
number

(-1)
Time (in ms) during which a request will still be waited to be resolved. Set it -1 if you want to wait indefinitely
triggerEvents
boolean

(false)
If set to true, will trigger events even if using Embeded SDK. You should always ensure that your events/pipes does not create an infinite loop.
Available since Kuzzle 2.31.0

Resolves #

An object representing the new credentials.
The content depends on the authentication strategy.

Usage #

try {
  const response = await kuzzle.security.updateCredentials(
    'local',
    'john.doe',
    {
      username: 'jdoe',
      password: 'newPassword'
    }
  );
  console.log(response);
  /*
  { username: "jdoe" }
    */
} catch (e) {
  console.error(e);
}