Disqus Social Login Configuration Guide


Disqus is a blog comment hosting service used by 3.5 million websites. Blog comment hosting services maintain comments posted by users in response to blogs and other online posts.

Before You Begin

To use Disqus for social login you must:

  1. Obtain a Disqus developer account from https://disqus.com/api.
  2. Do one of the following:
    • Open a previously-created Disqus application, and copy the API key and API secret.
    • Create a new application and copy the API key and API secret.
       
  3. Use the Janrain Engage Dashboard and the Disqus API key and API secret to configure Disqus as a social login provider.

In This Configuration Guide

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

Creating a Disqus Application

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

To configure a Disqus application, complete the following procedure:

  1. Log on to the Disqus API Resources site (https://disqus.com/api).
  2. From the API Resources page, click Get started with the Disqus API by registering an application:

  1. On the Register Application page, enter:
    • The display name of your application in the Label field.
    • A brief description of your application in the Description field.
    • The URL for your application in the Website field.

  2. Scroll to the bottom of the page, fill in the Recaptcha text, and then click Register my application:

  1. From the Application Details page for your new app, on the Settings tab, scroll down to the Domains field and enter your application domains, one domain per line. One of your domains must be the application website minus the HTTP or HTTPS protocol (for example, greg-stemp.rpxnow.com):

  1. In the Authentication section, click Default Access and then click Read and Write:
  2. Enter the Disqus redirect URL for your application in the Callback URL field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/disqus/callback:

  1. Enter the name of your organization in the Organization field and then click Save Changes:

  1. On the Application Details page, click Details.
  2. On the Details tab, scroll down to the OAuth Settings section and then copy and save the API Key and API Secret. 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 Disqus Applications center.

Using an Existing Disqus Application for Social Login

If you already have an Disqus application that can be used for social login, complete the following steps to retrieve the application’s secret key and public key:

  1. Log on to the Disqus API Resources site (https://disqus.com/api).
  2. From the API Resources page, click Applications:

  1. From the Applications tab, locate the application you want to use to configure social login and then copy the Secret Key and Public 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 Disqus API Resources center.

Configuring Disqus as a Social Login Provider

To configure Disqus as a social login provider, make sure you have your Disqus API key and API 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 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 Disqus.
  6. In the Disqus dialog box, click Next until you reach the screen requesting the API key and API secret:

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

Testing Disqus Social Login

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

  1. In the Disqus – Authorize an application window, logon using a valid Disqus account:

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

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

See Also


Assigning a Different Disqus App for Social Login

If you want to use a different Disqus app or if you need to change your existing app (perhaps because you have a new API secret) you must update the Disqus 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 Disqus.
  2. Click the green Configured button to display the Disqus is currently enabled dialog box:

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

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

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


Removing Disqus as a Social Login Provider

You can remove Disqus 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 Disqus icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Disqus 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.