Added instructions to configuring social providers
This commit is contained in:
parent
fff0f82294
commit
a4ba63b3d2
1 changed files with 52 additions and 0 deletions
52
social/README.md
Normal file
52
social/README.md
Normal file
|
@ -0,0 +1,52 @@
|
||||||
|
Keycloak social
|
||||||
|
===============
|
||||||
|
|
||||||
|
This document describes how to configure social providers for Keycloak. At the moment social providers are configured globally using system properties. These can either be passed using '-D' when starting the application server or added to the standalone.xml file, for example:
|
||||||
|
|
||||||
|
<system-properties>
|
||||||
|
<property name="keycloak.social.facebook.key" value="<facebook key>"/>
|
||||||
|
<property name="keycloak.social.facebook.secret" value="<facebook secret>"/>
|
||||||
|
<property name="keycloak.social.google.key" value="<google key>"/>
|
||||||
|
<property name="keycloak.social.google.secret" value="<google secret>"/>
|
||||||
|
<property name="keycloak.social.twitter.key" value="<twitter key>"/>
|
||||||
|
<property name="keycloak.social.twitter.secret" value="<twitter secret>"/>
|
||||||
|
</system-properties>
|
||||||
|
|
||||||
|
Social provides implementations for Facebook, Google and Twitter.
|
||||||
|
|
||||||
|
|
||||||
|
Configure Facebook
|
||||||
|
------------------
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Configure Google
|
||||||
|
----------------
|
||||||
|
|
||||||
|
Open https://code.google.com/apis/console/. From the drop-down menu select Create.
|
||||||
|
|
||||||
|
Use any name that you'd like, click Create Project, select API Access and click on Create an OAuth 2.0 client ID.
|
||||||
|
|
||||||
|
Use any product name you'd like and leave the other fields empty, then click Next. On the next page select Web application as the application type. Click more options next> to Your site or hostname. Fill in the form with the following values:
|
||||||
|
|
||||||
|
* Authorized Redirect URIs: http://<HOSTNAME>[<PORT>]/auth-server/rest/realms/<REALM>/social/callback
|
||||||
|
|
||||||
|
Click on Create client ID. Use the value of Client ID as the value of the system property "keycloak.social.google.key", and the value of Client secret as the value of "keycloak.social.google.secret".
|
||||||
|
|
||||||
|
|
||||||
|
Configure Twitter
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
Open https://dev.twitter.com/apps. Click on Create a new application.
|
||||||
|
|
||||||
|
Fill in name, description and website. For Callback URL use the following value:
|
||||||
|
|
||||||
|
Callback URL: http://mbaas-stianst.rhcloud.com/ejs-identity/api/callback/516131bc-e3e4-4736-928b-cf1df8c0fe74
|
||||||
|
Note: Twitter doesn't allow localhost as domain, use 127.0.0.1 instead!
|
||||||
|
|
||||||
|
Agree to the rules, fill in the captcha and click on Create your Twitter application.
|
||||||
|
|
||||||
|
Now click on Settings and tick the box Allow this application to be used to Sign in with Twitter, and click on Update this Twitter application's settings.
|
||||||
|
|
||||||
|
Finally click on Details. Use the value of Client key as the value of the system property "keycloak.social.twitter.key", and the value of Client secret as the value of "keycloak.social.twitter.secret".
|
Loading…
Reference in a new issue