You need to authenticate as a user with full administrative permissions to the edoc invoice cockpit REST API in order to configure edoc invoice cockpit.
Before you begin
-
You need access to Keycloak on the edoc platform server.
-
You must have administration permissions on the edoc platform server.
-
You need an API application, e.g. Bruno or Postman.
Here's how
-
Navigate to <Base-URL>/auth and log in as administrator. Replace <base-URL> with the edoc platform base URL (including https:// or http://).
-
Create an OpenID Connect application. Follow the steps in this Keycloak article: Creating an OpenID Connect client (Server Administration Guide).
-
Next, go to Clients and select the application you created earlier.
-
Copy the value to Client ID under Settings.
-
Copy the value to Client Secret under Credentials.
-
Open your API application and select OAuth 2.0 as the authentication method for REST calls.
-
Select the appropriate grant type for the application credentials (client credentials).
-
Enter the value <Base-URL>/auth/realms/master/protocol/openid-connect/token in the input field for the token URL. Replace <Base-URL> with the base URL of edoc platform (including https://or http://).
-
In the input field for the application ID, insert the value that you previously copied from Client ID in Keycloak.
-
In the input field for the client secret, enter the value that you previously copied from Client Secret in Keycloak.
Tip
Finally, check whether you can request an access token with this data. Be sure to check your entries if the query fails.