QQ Social Login Configuration Guide

QQ (also known as Tencent QQ) is a Chinese instant messaging service that provides microblogging, social games, music, and group and voice chat software. There are approximately 900 million active QQ accounts.

Before You Begin

Although not detailed in this configuration guide, you can create a new QQ app that enables users to log on to your web site by using their QQ account. To create a QQ developer account, you must complete a registration process that includes such tasks as providing a copy of your business license:

If you already have a QQ developer account, you can create a social login app from the QQ developer’s site (https://connect.qq.com).

Note. Web pages on the QQ Developers site are written in Chinese. If you do not speak Chinese, you might want to use a web browser than can translate the QQ web pages. For this configuration guide, we used Google Chrome and its Translate to English option.

In This Configuration Guide

  • Configuring QQ as a Social Login Provider
  • Testing QQ Social Login
  • Assigning a Different QQ App for Social Login
  • Removing QQ as a Social Login Provider

Configuring QQ as a Social Login Provider

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

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

Testing QQ Social Login

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

  1. In the QQ account security window, logon using a valid QQ account.
  2. If login succeeds, information returned from the QQ profile is displayed in the API response preview field.

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

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

See Also


Assigning a Different QQ App for Social Login

If you want to use a different QQ app or if you need to change your existing app, you must update the QQ 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 QQ.
  2. Click the green Configured button to display the QQ is currently enabled dialog box:

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

Although you can modify your QQ 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 QQ shows them.

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


Removing QQ as a Social Login Provider

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