This documentation is for WSO2 Identity Server 5.3.0. View documentation for the latest release.
Page Comparison - Configuring Facebook (v.11 vs v.12) - Identity Server 5.3.0 - WSO2 Documentation

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tip
titleBefore you begin
  1. Create a Facebook account and register an application on Facebook.
  2. Sign in to the WSO2 Identity Server Management Console at https://<Server Host>:9443/carbon using your username and password
Excerpt

Follow the steps given below to add a new identity provider in WSO2 Identity Server.

  1. Download the WSO2 Identity Server from here and run it.
  2. Log in to the Management Console as administrator.
  3. In the Identity section under the Main tab of the Management Console, click Add under Identity Providers.
  4. Give a suitable name as the Identity Provider Name.
    Image Added
  5. Go to Facebook Configuration under Federated Authenticators

  6. Enter the following values in the form that appears:

    FieldDescriptionSample Value
    Client IdThis refers to the App ID you received from the Facebook app you created.

    <Application ID of the Facebook App>

    Expand
    titleDon't know the client ID? Click here for more information?
    1. Go to https://developers.facebook.com/ and log in using your Facebook credentials.
    2. Click on your app from the My Apps drop-down list.
    Client SecretThis refers to the App Secret you received from the Facebook app you created.<App Secret of the Facebook App>
    ScopeDefines the permission to access particular information from a Facebook profile. See the Permissions Reference for a list of the different permission groups in Facebook APIs.  email
    User Information FieldsThese are the claims related to the user account on Facebook. WSO2 Identity Server requests these fields from Facebook when a user is authenticated with Facebook through the IS. See public_profile permission for more information about these fields. id,name,gender,email,first_name,last_name,age_range,link
    Callback UrlThis is the URL to which the browser should be redirected after the authentication is successful. This should be thecommonauthendpoint of Identity server.https://localhost:9443/commonauth

    Image Added

  7. Select both checkboxes to Enable Facebook Authenticator and make it the Default.

  8. Click Register.

You have now added the identity provider.

  1. Navigate to the Identity Provider section under Main > Identity menu-item.
  2. Click Add.
  3. Provide values for the following fields under the Basic Information section:
    Excerpt Include
    Configuring an Identity Provider
    Configuring an Identity Provider
    nopaneltrue
  4. Expand the Facebook Configuration form.
  5. Fill in the following fields where relevant.

    FieldDescriptionSample value
    Enable Facebook AuthenticationSelecting this option enables Facebook to be used as an authenticator for users provisioned to the Identity Server.Selected
    DefaultSelecting the Default checkbox signifies that the Facebook credentials are the main/default form of authentication. This removes the selection made for any other Default checkboxes for other authenticators.Selected
    Client IdThis is the username from the Facebook app. These are obtained from the Facebook App you create using your Facebook Developer account. See Logging in to your Application via Identity Server using Facebook Credentials for more information on how to do this.1421263438188909
    Client SecretThis is the password from the Facebook app. Click the Show button to view the value you enter.12ffb4dfb2fed67a00846b42126991f8
    ScopeYou can restrict the claims sent to the Identity Server. This means you can restrict the claims by specifying them in the scope.email
    User Information FieldsYou can send a comma separated list of claims that you need to receive. id,email,name
    Callback URL

    This is the URL to which the browser should be redirected after the authentication is successful. It should have this format: https://(host-name):(port)/commonauth. Here Callback URL is the endpoint in WSO2 Identity Server which accepts the response sent by facebook.

    https://localhost:9443/commonauth

...