Associate Social Account to User Process

​

Adding the Provider ID in the initial Request

**POST https://\{your.url\}/process/start/socialFederation.AssociateSocialMedia.v1.0**
<no body>

**RESPONSE - body**
{
   "processId": "8f41d5cc-a4ab-45e9-9e3b-7f58a2ed183f",
   "processName": "socialFederation.AssociateSocialMedia.v1.0",
   "displayMessage": "Please input required information",
   "parameters": {
      "providerId": "String"
   },
   "stepName": "ProviderPrompt",
   "lastStep": false,
   "output": {
      "providers": [
         "linkedin",
         "google",
         "facebook",
         "apple"
      ]
   }
}

**PUT https://\{your.url\}/process/step**
{
    "processId": "8f41d5cc-a4ab-45e9-9e3b-7f58a2ed183f",
    "parameters": {
        "providerId": "facebook"
}

**POST https://\{your.url\}/process/start/socialFederation.SocialMediaAssistedOnboarding.v1.0?providerId=facebook**
<no body>

**POST https://\{your.url\}/process/start/socialFederation.SocialMediaAssistedOnboarding.v1.0**
{
   "parameters": {
      "providerId": "facebook"
}

​

Process Flow

• The Digital Identity Management User is fully activated with at least one verified email or mobile.
• The user is currently authenticated and in the client’s version of the user profile or user settings menu.
• The user has at least one social media account with a supported provider.
• The social provider integration has been enabled and configured in the MarketONE Admin console.

1. The user selects to add a specific social media account to their sign-in options.
2. The client redirects to the social provider, and the user authenticates into that provider.
3. The social provider navigates the browser back to Digital Identity Management.
   • On the backend, the provider sends along an authorization grant code to Digital Identity Management.
   • Digital Identity Management makes a separate call to the provider backend and exchanges the code for an access token.
   • Digital Identity Management makes another call to the provider backend to redeem the token for user data.
   • The user data includes the user’s name, email/mobile, and an internal social media ID from the provider.
4. Digital Identity Management searches for any existing User entity currently associated to this particular social media ID.
5. If no User entity is found, the Process prompts the user to confirm that they want to connect their User ID to the selected social media account.
6. The user confirms and Digital Identity Management associates the social media with the User ID.

• The user’s social account is associated to their Digital Identity Management User ID.
• The social account can be used for authentication with the Onboard and Authenticate User with Social Account Process.

• The user failed to sign-in with the social provider’s website.
• The social media account is already associated to another Digital Identity Management User ID.
• The selected social media provider is not enabled or supported.
• Access token error (social provider does not return user information to Digital Identity Management).

​

App Settings

​

User Journey Diagram

[product: dim][/product: dim]

​

Use Cases

• Associate social account to existing Digital Identity Management User
• Social association errors

​

See Also

• Once the user associates a social account to their User ID, then can then authenticate into Digital Identity Management with the Onboard & Authenticate User with Social Account Process.
• The same Process,Onboard & Authenticate User with Social Account onboards a user into Digital Identity Management for the first time.
• The Dissociate Social Account from User Process removes a currently associated account.
• Associate social account to existing User
• Social account association errors