diff --git a/src/pages/guides/credentials.md b/src/pages/guides/credentials.md index 0f70a484..dc5c276a 100644 --- a/src/pages/guides/credentials.md +++ b/src/pages/guides/credentials.md @@ -10,35 +10,39 @@ To view credentials for events, select the specific event registration from the ## Credential details -You can select a specific API from the left navigation to view its details or you can select a credential type under *Credentials* in the left navigation in order to view the *Credential details* and perform other actions (generate JWT tokens, copy credential details, retrieve client secrets, etc.) as needed. +You can select a specific API from the left navigation to view its details or you can select a credential type under *Credentials* in the left navigation in order to view the *Credential details* and perform other actions (generate access tokens, copy credential details, retrieve client secrets, etc.) as needed. If multiple services have been added to the project or workspace using the same credentials, they will each be listed under the *Connected products and services* on the right-hand side of the details tab. -For example, selecting **Service Account (JWT)** under *Credentials* will open the *Credential details* for all products and services connected using JWT. +For example, selecting **OAuth Server-to-Server** under *Credentials* will open the *Credential details* for all products and services connected using this credential. ![](../images/credentials-details.png) -## Generate JWT +## Generate Access token -If you selected **Service Account (JWT)** under *Credentials* you will be presented with the *Credential details* for all products and services connected using JWT. +If you selected **OAuth Server-to-Server** under *Credentials* you will be presented with the *Credential details* for all products and services connected using this credential. -You can also select **Generate JWT** in order to view a sample *JWT Payload* or *Generate custom JWT* by copying and pasting your private key into the available field and choosing **Generate Token**. +To generate a token, click on the button "Generate access token" -![](../images/credentials-generate-jwt.png) +![](../../images/services-api-oauth-s2s-generate-token-2.png) -If successful, the *Generated JWT* will be visible as well as a *Sample cURL command*. You can select *Clear generated JWT* in order to clear the screen and generate a new token. +You can also view the cURL command you could use to generate access tokens programmatically. -![](../images/credentials-generated-jwt.png) +![](../../images/services-api-oauth-s2s-view-curl-command.png) -## OAuth +You can also view the scopes per service to generate an access token that only works for a subset of services in your project. -By selecting **OAuth** under *Credentials*, you will be shown all products and services connected to your project using OAuth 2.0 authenication and authorization. +![](../../images/services-api-oauth-s2s-view-scopes.png) + +## OAuth User authentication + +By selecting an OAuth User authentication credential under *Credentials*, you will be shown all products and services connected to your project using OAuth 2.0 authenication and authorization. From here, you can view and copy the *Client ID*, retrieve the client secret, and view the *Platform* type as well as the *Redirect URL*. Within the *Credential details* screen you can also choose to download the OAuth JSON file, edit the credential, or delete the credential using the buttons provided in the top-right corner of the screen. -![](../images/credentials-oauth-web.png) +![](../../images/services-api-oauth-user-auth-credential-overview.png) ## API key diff --git a/src/pages/guides/services/services-add-event.md b/src/pages/guides/services/services-add-event.md index 1db994b0..dbde8d6d 100644 --- a/src/pages/guides/services/services-add-event.md +++ b/src/pages/guides/services/services-add-event.md @@ -26,13 +26,13 @@ The first step in configuration is to choose your event subscriptions. This requ ## Credentials -The next step in configuring your event registration is to configure the authentication credentials. This could be a service account (JWT) or OAuth, depending on the type of event being configured. The example in this document uses OAuth 2.0 authentication and authorization. +The next step in configuring your event registration is to configure the authentication credentials. This could be a OAuth Server-to-Server credential or OAuth User authentication credential, depending on the type of event being configured. The example in this document uses OAuth 2.0 user authentication credential. To learn more about authentication and available types, visit the [authentication documentation](../authentication/index.md). -To configure an Event using OAuth 2.0 authentication and authorization, you must first select the platform where you want to use this integration: Web App, Single Page App, or Native App. Please note, depending on the selected event provider not all platform choices may be available. +To configure an Event using OAuth 2.0 user authentication credential, you must first select the platform where you want to use this integration: Web App, Single Page App, or Native App. Please note, depending on the selected event provider not all platform choices may be available. Once you have selected a platform, you will be required to provide a *Redirect URI*, which is a fallback URI to be used if the authorization request contains a redirect URI which doesn't match the Redirect URI list or doesn't contain a `redirect_uri` parameter. @@ -66,7 +66,7 @@ You can also remove an event registration from the event overview by selecting * ## Credentials -The *Credentials* tab shows details related to the event authentication method, allowing you to perform actions such as copying a Client ID, retrieving the client secret, generating a JWT token, etc depending on the type of authentication used. +The *Credentials* tab shows details related to the event authentication method, allowing you to perform actions such as copying a Client ID, retrieving the client secret, generating an access token, etc depending on the type of authentication used. ![](../../images/events-credentials.png) diff --git a/src/pages/images/credentials-details.png b/src/pages/images/credentials-details.png index 2ba536d5..38210184 100644 Binary files a/src/pages/images/credentials-details.png and b/src/pages/images/credentials-details.png differ diff --git a/src/pages/images/credentials-project-overview.png b/src/pages/images/credentials-project-overview.png index e6d46ff3..11681386 100644 Binary files a/src/pages/images/credentials-project-overview.png and b/src/pages/images/credentials-project-overview.png differ diff --git a/src/pages/images/quota-usage.png b/src/pages/images/quota-usage.png index d9203207..489fcb45 100644 Binary files a/src/pages/images/quota-usage.png and b/src/pages/images/quota-usage.png differ diff --git a/src/pages/images/services-api-oauth-s2s-view-scopes.png b/src/pages/images/services-api-oauth-s2s-view-scopes.png index 7211931e..7f8fe465 100644 Binary files a/src/pages/images/services-api-oauth-s2s-view-scopes.png and b/src/pages/images/services-api-oauth-s2s-view-scopes.png differ