Contents

Create Social Media Plug-In Apps

You can configure social media plug-ins on your captive portal that allow guest users to log in to your wireless network with their social media account credentials. Wi-Fi Cloud supports Facebook, Twitter, LinkedIn, Instagram, and Foursquare for social media authentication.

You can use the WatchGuard default app IDs for the social media plug-in configuration. However, due to compliance regulations, many social media vendors restrict the use of certain types of social media profile data provided to unapproved third-party apps. To manage your own analytics data from the social media vendor, we recommend you create your own social media app and have the app approved by the social media vendor.

Steps to create a Social Media Login App

These sections contain instructions on how to log in the developer's page for each social media site and create your own unique app IDs:

For more information on how to configure social plug-ins, see Configure Portal Social Media Plug-Ins.

Create a Facebook Login App

Facebook has recently implemented new compliance requirements about the storage and use of opt-in demographic profile information (age and gender) collected from guest Wi-Fi users. This data will no longer be available from the Wi-Fi Cloud-managed Facebook app, and profile information such as age and gender will appear as "Unspecified" in Analyze reports.

To use your own Facebook app, you must register the app in your Facebook developers account, then have the app approved.

  1. Log in to the Facebook Developers web site (https://developers.facebook.com) and register as a developer.
  2. Click My Apps, and then click Add a New App.
  3. Select Website and use the basic setup.

Screen shot of the Facebook developers Add a new App page

  1. Enter a Display Name for your app.
  2. Select the Category as Business.
  3. Click Create App ID.

Screen shot of the Facebook create a new app page

  1. Complete the security check.
  2. Click Settings on the left pane and then click +Add Platform on the Basic tab.

Screen shot of the Facebook app add platform page

  1. Click Website on the Select Platform window.

Screen shot of the Facebook app select platform page

  1. In the App Domains text box, type the full domain for the Analyze service.
    For example: mgm-wg11001.watchguard.cloudwifi.com
  2. In the Contact Email text box, type your email address.
  3. (Optional) Add a Privacy Policy URL and Terms of Service URL for your organization.
  4. In the Site URL text box, type the URL for the Analyze service.
    For example: https://mgm-wg11001.watchguard.cloudwifi.com

Screen shot of the Facebook app creation page

  1. Click Save Changes.

Configure Server IP Whitelist

We recommend you add your Analyze server address to the Server IP Whitelist to make sure that Wi-Fi Cloud servers are never blocked by Facebook for your app. This option is located in Settings > Advanced Settings in your Facebook app configuration.

Screen shot of the Server IP Whitelist section in the Facebook app configuration

Add the regional Analyze server address for your Wi-Fi Cloud account. This is the server name you see when you open the Analyze service in Wi-Fi Cloud.

These are the IP addresses for all Wi-Fi Cloud Analyze servers:

  • mgm-wg11003.watchguard.cloudwifi.com 52.206.127.247
  • mgm-wg11004.watchguard.cloudwifi.com 35.170.224.2
  • mgm-wg15001.watchguard.cloudwifi.com 52.58.196.26
  • mgm-wg17001.watchguard.cloudwifi.com 52.199.235.104
  • mgm-wg17002.watchguard.cloudwifi.com 54.199.105.157
  • mgm-wg15002.watchguard.cloudwifi.com 35.158.199.120
  • mgm-wg31002.watchguard.cloudwifi.com 18.207.64.219
  • mgm-wg11001.watchguard.cloudwifi.com 52.2.150.98
  • mgm-wg11002.watchguard.cloudwifi.com 52.206.127.243

Configure OAuth Settings

You must also add the URL for the Analyze service in the Facebook login OAuth settings.

  1. Select Products > Facebook Login > Settings.

Screen shot of the client OAuth settings in the Facebook app configuration

  1. In the Valid OAuth Redirect URIs text box, type the URL for the Analyze service appended with the path /plugin/facebook/auth.
    For example: mgm-wg11001.watchguard.cloudwifi.com/plugin/facebook/auth
  2. Click Save Changes.

Submit the Facebook App for Review

To make the Facebook app live:

  1. Click Status & Review, then click the No switch on the right pane to make it Yes.
  2. Click Confirm.
  3. Click App Details, and type the Long Description, Privacy Policy URL, Terms of Service URL, and User Support Email.
  4. Upload an App Icon.
  5. Click Save Changes.
  6. Click Status & Review, then click Start a Submission.

To obtain a guest user's likes, location, and birthday from their Facebook profile, you must select these options and submit the app for approval. The guest user's email address and basic profile information (first name, last name, and profile picture URL), can be fetched without having to obtain an approval for the Facebook app.

  1. Select the items you want to include in the submission and then click Add Items.
  2. For each item, click Add Notes and provide a description on how you are using the item within the app and add screen shots of how you use Facebook in your app,
  3. Click Submit for Review.

Get App ID and App Secret

To view the App ID and App Secret of your Facebook app that you will use in your captive portal configuration in Analyze:

  1. Select Settings, then click the Basic tab.
  2. Click Show to see the App Secret.

Screen shot of the App ID and App Secret details in the Facebook plug-in app

Configure the Facebook Plug-in in Analyze

To configure the Facebook Plug-in in Analyze:

  1. In Analyze, add the App ID and App Secret provided by Facebook in the Facebook plug-in of your portal.

Analyze - Facebook plug-in configuration

Create a Twitter Login App

  1. Log in to the Twitter App Developers website (https://apps.twitter.com) with your Twitter credentials.
  2. Click Create New App.
  3. Provide these details:
  • Name: A name for the application.
  • Description: A short description of the application.
  • Website: URL for the website from which the application is accessed. This is the URL for the Analyze service.
    For example: https://mgm-wg11001.watchguard.cloudwifi.com
  • Callback URL: The URL to which Twitter must redirect the user after successful authentication.
    For example: https://mgm-wg11001.watchguard.cloudwifi.com/plugin/twitter/auth
  1. Read and accept the Developer Agreement, then click Create your Twitter application.
    The consumer key and secret is generated and the app becomes live.
  2. Click the Keys and Access Tokens tab to obtain the Consumer Key and Consumer Secret.

Twitter application settings

  1. In Analyze, add the Customer Key and Customer Secret provided by Twitter in the Twitter plug-in configuration for your portal.

Analyze - Twitter configuration

Create an Instagram Login App

  1. Log in to the Instagram Developers website (https://instagram.com/developer) with your Instagram login credentials.

Instagram developer page

  1. Select Manage Client.
  2. Click Register a New Client.

Instagram app details

  1. Provide your Application Name, Description, Company Name, Website URL, and Contact email.
  2. In the Valid Redirect URIs text box, type the URL to which Instagram must redirect the user after successful authentication.
    For example: https://mgm-wg11001.watchguard.cloudwifi.com/plugin/instagram/auth
  3. In the Privacy Policy URL text box, type a URL to your privacy policy if you have one.
  4. Click Register.
    The Client ID and Client Secret for the app are generated.
  5. Copy the Client ID and Client Secret fields.
  6. In Analyze, add the Client ID and Client Secretto the Instagram plug-in configuration for your portal.

Analyze - Instagram configuration

Create a LinkedIn Login App

  1. Log in to the LinkedIn developer site (http://developer.linkedin.com) with your LinkedIn credentials.

LinkedIn developer page

  1. Click My Apps.
  2. Click Create Application.
  3. Provide these details:

LinkedIn create an application

  • Company Name: Name of your company.
  • Application Name: A name for the application.
  • Description: A short description of the application.
  • Application Logo: A logo for the application.
  • Application Use: Describe the application's purpose.
  • Website URL: URL of the web site from where the application is accessed. This is the URL for the Analyze service.
    For example: https://mgm-wg11001.watchguard.cloudwifi.com
  • Business Email: The business email ID of the contact person for this application.
  • Business Phone: The business phone number of the contact person for this application.
  1. Read and accept the Terms of Use.
  2. Click Submit.
    A Client ID and Client secret is generated and displayed.

LinkedIn client ID and client secret

  1. Type the Authorized Redirect URLs to which LinkedIn must redirect the user after successful authentication.

This URL is published on the LinkedIn plug-in configuration page in Analyze in the Authorized Redirect URLs under Oauth2.0 field.

For example: https://mgm-wg11001.watchguard.cloudwifi.com/plugin/linkedin/auth

  1. Click Add.
  2. Read and accept the Terms of Service.
  3. Select Settings, then from the Application Status drop-down list, select Live.

LinkedIn application status

  1. Select an appropriate language in the Legal Agreement Language field if you want to change the language of the user agreement.
  2. Click Update.
  3. In Analyze, add the App ID (Client ID) and the Secret Key (Client Secret) to the LinkedIn plug-in configuration for your portal.

Analyze - LinkedIn configuration

Create a Foursquare Login App

  1. Log in to the Foursquare developer website (https://foursquare.com/developers) with your Foursquare credentials.

Foursquare developer page

  1. Click Create a new app.

Foursquare app details

  1. Type a name for the app.
  2. In the Web addresses section, type the Download / welcome page URL and Your privacy policy URL.
  3. In the Redirect URI(s) text box, type the URL to which Foursquare must redirect the user after successful authentication.
    For example: https://mgm-wg11001.watchguard.cloudwifi.com/plugin/foursquare/auth
  4. From the Push API Notifications drop-down list, select Disable pushes to this app.
  5. Click Save Changes.
  6. In Analyze, add the App ID and Client Secret to the Foursquare plug-in configuration for your portal.

Analyze - Add Foursquare configuration

Give Us Feedback  ●   Get Support  ●   All Product Documentation  ●   Technical Search