NEW Nisshi is now backed by Solace, and it's still open sourceRead the blog and hear from the creator →

CLI

User

The user subcommand creates or deletes the SASL SCRAM users that a broker stores, for brokers started with --authentication. It connects to tcp://127.0.0.1:9092 unless you pass --broker.

Create

Create a user with a name and password:

nisshi user create alice alice-secret --mechanism scram256

Delete

Delete a user's credential for a mechanism:

nisshi user delete alice --mechanism scram256

Run nisshi user create --help or nisshi user delete --help for every option.

Notes

  • The broker keeps its users in the storage engine, so it needs an engine that can store them, such as SQLite or PostgreSQL.
  • --mechanism is scram256 or scram512 (the default). The broker keeps a separate credential for each mechanism, so create the user with the mechanism its clients use, or once for each.
  • The password is a command line argument, so it ends up in your shell history, and other users of the machine can see it while the command runs.
  • The nisshi commands, including user, don't log in yet, so they fail against a broker started with --authentication. Create the first user while the broker runs without --authentication, then restart it with --authentication.

The Authentication section of the Nisshi security guide has the full steps, including how to manage users with the Apache Kafka® command line tools once authentication is on.

Previous
topic
Next
Delta