App Transfer and User Migration - Questions on Apple Sign-In Token Behavior and Testing Process

Hi Apple Developer Community,

We have carefully reviewed the documentation on App Transfer and User Migration, but we still have a few unresolved questions regarding Apple Sign-In token behavior and testing strategies. Would appreciate any guidance!

  1. Token Behavior for Pre-Transfer App Versions

After the app transfer: If a user logs in via an existing pre-transfer version of the app (published under Team A before transfer), will the Apple Sign-In token’s sub (or private email) switch to new value tie to Team B, or unchanged?

This is critical for our user migration plan.

  1. Preserving sub Across Transfers (Internal Team Transfer)

Since our app-transfer is an internal transfer (no change in app ownership outside our organization), is there a way to retain the original sub value(or private email) for users after the transfer?

We are concerned that Apple Sign-In errors during the app transfer process may negatively impact user experience.

  1. Testing the Transfer Process Safely

We’d like to simulate the app transfer and user migration process in a sandbox/test environment before executing it in production. Is there a way to test app transfers without affecting live users? (e.g., a staging mode for transfers)

Thank you for your expertise! Any insights would be invaluable.

Answered by DTS Engineer in 866916022

Hi @changFei,

You wrote:

After the app transfer: If a user logs in via an existing pre-transfer version of the app (published under Team A before transfer), will the Apple Sign-In token’s sub (or private email) switch to new value tie to Team B, or unchanged?

The user ID and private email address will remain unchanged—the value associated with Team A will continue to be provided. After the 60-day transfer period, Sign in with Apple will fail until they update the app (now associated only with Team B).

Then, you wrote:

Since our app-transfer is an internal transfer (no change in app ownership outside our organization), is there a way to retain the original sub value(or private email) for users after the transfer?

Please follow the steps outlined in the post below and reply here with your Feedback ID so we can discuss a potential solution for your organization:

Gathering required information for troubleshooting Sign in with Apple user migration

https://developer.apple.com/forums/thread/762829

Lastly, you wrote:

We’d like to simulate the app transfer and user migration process in a sandbox/test environment before executing it in production. Is there a way to test app transfers without affecting live users? (e.g., a staging mode for transfers)

There is no test environment for app transfers or user migrations. However, you can continue to transfer the app between both teams as needed. Each completed app transfer will initiate a new 60-day transfer period for both teams.

To learn more about the user migration process, please see the following technote:

TN3159: Migrating Sign in with Apple users for an app transfer

https://developer.apple.com/documentation/technotes/tn3159-migrating-sign-in-with-apple-users-for-an-app-transfer

Cheers,

Paris X Pinkney |  WWDR | DTS Engineer

Hi @changFei,

You wrote:

After the app transfer: If a user logs in via an existing pre-transfer version of the app (published under Team A before transfer), will the Apple Sign-In token’s sub (or private email) switch to new value tie to Team B, or unchanged?

The user ID and private email address will remain unchanged—the value associated with Team A will continue to be provided. After the 60-day transfer period, Sign in with Apple will fail until they update the app (now associated only with Team B).

Then, you wrote:

Since our app-transfer is an internal transfer (no change in app ownership outside our organization), is there a way to retain the original sub value(or private email) for users after the transfer?

Please follow the steps outlined in the post below and reply here with your Feedback ID so we can discuss a potential solution for your organization:

Gathering required information for troubleshooting Sign in with Apple user migration

https://developer.apple.com/forums/thread/762829

Lastly, you wrote:

We’d like to simulate the app transfer and user migration process in a sandbox/test environment before executing it in production. Is there a way to test app transfers without affecting live users? (e.g., a staging mode for transfers)

There is no test environment for app transfers or user migrations. However, you can continue to transfer the app between both teams as needed. Each completed app transfer will initiate a new 60-day transfer period for both teams.

To learn more about the user migration process, please see the following technote:

TN3159: Migrating Sign in with Apple users for an app transfer

https://developer.apple.com/documentation/technotes/tn3159-migrating-sign-in-with-apple-users-for-an-app-transfer

Cheers,

Paris X Pinkney |  WWDR | DTS Engineer

App Transfer and User Migration - Questions on Apple Sign-In Token Behavior and Testing Process
 
 
Q