Amazon Social Login Configuration Guide


Amazon is both the largest Internet retailer in the world and the world’s No. 1 provider of cloud computing services.

Before You Begin

To use Amazon for social login you must:

  1. Obtain an Amazon developer account from https://sellercentral.amazon.com.
  2. Do one of the following:
    • Open a previously-created Amazon application and copy the client ID and client secret.
    • Create a new application and copy the client ID and client secret.
       
  3. Use the Janrain Engage Dashboard and the Amazon client ID and client secret to configure Amazon as a social login provider.

In This Configuration Guide

  • Creating an Amazon Application for Social Login
  • Using an Existing Amazon Application for Social Login
  • Configuring Amazon as a Social Login Provider
  • Testing Amazon Social Login
  • Assigning a Different Amazon Application for Social Login
  • Removing Amazon as a Social Login Provider

Creating an Amazon Application

This section walks you through the process of creating an Amazon application for social login. If you already have an application, see the Using an Existing Amazon Application for Social Login section of this documentation.

To create an Amazon application, complete the following procedure:

  1. Log on to the Amazon Applications Center (https://sellercentral.amazon.com).
  2. From the Applications page, click Register new application:

  1. On the Register Your Application page, enter:
    • The name of your application in the Name field.
    • A brief description of your application in the Description field.
       
  2. Click Save:

  1. Expand the Web Settings section:

  1. In the Web Settings section, copy and save the Client ID. You can copy the ID to a text editor, then close the text editor after you have configured Janrain social login.
  2. Click Show Secret.
  3. In the Client Secret dialog box, click Select All and then copy the client secret to the clipboard. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

  1. Enter your Amazon callback URL in the Allowed Returns URLs field and then click Save. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/amazon/callback:

  1. Log off from the Amazon Applications center.

Using an Existing Amazon Application

If you already have a social login application, complete the following steps to retrieve the application’s client ID and client secret:

  1. Log on to the Amazon Applications center https://sellercentral.amazon.com.
  2. From the Applications page, click the name of the app you want to use for social login:

  1. From the home page for your application, in the Web Settings section, copy the Client ID. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

  1. Click Show Secret.
  2. In the Client Secret dialog box, click Select All and then copy the client secret to the clipboard. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

  1. Log off from the Amazon Applications center.

Configuring Amazon as a Social Login Provider

To configure Amazon as a social login provider, make sure you have your Amazon client ID and client secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Amazon.
  6. In the Amazon dialog box, click Next until you reach the screen requesting the client ID and client secret:

  1. Paste your Amazon client ID in the Client ID field, paste your Amazon client secret in the Client Secret field, and then click Save. Amazon appears in your social login widget.
  2. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Amazon appears as a social login option for your web site.

Testing Amazon Social Login

To test Amazon social login, complete the following procedure:

  1. Do one of the following:
    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.
       
  2. From the Test page, click the Amazon icon:

  1. In the Amazon.com Sign In window, logon using a valid Amazon account:

  1. If login succeeds, information returned from the Amazon profile is displayed in the API response preview field:

The returned profile information will vary depending on:

  • The Amazon account used in the test.
  • The profile information you requested for Amazon.

You can verify Amazon profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

  1. From the Configure Providers page, click Amazon.
  2. Profile information returned from Amazon is displayed onscreen. For example:

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using an Amazon account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

For example, if you ask for a user’s address during logon, he or she will see the following message before they log on:

The user can either click Okay to forward all the requested information, or can click Cancel to terminate logon.

On the Configure Providers page, click Ask to turn off the information request.


Assigning a Different Amazon Application for Social Login

If you want to use a different Amazon application or if you need to change your existing application, you must update the Amazon provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

  1. On the Configure Providers page, click Amazon.
  2. Click the green Configured button to display the Amazon is currently enabled dialog box:

  1. To change the Amazon configuration, click Modify these settings.
  2. In the Amazon dialog box, change the Client ID and/or Client Secret as needed, and then click Save:

Although you can modify your Amazon settings, you cannot delete these settings. If you delete the settings and try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Amazon shows them.

This means that you cannot “unconfigure” the provider: once configured, the Amazon icon will always be shown as green (i.e., configured) in the Janrain Dashboard.


Removing Amazon as a Social Login Provider

If you no longer want to use Amazon for social login, you can remove Amazon as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Amazon icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Amazon no longer appears in the sign-on widget.
Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.