Skip to content

Commit e618526

Browse files
committed
Merge branch 'main' of https://github.com/AdobeDocs/adobe-dev-console into eds-migration
2 parents e5aa0cb + 5acdcca commit e618526

File tree

14 files changed

+58
-44
lines changed

14 files changed

+58
-44
lines changed

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
"url": "https://github.com/icaraps"
1313
},
1414
"dependencies": {
15-
"@adobe/gatsby-theme-aio": "^4.14.4",
15+
"@adobe/gatsby-theme-aio": "^4.14.18",
1616
"gatsby": "4.22.0",
1717
"react": "^17.0.2",
1818
"react-dom": "^17.0.2"

src/pages/guides/authentication/JWT/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
<InlineAlert slots="text"/>
44

5-
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jan 27, 2025. You must migrate to the new credential by **Jan 27, 2025**, to ensure your application continues functioning. [Learn more](./ServerToServerAuthentication/migration.md).
5+
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jun 30, 2025. You must migrate to the new credential by **Jun 30, 2025**, to ensure your application continues functioning. [Learn more](./ServerToServerAuthentication/migration.md).
66

77
To establish a secure service-to-service Adobe I/O API session, you must create a JSON Web Token (JWT) that encapsulates the identity of your integration, and then exchange it for an access token. Every request to an Adobe service must include the access token in the `Authorization` header, along with the API Key (Client ID) that was generated when you created the [Service Account Integration](../service-account-integration.md) in the [Adobe Developer Console](https://developer.adobe.com/console/).
88

src/pages/guides/authentication/JWT/jwt-certificate.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44
<InlineAlert slots="text"/>
55

6-
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jan 27, 2025. You must migrate to the new credential by **Jan 27, 2025**, to ensure your application continues functioning. [Learn more](../ServerToServerAuthentication/migration.md).
6+
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jun 30, 2025. You must migrate to the new credential by **Jun 30, 2025**, to ensure your application continues functioning. [Learn more](./ServerToServerAuthentication/migration.md).
77

88
Create a private key and a public certificate. Make sure you store these securely.
99

src/pages/guides/authentication/JWT/samples.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44
<InlineAlert slots="text"/>
55

6-
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jan 27, 2025. You must migrate to the new credential by **Jan 27, 2025**, to ensure your application continues functioning. [Learn more](../ServerToServerAuthentication/migration.md).
6+
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jun 30, 2025. You must migrate to the new credential by **Jun 30, 2025**, to ensure your application continues functioning. [Learn more](./ServerToServerAuthentication/migration.md).
77

88
The following samples demonstrate JWT generation and exchanging it with Adobe IMS endpoint to retrieve an access token.
99

src/pages/guides/authentication/JWT/scopes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44
<InlineAlert slots="text"/>
55

6-
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jan 27, 2025. You must migrate to the new credential by **Jan 27, 2025**, to ensure your application continues functioning. [Learn more](../ServerToServerAuthentication/migration.md).
6+
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jun 30, 2025. You must migrate to the new credential by **Jun 30, 2025**, to ensure your application continues functioning. [Learn more](./ServerToServerAuthentication/migration.md).
77

88
JSON Web Token (JWT) metascopes govern the access and privileges for service accounts. As an application developer, you will choose the set of scopes to access certain resources by specifying the scopes as part of the encoding claims for your JWTs.
99

src/pages/guides/authentication/ServerToServerAuthentication/faqs.md

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@
77
+ [Benefits of the new credential](#benefits-of-the-new-credential)
88
+ [Migration next steps](#migration-next-steps)
99
+ [Migrating vendor applications](#migrating-vendor-applications)
10+
+ [Migrating Auto-generated projects](#migrating-auto-generated-projects)
1011
+ [Adobe assistance](#adobe-assistance)
1112

1213

@@ -16,7 +17,7 @@
1617

1718

1819
### What's happening?
19-
In May 2023, Adobe announced the deprecation and end of life of Service Account (JWT) credentials. This means that any of your integrations or custom applications using a Service Account (JWT) credential will need to migrate to the new OAuth Server-to-Server credential before January 27, 2025.
20+
In May 2023, Adobe announced the deprecation and end of life of Service Account (JWT) credentials. This means that any of your integrations or custom applications using a Service Account (JWT) credential will need to migrate to the new OAuth Server-to-Server credential before Jun 30, 2025.
2021

2122

2223

@@ -31,23 +32,23 @@ A credential is used to uniquely identify your integration to Adobe. To use an A
3132

3233
### Will my Adobe integrations or applications stop working immediately?
3334

34-
No. Any integration or application using the Service Account (JWT) credential will continue to work until January 27, 2025. See [deprecation timelines](./migration.md#deperecation-timelines). See section on [migration next steps](#migration-next-steps).
35+
No. Any integration or application using the Service Account (JWT) credential will continue to work until June 30, 2025. See [deprecation timelines](./migration.md#deperecation-timelines). See section on [migration next steps](#migration-next-steps).
3536

3637

3738

3839
### What is the deadline to migrate to the new credential?
39-
You must migrate your application to use the new OAuth Server-to-Server credential before January 27, 2025, to ensure your application does not face any downtime. See [migration guide](./migration.md).
40+
You must migrate your application to use the new OAuth Server-to-Server credential before June 30, 2025, to ensure your application does not face any downtime. See [deprecation timelines](./migration.md#deperecation-timelines). See [migration guide](./migration.md).
4041

4142

4243

43-
### What happens if we do not migrate our application by Jan 27, 2025?
44-
45-
Projects on the Developer Console still containing any Service Account (JWT) credentials will be 'frozen' after January 27, 2025. This will disable certificate rotation for your application or any other action to modify the Project or the credential. The ability to migrate will, however, still be available. Once you migrate your application, the Project will be 'unfrozen' again.
44+
### What happens if we do not migrate our integration by Jun 30, 2025?
4645

46+
After June 30, 2025, you can no longer refresh certificates for integrations using Service Account (JWT) credentials. Your integration will stop working once existing certificates expire.
4747

48+
Furthermore, Adobe will automatically convert Service Account (JWT) to OAuth Server-to-Server credentials when certificates expire or on March 1, 2026, whichever comes first.
4849

4950
### We can currently create new Service Account (JWT) credentials even though they are marked as deprecated. Is it recommended?
50-
No. Creating any new Service Account (JWT) credentials is not recommended. All Service Account (JWT) credentials, whether old or new, will stop working after January 27, 2025. We recommend you avoid migrating your application again and use the new OAuth Server-to-Server credential from the beginning. See our [implementation guide](./implementation.md).
51+
No. Creating any new Service Account (JWT) credentials is not recommended. All Service Account (JWT) credentials, whether old or new, will stop working after June 30, 2025. We recommend you avoid migrating your application again and use the new OAuth Server-to-Server credential from the beginning. See our [implementation guide](./implementation.md).
5152

5253

5354

@@ -152,11 +153,19 @@ The company or organization that developed the integration must add support to u
152153

153154

154155
### We are a company or organization that develops applications using Service Account (JWT) credentials that Adobe customers install. What do we need to do?
155-
Until June 3, 2024, customers can still create Service Account (JWT) credentials to use your application. However, any existing or new customers of your application must switch to using the new OAuth Server-to-Server credentials before January 27, 2025.
156+
Until June 3, 2024, customers can still create Service Account (JWT) credentials to use your application. However, any existing or new customers of your application must switch to using the new OAuth Server-to-Server credentials before June 30, 2025.
156157

157158
Therefore, we recommend enhancing your application before June3, 2024. You must add support to use the new credential and support for customers to migrate from the old credential to the new credential.
158159

159160

161+
## Migrating Auto-generated projects
162+
163+
### Do we need to migrate auto-generated projects?
164+
No. Adobe will migrate all auto-generated projects without needing your action. However, you may be required to upgrade the version of your Adobe Experience Manager (AEM) or Adobe Campaign as a pre-requisite.
165+
166+
### When will Adobe migrate auto-generated projects?
167+
Adobe will migrate all auto-generated projects before Jun 30, 2025.
168+
160169

161170
## Adobe assistance
162171

src/pages/guides/authentication/ServerToServerAuthentication/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Read our OAuth Server-to-server credential implementation guide -
5151

5252
<InlineAlert slots="text"/>
5353

54-
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jan 27, 2025. You must migrate to the new credential by **Jan 27, 2025**, to ensure your application continues functioning. [Learn more](./ServerToServerAuthentication/migration.md).
54+
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jun 30, 2025. You must migrate to the new credential by **Jun 30, 2025**, to ensure your application continues functioning. [Learn more](./ServerToServerAuthentication/migration.md).
5555

5656
Service Account (JWT) credentials rely on the JWT token exchange mechanism to generate access tokens. This credential's details include two secrets a `client_secret` and a `private.key` (part of a public certificate private key pair).
5757

src/pages/guides/authentication/ServerToServerAuthentication/migration.md

Lines changed: 26 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,27 @@
11
# Migrating from Service Account (JWT) credential to OAuth Server-to-Server credential
22

3-
The Service Account (JWT) credentials have been deprecated in favor of the new OAuth Server-to-Server credentials.
3+
The Service Account (JWT) credentials have been deprecated in favor of the new OAuth Server-to-Server credentials. They will reach end of life on June 30, 2025.
44

55
The new OAuth Server-to-Server credentials simplify all aspects of application development - experimentation, implementation, and maintenance. See the section on [Why OAuth Server-to-Server credentials?](#why-oauth-server-to-server-credentials) below to learn more.
66

7-
While the Service Account (JWT) credentials have been marked as deprecated, they will continue to work until **Jan 27, 2025**. Therefore you must migrate your application or integration to use the new OAuth Server-to-Server credential before Jan 27, 2025. See the section on [deprecation timelines](#deperecation-timelines) below to learn more.
7+
While the Service Account (JWT) credentials have been marked as deprecated, they will continue to work until **Jun 30, 2025**. Therefore you must migrate your application or integration to use the new OAuth Server-to-Server credential before Jun 30, 2025. See the section on [deprecation timelines](#deprecation-timelines) below to learn more.
88

99
Migrating your applications to the OAuth Server-to-Server credential is a simple two-step process that enables a zero downtime migration for your applications and integrations. Please read our [migration guide](#migration-overview) below to familiarize yourself with the migration process.
1010

1111
If you have more questions, check out our [frequently asked questions](#faqs) or visit the Adobe Developer Console [forums](https://experienceleaguecommunities.adobe.com/t5/adobe-developer-console/ct-p/adobe-io-console).
1212

1313
## Table of Contents
1414

15-
- [Migrating from Service Account (JWT) credential to OAuth Server-to-Server credential](#migrating-from-service-account-jwt-credential-to-oauth-server-to-server-credential)
16-
- [Table of Contents](#table-of-contents)
17-
- [Why OAuth Server-to-Server credentials?](#why-oauth-server-to-server-credentials)
18-
- [Deprecation Timelines](#deprecation-timelines)
19-
- [Migration Overview](#migration-overview)
20-
- [Preparation: Find out which applications are using the Service Account (JWT) credentials](#preparation-find-out-which-applications-are-using-the-service-account-jwt-credentials)
21-
- [Step 1: Add the new credential to your project](#step-1-add-the-new-credential-to-your-project)
22-
- [Step 2: Update your application and delete old credential](#step-2-update-your-application-and-delete-old-credential)
23-
- [Update your application](#update-your-application)
24-
- [Test if the new credential is working](#test-if-the-new-credential-is-working)
25-
- [Delete the old credential](#delete-the-old-credential)
26-
- [Cancelling Migration](#cancelling-migration)
15+
+ [Why OAuth Server-to-Server credentials?](#why-oauth-server-to-server-credentials)
16+
+ [Deperecation Timelines](#deprecation-timelines)
17+
+ [Migration Overview](#migration-overview)
18+
+ [Preparation: Find out which applications are using the Service Account (JWT) credentials](#preparation-find-out-which-applications-are-using-the-service-account-jwt-credentials)
19+
+ [Step 1: Add the new credential to your project](#step-1-add-the-new-credential-to-your-project)
20+
+ [Step 2: Update your application and delete old credential](#step-2-update-your-application-and-delete-old-credential)
21+
+ [Update your application](#update-your-application)
22+
+ [Test if the new credential is working](#test-if-the-new-credential-is-working)
23+
+ [Delete the old credential](#delete-the-old-credential)
24+
+ [Cancelling Migration](#cancelling-migration)
2725

2826

2927
## Why OAuth Server-to-Server credentials?
@@ -44,16 +42,23 @@ Lastly, while the new OAuth Server-to-Server credentials do not use expiring cer
4442

4543
## Deprecation Timelines
4644

47-
4845
<InlineAlert slots="text"/>
4946

50-
Your applications using the Service Account (JWT) credentials will stop working after Jan 27, 2025.
47+
The end of life date for Service Account (JWT) credentials has been extended from Jan 27, 2025, to Jun 30, 2025, to give customers more time to migrate. You must migrate your integrations to use OAuth Server-to-Server credentials before June 30, 2025 to avoid any downtime.
48+
49+
50+
1. **May 1, 2023**
51+
* Adobe announces the deprecation of Service Account (JWT) credentials. The deprecation timelines and the end-of-life date are also announced.
52+
* All existing integrations using Service Account (JWT) credentials continue to work.
53+
54+
2. **June 3, 2024**
55+
* After June 3, 2024, you cannot create new Service Account (JWT) credentials.
56+
* All existing integrations using Service Account (JWT) credentials continue to work.
5157

58+
3. **June 30, 2025 (End of Life)**
59+
* After June 30, 2025, you cannot refresh certificates for integrations using Service Account (JWT) credentials. Your integrations will stop working once existing certificates expire.
60+
* Furthermore, Adobe will automatically convert Service Account (JWT) credentials to OAuth Server-to-Server credentials when certificates expire or on March 1, 2026, whichever comes first.
5261

53-
| | May 1, 2023 - Jun 2, 2024 | Jun 3, 2024 - Jan 26, 2024 | Jan 27, 2025 (end of life) |
54-
|-|------------------------------|---------------------------------|-------------------------------|
55-
| Existing applications using a Service Account (JWT) credential | Existing applications using the Service Account (JWT) credential will continue to work. | Existing applications using the Service Account (JWT) credential will continue to work. | **Existing applications cannot refresh expiring certificates after Jan 27, 2025, and will stop working**. |
56-
| New applications creating a Service Account (JWT) credential | A new Service Account (JWT) credential can be added to the project. | A new Service Account (JWT) credential **cannot** be created or added to the project. | A new Service Account (JWT) credential **cannot** be created or added to the project. |
5762

5863
## Migration Overview
5964

@@ -71,7 +76,7 @@ To find out which of your Adobe applications and integrations are using the Serv
7176

7277
Perform the steps below for each application/project you have identified. If a project is not in use, we recommend deleting the project or the Service Account (JWT) credential in the project.
7378

74-
Note: you do not have to worry about auto-generated projects. Adobe will automatically migrate those during the migration window.
79+
Note: you do not have to worry about auto-generated projects. Adobe will automatically migrate all auto-generated projects before June 30, 2025.
7580

7681
### Step 1: Add the new credential to your project
7782

src/pages/guides/authentication/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ View our guide on server to server authentication credentials -
4848

4949
<InlineAlert slots="text"/>
5050

51-
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jan 27, 2025. You must migrate to the new credential by **Jan 27, 2025**, to ensure your application continues functioning. [Learn more](./ServerToServerAuthentication/migration.md).
51+
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jun 30, 2025. You must migrate to the new credential by **Jun 30, 2025**, to ensure your application continues functioning. [Learn more](./ServerToServerAuthentication/migration.md).
5252

5353

5454
## API key authentication

src/pages/guides/authentication/service-account-integration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
<InlineAlert slots="text"/>
44

5-
Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jan 27, 2025. **You must migrate to the new credential by Jan 27, 2025 in order to ensure your application continues to function. View our [migration guide](../authentication/ServerToServerAuthentication/migration.md) to know more.**
5+
Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jun 30, 2025. **You must migrate to the new credential by Jun 30, 2025 in order to ensure your application continues to function. View our [migration guide](../ServerToServerAuthentication/migration.md) to know more.**
66

77
A Service Account connection allows your application to call Adobe services on behalf of the application itself or on behalf of an enterprise organization.
88

0 commit comments

Comments
 (0)