Skip to main content

Enable governance for Aiven for Apache Kafka® Limited availability

Enable governance in Aiven for Apache Kafka® to establish a secure and compliant framework to manage your Aiven for Apache Kafka clusters efficiently.

Impact of enabling governance​

  • Existing topics:

    • The selected default group is assigned as the owner of all existing Apache Kafka resources.
    • Ownership details for Apache Kafka resources are visible in the Apache Kafka topic catalog.
    • Users from different groups can still claim ownership of individual resources.

  • Topic creation workflow:

    • There is no impact on existing topics.
    • You can continue to create topics in your Aiven for Apache Kafka service. Governance in Aiven for Apache Kafka introduces an additional request-and-approval process to claim ownership of topics from the Apache Kafka topic catalog.
    • All topics align with your organization's data management policies.

Prerequisites​

Enable governance​

  1. Access the Aiven Console and click Admin.

  2. On the organization page, click Apache Kafka governance.

  3. Click Enable governance.

  4. Select a user group to manage topics. This group is the default group and owns all topics in the organization.

    • If no user group exists, click Create new user group.
      1. Enter the group name and description.
      2. Click Create group.
      3. Select the created user group.

  5. Click Next.

  6. Define resource visibility for the Apache Kafka topic catalog.

  7. Select Project or Organization visibility.

    • Project: Users can view Aiven for Apache Kafka resources in the Apache Kafka topic catalog if they are added to the project.
    • Organization: Users can view all Aiven for Apache Kafka resources across the organization in the Apache Kafka topic catalog, regardless of their access to individual projects.

  8. Click Next.

  9. Set global default topic configurations:

    • To use the default settings, click Keep defaults and review the default values on the confirmation window.
    • Click Enable governance.

    Alternatively, to customize:

    • Enter your global default topic configurations.
    • Click Enable governance to apply your changes.
    note

    Global topic configurations apply only to new topics created after the policies are updated. Existing topics are not be affected by these changes.

Change the default user group​

To change the default user group after enabling governance:

  1. On the organization page, click Apache Kafka governance.
  2. Click Change next to Default user group.
  3. Select a new user group from the list.
  4. If no suitable group exists, create a group and select it.
  5. Click Save.

Update global topic configurations​

To change global topic configurations after enabling governance:

  1. On the organization page, click Apache Kafka governance.
  2. Click Change next to Global default topic configurations.
  3. Update the global default topic configurations as needed.
  4. Modify retention policies, partition strategies, or other settings.
  5. Click Save.

Disable governance​

  1. On the organization page, click Apache Kafka governance.
  2. Expand Governance is enabled for your organization.
  3. Click Disable.

Impact of disabling governance​

  • Existing ownership assigned to the Apache Kafka resources remains unchanged.
  • Re-enabling governance later preserves the Apache Kafka resources ownership from the last time it was disabled.
  • Apache Kafka resources claimed by specific groups retain their ownership.
  • If you select a different user group when re-enabling governance, Apache Kafka resources under the previous default group are assigned to the new default governance group.