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.