diff --git a/src/pages/guides/getting-started/getting-started-with-postman.md b/src/pages/guides/getting-started/getting-started-with-postman.md index fd2d26cf..ac5301b4 100644 --- a/src/pages/guides/getting-started/getting-started-with-postman.md +++ b/src/pages/guides/getting-started/getting-started-with-postman.md @@ -25,7 +25,6 @@ This collection defines a number of variables which are used in the contained re * `host_name` - The Cloud Manager API host name, `cloudmanager.adobe.io`. * `ims_endpoint` - The host name for the Adobe Identity Management System (IMS), `ims-na1.adobelogin.com`. -* `cloudmanager_claim` - The access claim used in the JWT token, `https://ims-na1.adobelogin.com/s/ent_cloudmgr_sdk`. ## Configuration @@ -35,16 +34,18 @@ The requests in this collection depend upon a set of Postman environment variabl Then click on the eye icon to view the environment variables and click the Edit link to edit the variables. -![Postman Environment Details](img/postman-editenvironment.png) +![Postman Environment Details](img/postman-environment-edit-click.png) -Four of these values need to be populated using the values displayed in the Adobe Developer Console. +![Postman Environment Edit Details](img/postman-after-environment-edit-click.png) + +Six of these values need to be populated using the values displayed in the Adobe Developer Console. * `api_key` * `organization_id` * `technical_account_id` +* `client_id` * `client_secret` - -The `private_key` variable needs to be populated with the contents of the `private.key` file generated by Open SSL as described in the [Adobe I/O JWT Documentation](https://developer.adobe.com/developer-console/docs/guides/authentication/JWT/JWTCertificate/). +* `scopes` ## Obtaining the Access Token @@ -54,8 +55,12 @@ Once the environment variables are populated, open the Obtain Access Token reque This will automatically set the `access_token` environment variable with a token which is valid for 24 hours. If you need to refresh it, just re-send this request. + + +Note that generation of JWT access token is deprecated in favor of the OAuth Server-to-Server credentials. Creating new JWT credentials will stop by May 1, 2024. [Learn more](../../../developer-console/docs/guides/authentication/JWT/index.md). + ## Executing Other Requests In addition to the Obtain Access Token request, the collection includes other requests which can be executed. -If you create your own requests in Postman, keep in mind that they must always include the `Authorization`, `x-gw-ims-org-id`, and `x-api-key` headers. The `Authorization` header will be automatically inherited for requests defined in the `Cloud Manager Public API` collection, but if you create your own requests outside of this collection, you will need to configure this header, using the `access_token` envrionment variable. \ No newline at end of file +If you create your own requests in Postman, keep in mind that they must always include the `Authorization`, `x-gw-ims-org-id`, and `x-api-key` headers. The `Authorization` header will be automatically inherited for requests defined in the `Cloud Manager Public API` collection, but if you create your own requests outside of this collection, you will need to configure this header, using the `access_token` environment variable. diff --git a/src/pages/guides/getting-started/img/postman-after-environment-edit-click.png b/src/pages/guides/getting-started/img/postman-after-environment-edit-click.png new file mode 100644 index 00000000..46514b94 Binary files /dev/null and b/src/pages/guides/getting-started/img/postman-after-environment-edit-click.png differ diff --git a/src/pages/guides/getting-started/img/postman-editenvironment.png b/src/pages/guides/getting-started/img/postman-editenvironment.png deleted file mode 100644 index f045dc63..00000000 Binary files a/src/pages/guides/getting-started/img/postman-editenvironment.png and /dev/null differ diff --git a/src/pages/guides/getting-started/img/postman-environment-edit-click.png b/src/pages/guides/getting-started/img/postman-environment-edit-click.png new file mode 100644 index 00000000..8fcd08e8 Binary files /dev/null and b/src/pages/guides/getting-started/img/postman-environment-edit-click.png differ diff --git a/src/pages/guides/getting-started/img/postman-obtainaccesstoken-deprecated.png b/src/pages/guides/getting-started/img/postman-obtainaccesstoken-deprecated.png new file mode 100644 index 00000000..86272823 Binary files /dev/null and b/src/pages/guides/getting-started/img/postman-obtainaccesstoken-deprecated.png differ diff --git a/src/pages/guides/getting-started/img/postman-obtainaccesstoken.png b/src/pages/guides/getting-started/img/postman-obtainaccesstoken.png index 86272823..db3fd182 100644 Binary files a/src/pages/guides/getting-started/img/postman-obtainaccesstoken.png and b/src/pages/guides/getting-started/img/postman-obtainaccesstoken.png differ