SDK
SDK Javascript v7.x
2

createCredentials #

Creates authentication credentials for a user.


createCredentials(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 {
  await kuzzle.security.createUser('foo', {
    content: {
      profileIds: ['default'],
      fullName: 'John Doe'
    },
    credentials: {}
  });
  const response = await kuzzle.security.createCredentials(
    'local',
    'foo',
    { username: 'foo', password: 'bar' }
  );
  console.log(response);
  /*
    { username: 'foo' }
  */
  console.log('Credentials successfully created');
} catch (e) {
  console.error(e);
}