updateCredentials #
Updates a user credentials for the specified authentication strategy.
updateCredentials(strategy, kuid, credentials, [options]);
Property | Type | Description |
---|---|---|
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
Property | Type (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);
}
Edit this page on Github(opens new window)