Tech Blog

Defining Google 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 Google app to allow login to Alma using Google .

    1. Connect to Google APIs Console with the library’s google account.
    2. Create a project with any name.
    3. In the left pane, select “Credentials” > “Oath consent screen”. Enter:

Authorized domains: Alma domain (For example:

Product logo URL: Optional. Recommended


4. In the left pane, select “Credentials” > “Create Credentials” > “Oath Client ID”:

  1. Enter the following values:

Application type: Web application
Name: any name the institution chooses
Authorized redirect URIs: put 2 URIs here: <Alma domain>/infra/socialLoginRedirect (For example: and <Alma delivery domain>/infra/socialLoginRedirect (For example:

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.


5. After registration is completed, Google gives the following credentials: Client ID, Client Secret

The App ID and App secret should be defined in Alma in the “Social Login” integration profile. See Alma OLH for more details.


6. In the Dashboard, choose “Enable APIs and Services”:




Search for “Google+ API”, and enable it.


4 Replies to “Defining Google App for social login in Alma”

  1. this seemed to work okay. i was pretty stressed as i’ve never done anything quite like this before… although i have worked with APIs in a bit in Alma itself, i don’t have a great understanding of them.

    By Laura Guy on September 3, 2016 at 2:53 PM

  2. Well, I spoke to soon. I am having trouble testing this in the Sandbox. I realize belatedly the URI is set up for production so I guess I need to change it. But the sandbox URL that we use is weird looking and not like your example (which points to NA01)

    By Laura Guy on September 3, 2016 at 3:27 PM

  3. I managed to get almost all the way to the end of this successfully. An email is sent. I approve the terms. The app is successfully connected to my gmail account.

    But I get this error: Unfortunately we failed to attach your user to your Google account.

    I guess I need to submit a ticket. I keep wondering if there is one more piece somewhere in Alma that needs to be enabled? The identifier is not being added to my Alma record as per the documentation in the developers site.

    By Laura Guy on September 3, 2016 at 4:32 PM

Leave a Reply