OAuth Authorization Code Grant / Client-ID and Client-Secret

Genesys Cloud Integrations
1

Hello, I am integrating with the Genesys AudioHook stack. From our web-socket server I need to call into the Conversation API. I am planning on using the Code Grant OAuth flow and given that, I require the client-id and client-secret to make the initial call to get a token.

How do I go about registering and / or obtaining the client-id and client-secret to use? Is there a ticket I need to file, or account rep that can help? Thanks.

2

Hello,

You will need to create an OAuth Client in your Genesys Cloud org (the org that you are getting an audiohook stream from).

Regarding the Grant Type, note that Token Implicit Grant or Code Authorization Grant require a user to enter his username and password on Genesys Cloud login page.
If you are planning to have a server app, with no "user context", you would typically use a Client Credentials Grant type.

Regards,

1 Like
3

Thank you very much Jerome - yes, I am connecting from a back-end server process. So, it looks like my first step is to register an OAuth client in the cloud org.

Regarding registering an OAuth Client in the Genesys Cloud org - is that done via a self-service dashboard or webpage? If so, is that off the Pure Cloud dashboard page?

4

Configuration is done via the Genesys Cloud Desktop (Admin menu), connecting to your Genesys Cloud org with your user credentials (https://login.mypurecloud.com if your Genesys Cloud org is in US-East region).
The same way you configure any objects in Genesys Cloud - Queues, Users, ....

So log in Genesys Desktop (or ask someone who has access to your Genesys Cloud org configuration to do it).
Then, as stated in the link I shared:

  1. Click Admin .
  2. Under Integrations , click OAuth .
  3. Click Add client . The Client Details tab appears.

Regards,

1 Like
5

Hi Jerome - one more question if I may:

When I go to set the OAuth key - I'm selecting Client Credentials. The form ask me for Roles. When I go to the Roles tab, nothing is getting populated.

Now, when I go the dashboard --> Permissions --> Roles: I do see Roles, but, the OAuth form wizard Roles tab does not show any roles.

Do you happen to know how I get Roles listed or what kind of Roles I need to create in order to set OAuth Client Credentials Client?

Thank you very much.

6

Logout/login from Genesys Desktop and try again.
Or maybe just try to create a new OAuth Client.
In case that's an issue with Genesys Desktop getting your own assigned roles.

The permissions necessary to create, edit or delete an OAuth client are:
oauth:client:add, oauth:client:edit, oauth:client:delete, oauth:clientview

Regards,

8