No description
Find a file
Marek Posolda 16184d1e9d Merge pull request #3029 from mposolda/master
KEYCLOAK-3281 OIDC 'state' parameter is url-encoded twice when respon…
2016-07-13 19:16:35 +02:00
adapters Return -1 from getDateHeader() when request is restored. 2016-07-12 16:28:45 +10:00
authz bump version 2016-06-30 17:17:53 -04:00
common bump version 2016-06-30 17:17:53 -04:00
core KEYCLOAK-3222 extend WellKnown to return supported types of client authentications. More tests 2016-07-08 15:39:13 +02:00
dependencies bump version 2016-06-30 17:17:53 -04:00
distribution Merge pull request #2982 from ahus1/jetty_9_3 2016-07-07 14:59:29 -04:00
examples [KEYCLOAK-3305] - Cache is not properly handling failures when importing configuration 2016-07-12 13:57:49 -03:00
federation bump version 2016-06-30 17:17:53 -04:00
integration bump version 2016-06-30 17:17:53 -04:00
misc Removed release process doc as it's now in a private document 2016-06-30 09:46:46 +02:00
model Merge pull request #3027 from pedroigor/KEYCLOAK-3305 2016-07-12 17:57:47 -03:00
proxy bump version 2016-06-30 17:17:53 -04:00
saml-core bump version 2016-06-30 17:17:53 -04:00
saml-core-api bump version 2016-06-30 17:17:53 -04:00
server-spi KEYCLOAK-3290 UserInfoEndpoint error responses don't have correct statuses 2016-07-08 12:15:07 +02:00
services KEYCLOAK-3281 OIDC 'state' parameter is url-encoded twice when responseMode=form_post 2016-07-13 18:07:57 +02:00
testsuite KEYCLOAK-3281 OIDC 'state' parameter is url-encoded twice when responseMode=form_post 2016-07-13 18:07:57 +02:00
themes KEYCLOAK-3143 Wrong field name in login theme message properties 2016-07-12 10:49:13 +02:00
util bump version 2016-06-30 17:17:53 -04:00
wildfly KEYCLOAK-3202 Creating users causes memory leak 2016-07-05 19:54:55 +02:00
.gitattributes
.gitignore
.travis.yml
License.html
pom.xml Add versions for Jetty 9.3 adapter dists 2016-07-08 08:21:03 +02:00
README.md Updated readme 2016-01-21 09:50:33 +01:00

Keycloak

Open Source Identity and Access Management for modern Applications and Services.

For more information about Keycloak visit Keycloak homepage and Keycloak blog.

Building

Ensure you have JDK 8 (or newer), Maven 3.2.1 (or newer) and Git installed

java -version
mvn -version
git --version

First clone the Keycloak repository:

git clone https://github.com/keycloak/keycloak.git
cd keycloak

To build Keycloak run:

mvn install

This will build all modules and run the testsuite.

To build the distribution run:

mvn install -Pdistribution

Once completed you will find distribution archives in distribution.

Starting Keycloak

To start Keycloak during development first build as specficied above, then run:

mvn -f testsuite/integration/pom.xml exec:java -Pkeycloak-server 

To start Keycloak from the appliance distribution first build the distribution it as specified above, then run:

tar xfz distribution/appliance-dist/target/keycloak-appliance-dist-all-<VERSION>.tar.gz
cd keycloak-appliance-dist-all-<VERSION>/keycloak
bin/standalone.sh

To stop the server press Ctrl + C.

Help and Documentation

  • Documentation - User Guide, Admin REST API and Javadocs
  • User Mailing List - Mailing list to ask for help and general questions about Keycloak
  • JIRA - Issue tracker for bugs and feature requests

Contributing

  • Developer documentation
    • Hacking on Keycloak - How to become a Keycloak contributor
    • Testsuite - Details about testsuite, but also how to quickly run Keycloak during development and a few test tools (OTP generation, LDAP server, Mail server)
    • Database Testing - How to do testing of Keycloak on different databases
    • Updating Database - How to change the Keycloak database
  • Developer Mailing List - Mailing list to discuss development of Keycloak

License