User Migration

If you are integrating NYC.ID with an existing application, it is NOT possible to import your existing user base into it.

To associate a NYC.ID user account with a user within your application:

  1. Integrate your application with NYC.ID, allowing new users to login to your application.
  2. After a user authenticates with NYC.ID, your application should search for the GUID received from the SAML Assertion, or OAuth Redirect URI.
  3. If the GUID is not found, search for the email address received from the SAML Assertion, or OAuth Redirect URI
    • If the email address is found, associate the GUID with the email address.
      ! IMPORTANT: Your application should make the association only when the user has a validated email address.
    • If the email address is not found, treat the user as a new user.