Subscribing to topics

After discovering a topic that is suitable for use with your application, you can subscribe to it in a self-service manner in the Catalog by generating access credentials.

Requesting access to an event source

You can request access to an event source (topic) follows:

  1. Log in to the Event Endpoint Management UI by using your login credentials.
  2. In the navigation pane, click Catalog.
  3. Select an event source from the list by clicking the topic name.
  4. Click Generate access credentials in the Topic information view.

  5. Follow the instructions to request access: provide your contact details, and click Generate.

    The modal will present your subscription credentials. This credential is a SASL username and password, which uniquely identifies you and your usage of this event source (topic). These credentials must be used when accessing the event source through the Event Gateway.

    Note: The contact information is a free text field, and the details provided can be used by the owners of the event source (topic) to contact you as required, for example, in case of maintenance or topic deprecation. Providing an email address is recommended.

  6. Event Endpoint Management 11.1.5 icon Copy your username and password values, or click Download credentials to download your generated credentials as a JSON file for future use and reference.

    In versions earlier than 11.1.5, click Download as JSON to download your generated credentials as a JSON file.

    Your application will require these credentials to access the event source through the Event Gateway.

    Important: The credentials generated for you are shown one time. They cannot be retrieved later. Ensure you save the access credentials and store them in a secure location.

Note: The Generate access credentials button is only available for topics that are still accepting new subscriptions. The owner of the event source (topic) controls if subscriptions are offered in the Catalog.

Requesting access to an option

Event Endpoint Management 11.1.1 icon If an option has been configured with approval controls, you need to create a request for permission to subscribe to that option.

To create a request to subscribe to an option that has approval control enabled, complete the following steps.

  1. In the catalog, select the topic that you want to work with.
  2. Select the option that you want to subscribe to.
  3. Click Request Access. The Request access window is displayed.
  4. In the Contact field, provide a contact name.
  5. In the Justification field, provide a description to explain why you want this subscription.
  6. Click Request.

Your request will be reviewed by the owner of the option.

Note: You can only have one request for a subscription open at a time against an option. If Request access is greyed out, a request for that option is pending a review by the option owner.

Access approvals and rejections

Approved requests

If your request is approved, the Request access button changes to Generate credentials and you can then proceed to generate credentials by following the usual process.

Rejected requests

If your request is rejected, then Request access is reset and you can submit a new request.

Next steps

After creating a subscription, you can access the event endpoint you subscribed to through the Event Gateway. The Catalog contains sample code and connection information to help you configure your application to consume from or produce to the event source.

Note: Event Endpoint Management 11.1.5 icon The ability to produce events is only available in Event Endpoint Management version 11.1.5 and later.

You can also view the event endpoints you have access to, and remove any subscriptions you no longer require.