keycloak/docs/documentation
little-pinecone 783cf00f3e Add example for mapping role names between Keycloak and Spring Boot
* use SimpleAuthorityMapper as an example mapper
* show how to convert role names to upper case
* document that the default prefix for that mapper maps role names properly

Closes #19535
2023-04-05 11:04:54 -03:00
..
.github/workflows Integrate documentation into parent build 2023-03-20 13:09:23 +01:00
aggregation Run tests for the moved documentation (#19278) 2023-03-28 12:35:27 +02:00
api_documentation Run tests for the moved documentation (#19278) 2023-03-28 12:35:27 +02:00
authorization_services Run tests for the moved documentation (#19278) 2023-03-28 12:35:27 +02:00
dist Run tests for the moved documentation (#19278) 2023-03-28 12:35:27 +02:00
header-maven-plugin Moving docs to new folder 2023-03-20 09:07:58 +01:00
internal_resources Moving docs to new folder 2023-03-20 09:07:58 +01:00
release_notes Remove legacy Promise APIs from Keycloak JS (#19389) 2023-03-29 16:29:27 +00:00
securing_apps Add example for mapping role names between Keycloak and Spring Boot 2023-04-05 11:04:54 -03:00
server_admin Incorrect documentation around password policies (#19364) 2023-03-29 10:09:40 +02:00
server_development Add nashorn javascript engine to Keycloak server 2023-04-04 14:56:46 +02:00
tests Run tests for the moved documentation (#19278) 2023-03-28 12:35:27 +02:00
topics/templates Moving docs to new folder 2023-03-20 09:07:58 +01:00
upgrading Add nashorn javascript engine to Keycloak server 2023-04-04 14:56:46 +02:00
.asciidoctorconfig Moving docs to new folder 2023-03-20 09:07:58 +01:00
.gitattributes Moving docs to new folder 2023-03-20 09:07:58 +01:00
.gitignore Moving docs to new folder 2023-03-20 09:07:58 +01:00
.vale.ini Moving docs to new folder 2023-03-20 09:07:58 +01:00
License.html Moving docs to new folder 2023-03-20 09:07:58 +01:00
README.md Run tests for the moved documentation (#19278) 2023-03-28 12:35:27 +02:00
build-auto.sh Moving docs to new folder 2023-03-20 09:07:58 +01:00
get-version.sh Moving docs to new folder 2023-03-20 09:07:58 +01:00
pom.xml Run tests for the moved documentation (#19278) 2023-03-28 12:35:27 +02:00
release-details Moving docs to new folder 2023-03-20 09:07:58 +01:00
set-version.sh Moving docs to new folder 2023-03-20 09:07:58 +01:00
sync.sh Moving docs to new folder 2023-03-20 09:07:58 +01:00

README.md

Keycloak Documentation

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

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

Contributing to Keycloak Documentation

See our Contributor's Guide. The directory also includes a set of templates and other resources to help you get started.

If you want to file a bug report or tell us about any other issue with this documentation, you are invited to please use our issue tracker.

Building Keycloak Documentation

Ensure that you have Maven installed.

First, clone the Keycloak repository:

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

If you are using Windows, you need to run the following command with administrator privilege because this project uses symbolic links:

git clone -c core.symlinks=true https://github.com/keycloak/keycloak.git

To build Keycloak Documentation run:

mvn clean install -am -pl docs/documentation/dist -Pdocumentation

Or to build a specific guide run:

mvn clean install -pl doc/documentation/GUIDE_DIR -Pdocumentation

By default, an archive version of the documentation is built. To build the latest build run:

mvn clean install ... -Platest,documentation

You can then view the documentation by opening doc/documentation/GUIDE_DIR/target/generated-docs/index.html.

License