Was this article helpful?


Last modified 09:36, 20 Feb 2014

This page is a step-by-step guide for the process of opening and setting up an external application in Facebook as part of the Gigya Setup process.

Clients with sites defined under Gigya's European data center should replace domain references to (http:// or https://) "socialize.gigya.com" (or "socialize.us1.gigya.com") with "socialize.eu1.gigya.com". To verify site location contact your implementation manager.
Domain references are defined in Gigya's dashboard, externally in social network app definition pages, and when using Gigya's SDKs to set the domain (in particular the APIDomain field in class GSRequest). 


Phase 1 - Opening the Application in Facebook

Optional: If you are planning on configuring a domain alias (CNAME), please replace 'socialize.gigya.com' with your alias subdomain (CNAME value). i.e. http://[YOUR-ALIAS-SUB-DOMAIN].yoursite.com.
  1. Login to your Facebook account.
  2. Open the Facebook developer's page at: https://developers.facebook.<wbr/>com/apps?ref=mb.
  3. Click on "Create a New App".

    Create App button
  4. In the "Create a New App" box:
  5. Enter the Captcha and press 'Submit'. Note that after pressing submit, you receive no confirmation of a successful submit and the Captcha remains open. 
  6. Click on the "Settings" button on the left.
    • Copy the "App ID" and the "App Secret" strings (you will need to paste them in Gigya's website, as described in phase 2), use the Show button to see the "App Secret".
    • Enter your site's domain in the "App Domains" field. These are the domains within which OAuth will authorize your app to view data. 

  7. Click on the "Add Platform" button at the bottom of the Settings box and select "Website".  
    Add platform
  8.  Enter your website's address and your mobile site (if available) , then click "Save Changes".
    Enter website address and save changes
  9.  Select the "Advanced" tab of the Settings page:
    • Set "Native or desktop app?" to "No".
    • Set "App Restrictions" as you require.
  10. In the "Security" section of the "Advanced" tab set the following:
  11. Set the "Client OAuth Login" to Yes.
  12. In the Valid OAuth redirect URIs enter:
    • http://socialize.gigya.com/GS/GSLogin.aspx​​?
    • https://socialize.gigya.co​m/GS/GSLogin.aspx?
      If your site is defined under Gigya's European data center replace socialize.gigya.com with socialize.eu1.gigya.com.
      If you are using a CNAME add it to the Authorized Redirect URI:
      • http://<CNAME>/GS/GSLogin.aspx?
      • https://<CNAME>/GS/GSLogin.aspx?
        Security settings
  13. Click the blue "Save Changes" button.
  14. Click on the "App Details" button on the left. For an explanation of the "App Details" fields see https://developers.facebook.com/docs/games/appcenter/guidelines.
  15. In the App Details "Contact Info" section enter relevant details. A privacy policy URL is required by Facebook, other URLs are optional. Click on "Create New Page" to setup a Facebook page for your app.
    Contact info
  16. In the "App Center Listed Platform" section, set Website to "Yes".
    App center listed platforms
  17. Enter icons, banners, screenshots and videos in the relevant sections. For Facebook information on the requirements see https://developers.facebook.com/docs/games/appcenter/guidelines.
    The minimum requirements for these sections are:
    • Icons section - At least a logo
    • Banners section - At least a web banner and cover image.  
    • Screenshots - At least 3 screenshots are required.
  18. Click the "Localize" button on the left if you want to configure your app's details for viewing in other languages.
  19. Optional: Facebook provide an option to request public approval of your app. Note that this may take some time and is not required for logging in with Facebook.  
    • If you do want to get Facebook approval, click on the "Status & Review" button on the left, set your app to be available to the general public (unless it is still being tested) and then click "Start a submission":
      Status & Review
    • A dialog box will open for you to select the Apps to be included in the submission (more than one app may be submitted at once).
    • A red triangle will appear next to "Status & Review" and any sections where additions are required. If you click on the App Details button, a message will tell you what items are missing.
      Ineligible for submission indicator  

Optional - for Advanced Users Only

  • If you are planning on using the Facebook External Application Canvas Page:
    1. Click the "Settings" button on the left.
    2. Click the "Add platform button" at the bottom of the Settings box, and select "App on Facebook". 
      App on Facebook
    3. In the "Canvas URL" field paste: http://socialize.gigya.com/GS/SNLink.aspx ?appId=<appid> 
    4. In the "Secure Canvas URL" field paste': https://socialize.gigya.com/GS/SNLink.aspx?appId=<appid>   
      <appid> must be replaced with your App ID which is located at the top of the page. 
      If your site is defined under Gigya's European data center replace socialize.gigya.com with socialize.eu1.gigya.com.
      Optional: If you are planning on configuring a domain alias (CNAME), please replace 'socialize.gigya.com' with your alias subdomain (CNAME value). i.e. http://[YOUR-ALIAS-SUB-DOMAIN]/GS/SNLink.aspx?appId=<appid>
      Note that you cannot use a specific html page as a canvas URL: Use http://www.yoursite.com/canvas/ not http://www.yoursite.com/canvas.html.
      Canvas URL settings 
    5. Click the "Save Changes" button.
  • If you are using a CNAME and would like to redirect users to other servers (i.e. for geographic distribution of load) and enable OAuth on additional subdomains, add your subdomains in the 'App Domain' field:
    1. Click the "Settings" button on the left.
    2. Enter your domain names in the "App Domains" field.
    3. Click the "Save Changes" button.
      Adding additional domains

Phase 2 - Configuring Facebook's Application Keys in Gigya's Website

  1. Go to the Dashboard section of Gigya's website.
    Note: If you are not signed in to Gigya, please go to http://www.gigya.com/ and sign in.
  2. Press the "Site Settings" button that corresponds to the domain you wish to configure. You will be redirected to the "Site Settings" page.


  3. Paste your keys (the "Secret Key" and the "Application Id" from the end of phase 1) in the corresponding places:

  4. Click the "Save Settings" button (located at the lower right-hand corner of the page).
  5. If you are defining a canvas application, goto Settings >> Site Settings >> Providers Configurations.
  6. If you are defining a canvas application, enter the canvas page url you defined in Facebook. 

That's it, Facebook configuration is complete! Please note that it might take up to 10 minutes for our system to become synchronized with Facebook.


Note: to learn how to localize your Facebook application to different languages, please refer to http://developers.facebook.<wbr/>com/docs/internationalization/.
Was this article helpful?
Pages that link here
Page statistics
19260 view(s) and 22 edit(s)
Social share
Share this page?


This page has no custom tags set.


You must to post a comment.