warning the page is not not public yet

Introduction

WMDA IT team creates applications for your organisation and provides the client IDs needed to connect to WMDA APIs. Each application has a client_id (permanent) and requires client secrets to authenticate.


To authenticate with WMDA APIs, a bearer token must be requested from the WMDA Azure Active Directory (Azure AD). For details on how client_id and client_secret are used to retrieve bearer tokens, see API authentication.


Client_id

Client_secret


Client_id stays the same permanently. It does not expire and does not need to be replaced.

Client_secrets expire after a set period.

When the client_secret expires, API connections will stop working until a new secret is created and updated in your systems.

To avoid interruptions, always rotate the secret before it expires.


Applications in the Self Service Client Secret Management Portal:

The Self Service Client Secret Management Portal lists the applications created by the WMDA IT team for your organisation. Each application represents access to one or more APIs.

Examples of applications you may see in the Self Service Client Secret Management Portal:


Applications naming convention follows this pattern:

Partner-(Country Code)-(Organisation Name)-(API)

Where:


PartnerAlternative is a "dummy" organisation for implementers to test their Match-Connect API integration internally. It works only in the Match-Connect sandbox and is provided upon request.


Each application has its own client_id and client secrets. Visibility depends on your user role and the permissions granted to your organisation.


Access to the Portal

You can manage client secrets using the Self Service Client Secret Management Portal, where you can view, create, and delete client secrets.

To access the portal:

  1. You must have the appropriate role (credential manager) provided by the WMDA team.
  2. Login to the portal using MFA (MFA user guide).
  3. Visit the page https://portal.wmda.info/manage-clients.

Your organisation should designate one or more technical contacts (credential manager) who are responsible for managing client secrets.

Only designated users can be granted access.

Before contacting WMDA support, confirm internally who is responsible within your team.

If access is required, contact WMDA: support@wmda.info


Managing your client secrets

As credential manager you can use the Self Service Client Secret Management Portal to:

To create a new secret:

1. Click on the "Create new secret" button and the pop-up will appear:

2. Provide client secret name and expiration date (1 year maximum) for this secret:


3. Click on "Create".

4. Client secret will appear:


When you create a new secret, copy and store it securely. After you refresh or return to this page, the full secret will no longer be visible - only the first three characters (hint) will remain. If you don't copy the newly created secret, you lose it, and you'll need to generate a new secret.


Once a new client secret is used, the old one should be removed to prevent unnecessary expiration reminders and confusion.

To delete a secret:

1. Click on the delete icon next to the secret you would like to delete and confirm your action:


Email Notifications About Expiring Client Secrets

The designated contact(s) for your organisation will automatically receive email notifications from WMDA when a client secret is approaching expiration.

Notifications are sent at the following intervals:

These reminders are sent only to users who have been granted access to the Self Service Client Secret Management Portal.