Facebook SSO | Axero Documentation

Axero supports Facebook integration for single sign-on (SSO), out-of-the-box. This page walks you through configuring a Facebook App, shows you how to enable Facebook SSO in Axero, and demonstrates the Facebook login process.

Facebook SSO setup is estimated to take 1-2 hours. Once you complete the guide, Facebook SSO will be active on your intranet. For more information or assistance from the Axero team, submit a private case.

Features

• Join the intranet using a Facebook account
• Log in to your intranet using Facebook authentication
• Link Facebook and existing Axero accounts

Configure Facebook App

1. Visit the Facebook application page to create an application for your intranet.
2. Click My Apps.
3. Click Create App.
4. Click For Everything Else.
5. Enter a Display Name and Contact Email.
6. Click Create App ID.
7. Complete the security check.
8. For Facebook Login, click Set Up.
9. Click Web.
10. In Site URL, enter the URL of your intranet (e.g., https://myintranet.com).
11. Click Save.
12. Click Settings > Basic.
13. Enter the Privacy Policy URL.
14. Click Choose a Category.
15. Select a category.
16. Click Save Changes.
17. Click the In development toggle.
18. Click Switch Mode.
19. For App Secret, click Show.
20. Copy the App ID and App Secret.

Note that you do not need to submit any items for approval since Facebook Login default permissions do not need extra approvals. Facebook Login provides your app access to a person's public profile, friend list, and email address. These three permissions do not require review. Instead, your app's users will choose whether they want to grant access to this information.

You can go back and edit your Facebook app settings here: https://developers.facebook.com/apps.

Enable Facebook Login in Axero

1. In Axero, click the  gear icon > Control Panel > System > General Settings.
2. Expand the Social Integration Settings section.
3. Enter the App ID in the Facebook integration API Key field.
4. Enter the App Secret in the Facebook integration Secret field.
5. Check Integrate with the Facebook platform.
6. Check Enable 3rd party login.
7. Click Save System Settings.

When a user joins using their Facebook account, some information is pulled from Facebook and populated in their Axero account. Facebook Connect in Axero gets the user's email so that once the user becomes a member, the same email is populated and used in the Axero  User table. When a user returns to your community, they can log in using their Facebook credentials.

Note: Existing users can link their Axero account to their Facebook account only if the email address associated with the user in the community is the same as the user's Facebook email address. If the email address in the community is different from their Facebook email, and the user tries to log in via Facebook, then they will be added as a new user by Axero.

Login via Facebook

Enter your login information if necessary.