mirror of
https://github.com/taigrr/nats.docs
synced 2025-01-18 04:03:23 -08:00
55 lines
1.3 KiB
Markdown
55 lines
1.3 KiB
Markdown
# Tokens
|
|
|
|
Token authentication is a string that if provided by a client, allows it to connect. It is the most straightforward authentication provided by the NATS server.
|
|
|
|
To use token authentication, you can specify an `authorization` section with the `token` property set:
|
|
|
|
```text
|
|
authorization {
|
|
token: "s3cr3t"
|
|
}
|
|
```
|
|
|
|
Token authentication can be used in the authorization section for clients and clusters.
|
|
|
|
Or start the server with the `--auth` flag:
|
|
|
|
```text
|
|
> nats-server --auth s3cr3t
|
|
```
|
|
|
|
A client can easily connect by specifying the server URL:
|
|
|
|
```text
|
|
> nats-sub -s nats://s3cr3t@localhost:4222 ">"
|
|
Listening on [>]
|
|
```
|
|
|
|
## Bcrypted Tokens
|
|
|
|
Tokens can be bcrypted enabling an additional layer of security, as the clear-text version of the token would not be persisted on the server configuration file.
|
|
|
|
You can generate bcrypted tokens and passwords using the [`mkpasswd`](../../../../nats-tools/mkpasswd.md) tool:
|
|
|
|
```text
|
|
> mkpasswd
|
|
pass: dag0HTXl4RGg7dXdaJwbC8
|
|
bcrypt hash: $2a$11$PWIFAL8RsWyGI3jVZtO9Nu8.6jOxzxfZo7c/W0eLk017hjgUKWrhy
|
|
```
|
|
|
|
Here's a simple configuration file:
|
|
|
|
```text
|
|
authorization {
|
|
token: "$2a$11$PWIFAL8RsWyGI3jVZtO9Nu8.6jOxzxfZo7c/W0eLk017hjgUKWrhy"
|
|
}
|
|
```
|
|
|
|
The client will still require the clear-text token to connect:
|
|
|
|
```text
|
|
nats-sub -s nats://dag0HTXl4RGg7dXdaJwbC8@localhost:4222 ">"
|
|
Listening on [>]
|
|
```
|
|
|