Tech Blog

Defining Facebook App for social login in Alma

Alma supports login using social network details. See Social Login for more details. Following are instructions for defining a Facebook app to allow login to Alma using Facebook.
Note that in order to define the Facebook app, you need an active Facebook account. This can be a personal account or a “general” account for the library. We recommend to use a general account.
    1. Connect to Facebook Developers site with the library’s Facebook account.
    2. Click on “My Apps” in the upper right and then “Create App”.
    3. Fill in the Display Name field. Note that you cannot use “Facebook” in the name:

Click “Create App ID”.

    1. On the next screen, add the “Facebook Login” product:
    2. On the next screen, select “Web” platform:

  1. Enter your site URL and press “Continue”. Click “next” to skip “Set Up the Facebook SDK for Javascript”, “Check Login Status”, “Add the Facebook Login Button”, “Next Steps”.
  2. Now click on “Facebook login” > “Settings” in the left menu
  3. Define the Redirect URIs
    Put the institution’s Alma domain and the institution’s Alma delivery domain, both with “/infra/socialLoginRedirect” suffix. For example:
    See here for more details about Alma domain names.
    Note that it is possible to configure here several URIs. This means that you can define here a sandbox URI, and later on add the production URI.
  4. Make sure that “Use Strict Mode” is on.
  5. Leave all the other settings as they are and click “Save Changes”.
  6. On the upper bar, switch mode from “development” to “live”:

12. Go back to “Settings”, and copy the App ID and secret. They should be defined in Alma in the “Social Login” integration profile. See Alma OLH for more details.

3 Replies to “Defining Facebook App for social login in Alma”

  1. Tamar,
    I have followed your steps successfully up to Step #11 which seems to have changed in facebook for developers since your post. Can you provide updated instructions starting at Step #11? Under App Review, it currently does not give me any option to make my App public.

  2. Thanks Tamar,
    I followed your instructions and I get the following error when clicking on the Facebook Social Login link:
    “error”: {
    “message”: “Can’t Load URL: The domain of this URL isn’t included in the app’s domains. To be able to load this URL, add all domains and subdomains of your app to the App Domains field in your app settings.”,
    “type”: “OAuthException”,
    “code”: 191,
    “fbtrace_id”: “ANFAtrv05x-fOwOUF53XXXX”

    Do you have any idea as to what I’m missing? I’ve double checked the App Domain settings in Facebook and it includes both hostnames that are listed in step #8 where I entered our and (substituting our hostname for ‘uni’ in the DNS names).

Leave a Reply