Step 3: Creating Applications

Creating an application

In this step, you will create your producer and consumer application in the Self-Service portal.

  1. On the left-side menu, click Applications

  2. In the top-right corner of the screen, click the New Application button.

    Application overview

  3. Application ID: Use io.axual.examples

    Producers only supply this value as additional metadata. It’s not mandatory for functionality, but it’s recommended to be included. Consumers use this ID field to keep track of events that were already consumed.

  4. Name: Use Axual Client Examples as the application mame.

  5. Short name: Use axualclientexamples as the application short name.

  6. Owner: Select Admins from the drop-down.

  7. Application Type: Select Self Managed.

  8. Type: Select Java from the drop-down.

  9. Visibility: Select Public from the drop-down

  10. Description: Enter a Description which helps (future) colleagues understand how this application handles data: i.e. "Creates sample log-events".

  11. Click Add Application at the bottom-right of the screen

Producer credentials

The Application is created.

We will now configure authentication credentials for the example environment.

The producer application has been created

  1. From the drop-down on the left, select the example environment.

  2. The Application card in the center of the screen has a "lock" icon in its top right corner, and a blue circle indicating that authentication is not set-up for this environment.

  3. Click the lock icon.

    Configure application Credentials modal

  4. A new modal will be displayed. Click the + Generate New Pair button, under the SASL section.

  5. Store the autogenerated credentials in a file for a few minutes: we’ll use them shortly.

  6. You can now close the modal

Producer authorization

The application is created and has configured credentials for the default environment. What’s left is requesting produce permission for a topic.

At the bottom of the page, there are two tabs: Pending requests and History: the former is already selected.

  1. Click + Add request, at the bottom-right of the page. A modal will pop-up.

    Configure stream request for producer

  2. Application type: Select Producer

  3. Topic: Select applicationlogevents from the drop-down.

  4. Click the Request Approval button in the bottom right.

Since this is a private environment, used for testing purposes only, you do not require explicit approval from the topic owner (which anyway is also yourself). Shared environments will incur an extra step: the topic owner has to approve your request before you gain produce access. Read more about authorizing stream access here.

Consumer authorization

For simplicity, we’ll reuse the producer application as a consumer, as well. It’s already got a credential registered for the environment, all that’s left is to request consume permission.

  1. Click + Add request, at the bottom-right of the page. A modal will pop-up.

Configure stream request for consumer

  1. Application type: Select Consumer

  2. Topic: Select applicationlogevents from the drop-down.

  3. Click the Request Approval button in the bottom right.

The request is automatically approved, just like the producer.

Optional

If you performed the Optional section in the previous step, then you should also request producer and consumer authorization for the example-string-stream, which is deployed in the same example environment.

Next Step: Producing data

In the next step, you will actually start producing some data to the newly created topic.

Proceed to Step 4: Producing data