Microsoft

Skip to end of metadata
Go to start of metadata

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

 

Note: Microsoft apps require a domain alias (CNAME) that redirects to Gigya, for example "http://login.yoursite.com" which redirects to an address assigned by Gigya customer services.  Please ask your customer service representative for the precise redirection definition. 

For additional information on creating CNAMES with specific hosting providers see this document.

Note: If your site is defined under one of Gigya's non-US data centers, replace domain references to (http:// or https://) "socialize.gigya.com" (or "socialize.us1.gigya.com") with https://socialize.<data_center>/

Where <Data_Center> is:
  • us1.gigya.com - For the US data center.
  • eu1.gigya.com - For the European data center.
  • au1.gigya.com - For the Australian data center.
  • ru1.gigya.com - For the Russian data center.
  • cn1.gigya-api.cn - For the Chinese data center.

If you are not sure of your site's data center, see Finding Your Data Center.

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). 

When using any 3rd Party Apps with Gigya, it is important to ensure that you Enable retrieving user contacts from the Permissions page of the Console prior to making your app live. This enables basic username and email retrieval for your users from providers that don't consider this an elevated permission.

 

Phase 1 - Opening the Application in Microsoft

  1. Go to the following URL: https://apps.dev.microsoft.com/ (sign in required).
  2. Click on Add an app.

  3. Enter an Name for your application.
  4. Under Application Id is the key you will enter in the Client ID field of the Gigya Console. 
  5. In the Application Secrets section, press Generate New Password.
  6. Copy the secret you get here and save it immediately. You can not reacquire this secret key after closing the popup window. This is the Secret Key you will input to the Gigya Console.


  7. In the Platforms section, click Add Platform and select Web.


  8. In the Web configuration, add your Redirect URIs. These must be a CNAME alias and all lower-case. Allow Implicit Flow should remain checked.


    You must use either https://socialize.<data_center_id>.gigya.com/GS/GSLogin.aspx or a CNAME configured using a Custom API Domain Prefix configured via Gigya Customer Service.



  9. In the Profile section, upload a Logo, and input links to both your Terms of Service URL and Privacy Statement URL.

     
  10. Under Advanced Options, ensure that Live SDK support is checked.
  11. Click Save.
  12. Set Mobile or Desktop client app to "yes", Restrict JWT issuing to "Yes", Enhanced Redirect Security to "Enabled".

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

  1. Go to the Dashboard section of Gigya's website.
     
  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. Select Provider Configurations from the left hand menu.


     
  4. Click the Icon for Messenger to open the Configuration dialog.


     
  5. Insert your Client ID and Secret Key you received from Microsoft in the previous section in the corresponding fields.



  6. A CNAME is required to use the Microsoft/Messenger app. Please be sure you have a correctly configured CNAME for your site and that the Enable CName checkbox is ticked. 


     
  7. Click OK and then the Save Settings button located at the bottom right of the Provider Configurations page.

     


That's it, Microsoft application configuration is complete!

Please note that it may take up to 10 minutes for changes to become synchronized with Microsoft.