Managing user group visibility to virtual topics

You can manage which virtual topics are available to users by assigning specific user groups to selected virtual topics. This means that only users in the groups you select can view and subscribe to the virtual topics that you have specified.

User group visibility to virtual topics requires an external identity provider, such as Keycloak, capable of managing user groups. When Event Endpoint Management connects to your external identity provider, it suggests groups that are already in use, or that you belong to. You can then select one or more of these user groups to add to virtual topics.

Important: Not all groups that are defined in the external identity provider are displayed. Only a filtered list based on the user’s membership and virtual topic associations.

To manage which user groups can view and subscribe to the virtual topic in the catalog after you have published it, you can assign user groups when you create a virtual topic, edit a virtual topic, or through the User groups page.

The User groups page displays all the virtual topics that are visible to user groups. You can use the User groups page to add and edit user groups.

To access the User groups page:

  1. Log in to the Event Endpoint Management UI with your login credentials.
  2. In the navigation pane, click Manage > User groups.

Adding a user group

Complete the following steps to add a user group to view virtual topic:

  1. In the navigation pane, click Manage > User groups. The Virtual topic viewers tab is displayed.
  2. Click Add user group. The Authorize a user group to view virtual topics pane is displayed.

  3. Select a user group from the list displayed. If the group that you want is not displayed, click Enable user group to add a group from your organization.

    Note: Any user groups that you enable must exist within the organization that is provided by your OIDC provider.

  4. Enter a name for the user group that you want to add.
  5. Click Next. The Add virtual topics pane is displayed with a list of unpublished, and published and archived virtual topics if they have custom visibility.
  6. Select the virtual topics that you want the group to view.
  7. Click Save.

The new group is added to the table in the Virtual topic viewers tab with all the virtual topics that the group can view displayed.

Editing user group visibility

Complete the following steps to edit the virtual topics available to a user group:

  1. In the navigation pane, click Manage > User groups. The Virtual topic viewers tab is displayed.
  2. Click the Edit icon edit icon for the group that you want to edit. The Edit virtual topics pane is displayed.
  3. To add virtual topics, click Add virtual topics. The Add virtual topics pane is displayed with a list of unpublished, and published and archived virtual topics if they have custom visibility.
  4. Select the virtual topics that you want, then click Save.
  5. Click Save.

Note: The following rules apply when you edit the visibility for published and archived virtual topics:

  • You cannot change public virtual topics to be custom.
  • You can change custom virtual topics to be public.
  • You can add groups to custom virtual topics, but you cannot remove existing groups already added to a custom virtual topic.

If you need to perform an action that is not permitted (for example, removing groups from a published custom virtual topic), complete the following steps:

  1. Remove subscribers.
  2. Unpublish the virtual topic.
  3. Update the visibility settings as needed.
  4. Publish the virtual topic again.

Removing user group visibility to virtual topics

To remove a user group from a virtual topic, complete the following steps:

Note: You can only remove user groups from unpublished virtual topics.

  1. In the navigation pane, click Manage > Topics.
  2. Click the source topic that you want to work with.
  3. In the topic’s detail page, click the Virtual topics tab.
  4. Click More options icon More options on the topic that you want to edit, and select Edit. The Edit virtual topic window is displayed.
  5. In the side panel, click Visibility.
  6. In the Visibility pane, click the Delete icon trash icon for the group that you want to remove from the virtual topic.
  7. After you make changes, click Save.