Social Connect Options - HL Vanilla Community
<main> <article class="userContent"> <p><strong>Higher Logic Vanilla</strong> (<strong>Vanilla</strong>) integrates with several third-party applications that accommodate <strong>Single Sign-On</strong> (<strong>SSO</strong>) access from the application to Vanilla. This means that your users can access your Vanilla community, <em>without having to sign in</em>, directly from one of these applications that they are currently signed in to.</p><div class="js-embed embedResponsive" data-embedjson="{"body":"Higher Logic Vanilla (Vanilla) offers several addons that you can use to connect to other accounts that you have. These Social Connect Addons are listed below and some are described in more detail in dedicated sections. Manage your Social Media Connections 1. Access the Dashboard. 2. Navigate to Settings > Connections >…","photoUrl":"https:\/\/us.v-cdn.net\/6030677\/uploads\/VWGAXAF5OFCO\/microsoftteams-image.png","url":"https:\/\/success.vanillaforums.com\/kb\/articles\/360","embedType":"link","name":"Social Media Connections - Vanilla Success"}"> <a href="https://success.vanillaforums.com/kb/articles/360" rel="nofollow noreferrer ugc"> https://success.vanillaforums.com/kb/articles/360 </a> </div><p>This article focuses on the third-party applications that offer SSO access to Vanilla.</p><p>📝 <strong>NOTE</strong>: If the user signs out of the third-party application, they lose the SSO-access functionality.</p><h2 data-id="facebook">Facebook</h2><p>Vanilla's <strong>Facebook Social Connect</strong> addon lets users sign in to Vanilla via their current Facebook session. You must register your application with Facebook for this addon to work.</p><h3 data-id="set-up-facebook-social-connect">Set up Facebook Social Connect</h3><p>In order to set up Facebook Social Connect, you must create an “application” in Facebook at <a href="https://developers.facebook.com/apps" rel="nofollow noreferrer ugc">https://developers.facebook.com/apps</a>.</p><p>After your application has been set up, copy the "Application ID" and "Application Secret" and paste them accordingly on the Vanilla (<strong>Dashboard > Settings > Connections > Social Media</strong>) Facebook Social Connect <strong>settings</strong> page.</p><p>The <strong>Valid oAuth Redirect URI</strong> should be https://community.yoursite.com<strong>/entry/connect/facebook</strong> or https://<em>yoursite.vanillacommunities</em>.com<strong>/entry/connect/facebook</strong> (if you do not have a custom domain).</p><h4 data-id="data-deletion">Data deletion</h4><p>In February of 2021, Facebook added a <em>required parameter</em>, <strong>User Deletion Data</strong>, in the Basic Settings page of their application dev site. In this field, Facebook is requesting a link to documentation or to a support page where users can request that their data be deleted. The easiest solution here is to set the toggle to <strong>Data Deletion Instructions URL</strong> and link to a Support page, on your site or within your community, that has instructions for users and contact information so that they can reach out to your moderation/admin team to process the deletion request.</p><h3 data-id="create-a-facebook-application">Create a Facebook application</h3><p>For a complete walk-through of the steps, see <a href="http://blog.vanillaforums.com/facebook-application-for-vanillaforums-sso/" rel="nofollow noreferrer ugc">How to Create a Facebook Application for Vanilla Forums Single Sign-On (SSO)</a>.</p><h2 data-id="twitter">Twitter</h2><p>Vanilla's <strong>Twitter Social Connect</strong> addon lets users sign in to Vanilla via their current Twitter session. You must register your application with Twitter for this addon to work.</p><h3 data-id="set-up-twitter-social-connect">Set up Twitter Social Connect</h3><p>Register Vanilla with Twitter at <a href="https://apps.twitter.com/app/new" rel="nofollow noreferrer ugc">https://apps.twitter.com/app/new</a>.</p><p>Set the <strong>OAuth 1.0a Redirect URLs</strong> by appending <em>/entry/connect/twitter</em> <strong>and</strong> <em>/profile/twitterconnect</em> to your forum's URL. (If your forum is at https://community.example.com, your Redirect URLs would be https://community.example.com<strong>/entry/connect/twitter</strong> and https://community.example.com<strong>/profile/twitterconnect</strong>).</p><p>📝 <strong>NOTE</strong>: Make sure that your redirect URLs are HTTP<strong>S</strong>; otherwise, they won't work. Also, make sure that there aren't any following spaces or slashes (e.g., /entry/connect/twitter<strong>/</strong> is not valid).</p><p>After registering, copy the "API key" and "API secret key" and paste them accordingly on the Vanilla (<strong>Dashboard > Settings > Connections > Social Media</strong>) Twitter Social Connect <strong>settings</strong> page.</p><p><strong>Whitelisting</strong></p><p>Twitter enforced that sign-in-with-Twitter users must allow callback URLs for security reasons.</p><p>This means that callback URLs have to be explicitly and identically set up for all supported third-party applications. You can set up the callback URLs in your Twitter's application setup page, <a href="https://apps.twitter.com" rel="nofollow noreferrer ugc">https://apps.twitter.com</a>.</p><p>For example, if your callback URL is <strong>http://localhost:8080/myApp/signin/twitter</strong>, you must add it to the list of Callback URLs in your Twitter's application setup page <em>exactly as it is</em>.</p><h2 data-id="google">Google</h2><p>Vanilla's <strong>Google SignIn</strong> addon lets users sign in to Vanilla with Google account credentials. You must configure your site in <a href="https://console.developers.google.com/" rel="nofollow noreferrer ugc">Google API Console</a>.</p><h3 data-id="set-up-google-signin">Set up Google SignIn</h3><p>1. Enable the Google SignIn addon in the Vanilla Dashboard.</p><p>2. Access your API Console at Google and create a project.</p><p>3. Click on the project name and in the side menu, select <strong>Credentials</strong>.</p><p>4. Under the Credentials tab in the main content area of the page, click <strong>Create credentials</strong> button and choose <strong>OAuth Client ID</strong>.</p><p>5. Select <strong>Web Application</strong> as Type.</p><p>6. For authorized JavaScript Origins, the URL will be your Vanilla Application URL.</p><ul><li>If you get a warning, '<em>Invalid Origin: Domain must be added to the authorised domains list before submitting</em>', click on the link provided and navigate to the <strong>Authorised domains</strong> section to add your domain to the list of trusted domains. <em>Be sure to save</em>.</li></ul><p>7. For authorized redirect URL, append <strong>/entry/googlesignin</strong> to your forum's URL. (If your forum URL is https://example.com/forum, your redirect URL is https://example.com/forum/<strong>entry/googlesignin</strong>).</p><p>8. Copy the "Client ID" and "Secret" and paste them accordingly on the Vanilla (<strong>Dashboard > Settings > Connections > Social Media</strong>) Google SignIn <strong>settings</strong> page.</p><p>📝 <strong>NOTE</strong>: If you have never used Google APIs, you must also fill in Consent Screen.</p><h2 data-id="linkedin">LinkedIn</h2><p>Vanilla's <strong>LinkedIn Social Connect</strong> addon lets users sign in to Vanilla via their current LinkedIn session. You must register your application with LinkedIn for this addon to work.</p><h3 data-id="set-up-linkedin-social-connect">Set up LinkedIn Social Connect</h3><p>1. Enable the LinkedIn Social Connect addon in the Vanilla Dashboard.</p><p>2. Go to the LinkedIn Developer Network, <a href="https://www.linkedin.com/secure/developer" rel="nofollow noreferrer ugc">https://www.linkedin.com/secure/developer</a>.</p><p>3. Click <strong>Add New Application</strong>. When you create the application, you can choose what to enter in most fields, make sure you enter specific information for some fields.</p><p>4. Under <strong>Website URL</strong>, enter your forum's root URL.</p><p>5. Under <strong>Default Scope</strong>, select at least <strong>r_basicprofile </strong>and <strong>r_emailaddress</strong>.</p><p>6. Set the <strong>OAuth 2.0 Redirect URLs</strong> by appending <em>/entry/connect/linkedin</em> <strong>and</strong> <em>/profile/linkedinconnect</em> to your forum's URL. (If your forum is at http://example.com/forum, your Redirect URLs would be http://example.com/forum<strong>/entry/connect/linkedin</strong> and http://example.com/forum<strong>/profile/linkedinconnect</strong>).</p><p>7. After your application has been set up, copy the "Client ID" and "Client Secret" and paste them accordingly on the Vanilla (<strong>Dashboard > Settings > Connections > Social Media</strong>) LinkedIn Social Connect <strong>settings</strong> page.</p><h2 data-id="steam">Steam</h2><p>Vanilla's <strong>Steam Connect</strong> addon can act as an OpenID provider. This allows your application to authenticate a user's SteamID without requiring them to enter their Steam username or password on your site.</p><h3 data-id="set-up-steam-connect">Set up Steam Connect</h3><p>1. Retrieve a Web API Key by following the instructions at <a href="https://steamcommunity.com/dev" rel="nofollow noreferrer ugc">Steam Web API Documentation</a>.</p><p>2. Navigate to Vanilla's Social Connect Addons page (<strong>Dashboard > Settings > Connections > Social Media</strong>) and enable the OpenID and Steam Connect addons.</p><p>3. Configure Steam Connect by specifying the Web API Key (retrieved in step 1) on its <strong>settings</strong> page.</p><h2 data-id="microsoft">Microsoft</h2><p>Vanilla's <strong>Microsoft Account</strong> addon lets users sign in to Vanilla with Microsoft account credentials. You must set up SSO at the <a href="https://portal.azure.com/#home" rel="nofollow noreferrer ugc">Microsoft Azure Portal</a>.</p><p>Minimal set up requirements:</p><p>1. From App registration, click <strong>Add new registration</strong>.</p><p>2. Redirect URI: <strong>http://example.com/entry/microsoftaccount</strong>.</p><p>3. Logout URL: <strong>http://example.com/entry/signout</strong>.</p><p>4. From the manifest, make sure your sign in audience is set to "signInAudience": "AzureADandPersonalMicrosoftAccount".</p><p>5. From certifications and secrets, create a new client secret.</p><p>6. Copy the "Client ID" and "Client Secret" and paste them accordingly on the Vanilla (<strong>Dashboard > Settings > Connections > Social Media</strong>) Microsoft Account <strong>settings</strong> page.</p> </article> </main>