Kafka User Management

Menu

Instaclustr provides both a User Management UI and User Management API for Kafka clusters to help you with managing users. The User Management UI and API provide four functions:

  • List Users
  • Add Users
  • Change User Passwords
  • Delete Users

All users created or listed in the Users list will have read and write access to all topics in the cluster. If you require any other configuration, please submit a support request.

All Kafka clusters will have an ickafka user automatically created as a convenience, which can be deleted. If the ickafka user is deleted or has the password changed the new password will not be stored and the credentials will disappear from the cluster’s Connection Info page. Because changed passwords and new user passwords will not be stored, ensure you make a note of the passwords to user accounts.

User Management UI

These examples show how to use the features of the Instaclustr console’s User Management UI.

List Users

  1. To list available Kafka users, first select your Kafka cluster in the Instaclustr console. With your Kafka cluster selected, click Users from the Kafka menu.
  2. The Users page will list all Kafka users on the cluster.

Add User

  1. To add a new Kafka user, first select your Kafka cluster in the Instaclustr console. With your Kafka cluster selected, click Users from the Kafka menu.
  2. From the Users page, click the New User… button. You will be redirected to the New User page.

  3. On the New User page, enter the desired username and password for the new Kafka user, and your Instaclustr password to confirm your identity. Once you’ve entered the required information, click the Create User button. If your Instaclustr password is correct and your username and password are valid, your new user will be created.

  4. Once the user is created, you will be redirected to the Users page, with a success message displayed at the top of the page. Your new user will be shown in the list of users.

Change User Password

  1. To change the password of an existing Kafka user, first select your Kafka cluster in the Instaclustr console. With your Kafka cluster selected, click Users from the Kafka menu.
  2. From the Users page, click the Change Password… button of the user whose password you want to change. You will be redirected to the Change User Password page.

  3. On the Change User Password page, enter the new password for the User, and your Instaclustr password to confirm your identity. Once you’ve entered the required information, click the Change Password button.

  4. After clicking the Change Password button you will be redirected to the Users page, with a success message displayed at the top of the page.

Delete User

  1. To delete an existing Kafka user, first select your Kafka cluster in the Instaclustr console. With your Kafka cluster selected, click Users from the Kafka menu.

  2. From the Users page, click the Delete User… button of the user whose password you want to change. You will be redirected to the Delete User page.

  3. On the Delete User page, enter your Instaclustr password to confirm your identity. Once you’ve entered your password, click the Delete User button to delete the user.
  4. If the password was entered correctly and validated, you will be redirected to the Users page, with a success message displayed at the top of the page. The deleted user will no longer be shown in the list of users.

User Management API

These examples show how to use the features of the Instaclustr User Management API.

To provide customers with a high level of security, the Kafka User API endpoint will not store or allow customers to retrieve passwords for Kafka users.
For each endpoint listed below, all requests must include basic authentication details:

List Users

  1. To retrieve a list of users currently enabled in the Kafka cluster, make a GET request to:
    https://api.instaclustr.com/provisioning/v1/<cluster_id>/kafka/users
  2. The API should respond with a 200 status code and a JSON list of users. E.g.:

Add User

  1. To add a new user to the Kafka cluster (with read/write access to all topics), make a POST request to:
    https://api.instaclustr.com/provisioning/v1/<cluster_id>/kafka/users
    A request body should be included, specifying the username and password to use. E.g.:
  2. The API should respond with a 201 status code and a short message. E.g.

    Once this message is received, the user should be immediately available for use when connecting to the Kafka cluster.

Change User Password

  1. To change an existing user’s password, make a POST request to:
    https://api.instaclustr.com/provisioning/v1/<cluster_id>/kafka/users/reset-password
    A request body should be included, specifying the username and password to apply. E.g.:
  2. The API should respond with a 200 status code and a short message. E.g.:

Delete User

  1. To delete a Kafka user, make a DELETE request to:
    https://api.instaclustr.com/provisioning/v1/<cluster_id>/kafka/users
    A request body should be included, specifying the username and password to use. E.g.:
  2. The API should respond with a 201 status code and a short message. E.g.

Site by Swell Design Group