Defines the properties of an Ably Token.

Hierarchy

  • TokenParams

Properties

capability?: string | { [key: string]: capabilityOp[] }

The capabilities associated with this Ably Token. The capabilities value is a JSON-encoded representation of the resource paths and associated operations. Read more about capabilities in the capabilities docs.

Default Value

'{"*":["*"]}'

clientId?: string

A client ID, used for identifying this client when publishing messages or for presence purposes. The clientId can be any non-empty string, except it cannot contain a *. This option is primarily intended to be used in situations where the library is instantiated with a key. Note that a clientId may also be implicit in a token used to instantiate the library. An error is raised if a clientId specified here conflicts with the clientId implicit in the token. Find out more about identified clients.

nonce?: string

A cryptographically secure random string of at least 16 characters, used to ensure the TokenRequest cannot be reused.

timestamp?: number

The timestamp of this request as milliseconds since the Unix epoch. Timestamps, in conjunction with the nonce, are used to prevent requests from being replayed. timestamp is a "one-time" value, and is valid in a request, but is not validly a member of any default token params such as ClientOptions.defaultTokenParams.

ttl?: number

Requested time to live for the token in milliseconds. The default is 60 minutes.

Default Value

60min

Generated using TypeDoc