add tip for enabling social login with oauth2

related to jhipster/generator-jhipster#7308
ruddell · Mar 18, 2018 · 431304d · 431304d
1 parent 47bb50e
commit 431304d
Show file tree

Hide file tree

Showing 2 changed files with 25 additions and 2 deletions.
diff --git a/pages/tips.md b/pages/tips.md
@@ -6,7 +6,7 @@ redirect_from:
   - /tips.html
 sitemap:
     priority: 0.7
-    lastmod: 2017-04-27T08:40:00-00:00
+    lastmod: 2018-03-18T18:20:00-00:00
 ---
 
 # <i class="fa fa-cogs"></i> Tips'n tricks
@@ -29,4 +29,5 @@ _If you want to contribute, don't hesitate to send us a Pull Request with your t
 1. [Using Docker containers as localhost on Mac/Windows]({{ site.url }}/tips/020_tip_using_docker_containers_as_localhost_on_mac_and_windows.html)
 1. [Registering a user with additional information]({{ site.url }}/tips/022_tip_registering_user_with_additional_information.html)
 1. [Use QueryDSL]({{ site.url }}/tips/003_tip_add_querydsl_support.html)
-1. [Protecting Kibana with Apache (Basic Authentication)]({{ site.url }}/tips/023_tip_protecting_kibana_with_apache_basic_authent.html)
+1. [Protecting Kibana with Apache (Basic Authentication)]({{ site.url }}/tips/023_tip_protecting_kibana_with_apache_basic_authent.html)
+1. [Enabling Social Login with OAuth2]({{ site.url }}/tips/024_tip_enabling_social_login_with_oauth2.html)
diff --git a/tips/024_tip_enabling_social_login_with_oauth2.md b/tips/024_tip_enabling_social_login_with_oauth2.md
@@ -0,0 +1,22 @@
+---
+layout: default
+title: Enabling Social Login with OAuth2
+sitemap:
+priority: 0.1
+lastmod: 2018-03-18T18:20:00-00:00
+---
+# How to Enable Social Login with OAuth2
+
+When using the OAuth2 authentication type, your app connects to an OpenID Connect server such as Okta or Keycloak.  It's possible to enable social login by adding external identity providers within the admininistration console.
+
+## Adding an Identity Provider with Okta
+
+Okta supports Facebook, Microsoft, Google, LinkedIn, and Custom SAML providers.
+
+Log into the Okta console and navigate via the menu to "Users" -> "Social & Identity Providers".  Choose "Add Identity Provider" and add the provider of your choice.  Make sure to completely follow Okta's setup instructions which guide you in obtaining the client ID and secret for each provider.
+
+## Adding an Identity Provider with Keycloak
+
+Keycloak supports GitHub, Twitter, Facebook, Openshift, Google, Gitlab, LinkedIn, Microsoft, BitBucket, StackOverflow, and Custom SAML providers.
+
+Log into the Keycloak administration console and choose "Identity Providers" from the left menu.  Follow the instructions found in the [Keycloak Social Login documenation](http://www.keycloak.org/docs/3.0/server_admin/topics/identity-broker/social-login.html) to configure the provider and obtain the client ID and secret.