SoundCloud Social Login Configuration Guide


SoundCloud is a German-based distribution service that enables users to upload, promote, and share music that they have created. SoundCloud has approximately 175 million users from all over the world.

Before You Begin

At the moment, SoundCloud is not accepting new application registrations:

Because of that, new SoundCloud applications cannot be provisioned. However, previously-created SoundCloud applications can still be used for social login.

In This Configuration Guide

  • Using an Existing SoundCloud App for Social Login
  • Configuring SoundCloud as a Social Login Provider
  • Testing SoundCloud Social Login
  • Assigning a Different SoundCloud App for Social Login
  • Removing SoundCloud as a Social Login Provider

Using an Existing SoundCloud App for Social Login

If you already have a SoundCloud app that can be used for social login, complete the following steps to retrieve the application’s client ID and client secret:

  1. Log on to SoundCloud for Developers (https://developers.soundcloud.com).
  2. From the SoundCloud for Developers home page, click Your Apps and then click the name of the app you want to use to configure social login:

  1. Copy the client ID and client secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.
  2. Log off of SoundCloud for Developers.

Configuring SoundCloud as a Social Login Provider

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

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

Testing SoundCloud Social Login

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

  1. Logon using a valid SoundCloud account.
  2. If login succeeds, information returned from the SoundCloud profile is displayed in the API response preview field.

The returned profile information will vary depending on:

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

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

Assigning a Different SoundCloud App for Social Login

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

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

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

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

See Also

Removing SoundCloud as a Social Login Provider

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