Tumblr Social Login Configuration Guide


Tumblr is a microblogging and social networking site that hosts over 350 million blogs.

Before You Begin

To use Tumblr for social login you must:

  1. Obtain a Tumblr developer’s account from https://tumblr.com/oauth/apps.
  2. Do one of the following:
    • Open a previously-created Tumblr application, and copy the OAuth consumer key and secret key.
    • Create a new Tumblr application and copy the OAuth consumer key and secret key.
       
  3. Use the Janrain Engage Dashboard and the Tumblr OAuth consumer key and secret key to configure Tumblr as a social login provider.

In This Configuration Guide

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

Creating a Tumblr Application

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

To configure a Tumblr application, complete the following procedure:

  1. Log on to the Tumblr Applications site (https://www.tumblr.com/oauth/apps).
  2. From the Applications page, click Register application:

  1. On the Register your application page, enter:
    • The name of your application in the Application Name field.
    • The URL of your web site in the Application Website field.
    • A brief description of your application in the Application Description field.
    • Your contact email address in the Administrative contact email field.
    • Your Tumblr redirect URL in the Default callback URL field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/tumblr/callback.
  2. Scroll to the bottom of the page, select I’m not a robot and then click Register:

  1. From the home page for your new app, click Show secret key:

  1. Copy the OAuth Consumer Key and the Secret Key. 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 Tumblr Applications site.

Using an Existing Tumblr Application for Social Login

If you already have a Tumblr application that can be used for social login, complete the following steps to retrieve the application’s OAuth consumer key and secret key:

  1. Log on to the Tumblr Applications site (https://www.tumblr.com/oauth/apps).
  2. From the Applications page, locate the application you want to use for configuring social login and copy the OAuth Consumer Key. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login. Click Show secret key:

  1. Copy the Secret Key. 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 Tumblr Applications site.

Configuring Tumblr as a Social Login Provider

To configure Tumblr as a social login provider, make sure you have your Tumbler OAuth consumer key and secret key, 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 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. From the list of Providers, click Tumblr.
  6. In the Tumblr dialog box, click Next until you reach the screen requesting the OAuth consumer key and secret key:

  1. Paste your Tumblr OAuth consumer key in the OAuth Consumer Key field, paste your Tumblr secret key in the Secret Key field, and then click Save. Tumblr 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 Tumblr appears as a social login option on your web site.

Testing Tumblr Social Login

To test Tumblr 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 Tumblr icon:

  1. In the Log in | Tumblr window, logon using a valid Tumblr account:

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

The returned profile information will vary depending on the Tumblr account used in the test.

You can verify Tumblr 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 Tumblr.
  2. Profile information returned from Tumblr is displayed onscreen. For example:

See Also


Assigning a Different Tumblr Application for Social Login

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

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

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

  1. To change the Tumblr configuration, click Modify these settings.
  2. In the Tumblr dialog box, change the OAuth Consumer Key and/or the Secret Key as needed, and then click Save:

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

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


Removing Tumblr as a Social Login Provider

If you no longer want to use Tumblr for social login, you can remove Tumblr 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 Tumblr icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Tumblr 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.