Skip to main content

Secure Connection to Willba API

This guide provides a walkthrough on the secure procedure for integrating third-party applications with the Willba API. By utilizing Keycloak authentication, third-party apps can securely use the API offered by Willba.

🔒 Important: This documentation is for Willba administrators

1. Setting Up a New Client​

Start by creating a new client through the Keycloak authentication administrative UI. Naming convention for the client is external-{third-party-name}.

Access the Admin UI

2. Gather Credentials​

After the client's creation in Keycloak, it's time to collect vital credentials:

  • client_id
  • client_secret
  • realm token URL: https://auth.willba.app/realms/{realm-name}/protocol/openid-connect/token.
tip

Remember, {realm-name} refers to the environment tenant name.

3. Send Credentials​

Send the collected credentials securely to the customer and give the link for customer API access documentation.