Authenticating with a User and Password

For this example, start the server using:

nats-server --user myname --pass password

You can encrypt passwords to pass to nats-server using the simple NATS CLI tool:

nats server passwd

? Enter password [? for help] **********************
? Reenter password [? for help] **********************

$2a$11$qbtrnb0mSG2eV55xoyPqHOZx/lLBlryHRhU3LK2oOPFRwGF/5rtGK

and use the hashed password in the server config. The client still uses the plain text version.

The code uses localhost:4222 so that you can start the server on your machine to try them out.

Connecting with a User/Password

When logging in with a password nats-server will take either a plain text password or an encrypted password.

Go

// Set a user and plain text password
nc, err := nats.Connect("127.0.0.1", nats.UserInfo("myname", "password"))
if err != nil {
    log.Fatal(err)
}
defer nc.Close()

// Do something with the connection

Java

JavaScript

Python

C#

Ruby

C

Connecting with a User/Password in the URL

Most clients make it easy to pass the user name and password by accepting them in the URL for the server. This standard format is:

nats://user:password@server:port

Using this format, you can connect to a server using authentication as easily as you connected with a URL:

Go

// Set a user and plain text password
nc, err := nats.Connect("myname:[email protected]")
if err != nil {
    log.Fatal(err)
}
defer nc.Close()

// Do something with the connection

Java

JavaScript

Python

C#

Ruby

C