No description
24f765ceef
* upstream_master: (115 commits) KEYCLOAK-1964 Database field for passwordPolicy is too small KEYCLOAK-1971 REST end point does't validate password policies properly KEYCLOAK-2104 Add caching of message bundles and properties to ExtendingThemeManager KEYCLOAK-2116 - Fix Label of Regenerate Secret button. Tweak Travis again KEYCLOAK-1937 OpenID Connect Dynamic Client Registration fix null pointer remove empty password check in direct grant flow Updated Travis configuration Exclude .lastUpdated files from Travis cache KEYCLOAK-2119 OTP Policy form validates both TOTP and HOTP at the same time [KEYCLOAK-2119] OTP Policy form validates both TOTP and HOTP at the same time KEYCLOAK-2010 remove empty password check default groups ui KEYCLOAK-1749 Add documentation and fixed clean-up of expired initial access tokens Remove unused import Fix missing group in angular $scope in GroupMembersCtrl. arquillian-testsuite: Customizable waiting timeouts in class WaitUtils. Changed time unit to MILLISECONDS. default groups ... |
||
---|---|---|
broker | ||
client-registration | ||
common | ||
connections | ||
core | ||
dependencies | ||
distribution | ||
docbook | ||
events | ||
examples | ||
export-import | ||
federation | ||
forms | ||
integration | ||
misc | ||
model | ||
proxy | ||
saml | ||
services | ||
social | ||
testsuite | ||
timer | ||
util | ||
.gitattributes | ||
.gitignore | ||
.travis.yml | ||
License.html | ||
pom.xml | ||
README.md |
Keycloak
Keycloak is an SSO Service for web apps and REST services. For more information visit http://keycloak.org.
Building
Ensure you have JDK 7 (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
.
Contributing
Documentation
- User Guide, Admin REST API and Javadocs
- 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
- Release Process - how to release Keycloak