Document steps to set up social login to the D8 portal

[jbennett13]

Document steps to set up social login to the D8 portal.

[kscheirer]

The winning module seems to be "Social Auth" - https://www.drupal.org/project/social_auth. There's a long list of supported auths on the project page - users will have to download one for each service with which they want to integrate.

[kscheirer]

@giteshk - do you think the 2 flows below are acceptable? They both have some drawbacks.

Social Auth does not change Drupal's user registration process at all - except for the outside auth. Specifically this means it respects registration settings at admin/config/people/accounts. We'll document the options available.

• Visitor - best user flow, your account is provisioned and you are logged in when returning from auth. This makes the devportal rather public though - anyone can register an account.
• Visitor, with admin approval - When you return your account is created but blocked. You see a message like "an admin must approve your account before you can login"
• Administrator only - disables user registration, therefore also social auth

[giteshk]

@kscheirer If we can fix the problem with the Apigee module with the social login integration that would work.

The registration flows you are suggesting seem to be similar to what core offers I am not following what the question is.

[kscheirer]

Hmm, it just felt weird. There are some more options available in the 2.x branch to control registration. I think you're right, this is not an issue.

[kscheirer]

• Install Kickstart
• Download and install https://www.drupal.org/project/social_auth and requires social_api, https://www.drupal.org/project/social_api, and one or more login implementations you'd like to support, such as
  • https://www.drupal.org/project/social_auth_google/
  • https://www.drupal.org/project/social_auth_facebook/
  • Docs are available for each implementation at https://www.drupal.org/docs/8/modules/social-api/social-api-2x/social-auth-2x. In general you will need to create an application at the relevant site (Google, facebook, etc), enter some information about your developer portal, and receive an API key. We will use that key later.
• Enable the modules
• Go to Configuration => Social API Settings => User Authentication or admin/config/social-api/social-auth
• Click the tab for the site with which you want to integrate (for ex, "Google")
• Enter API keys for your application

Add social links to login form

• Go to "Structure" => "Block layout"
• Drag the "Social Auth Login" block into the "Content" region
• Click Save
• Click "configure" for the Social Auth Login block
• uncheck "Display title"
• Click "Pages" vertical tab
• Enter /user/login for the Pages text area
• Select Show for the listed pages
• Click Save Block

Map first name and last name

• Download and enable https://github.com/kscheirer/Social-Auth-Map-Name

[jbennett13]

Draft almost complete.

[cnovak]

@jbennett13 is this completed or still outstanding?