keycloak-d4science-spi-parent/keycloak-d4science-theme
Vincenzo Cestone 6f9a664121 Fixed d4science.v2 account theme: index.ftl updated for KC v22.0.5 2023-11-06 17:31:38 +01:00
..
src/main/resources Fixed d4science.v2 account theme: index.ftl updated for KC v22.0.5 2023-11-06 17:31:38 +01:00
util Updates for Keycloak v16: updated D4Science themes and implemented D4Science.v2 account extra page 2022-02-16 10:09:31 +01:00
CHANGELOG.md Prepating for 2.2.0-SNAPSHOT release with `maven-parent-1.2.0`, `keycloak-parent-22.0.4` and switch to JDK17 2023-10-09 17:10:28 +02:00
FUNDING.md Ready to be inlcuded in parent when theme will moved from its own repo 2020-09-04 18:08:50 +02:00
LICENSE.md Ready to be inlcuded in parent when theme will moved from its own repo 2020-09-04 18:08:50 +02:00
README.md Deprecated/removed for build the Wildfly/JEE EAR artifact and updated the docs for the Quarkus based deploy and both Wildfly (deprecated) and Quarkus related configs 2022-11-02 13:32:39 +01:00
pom.xml Skipping javadoc creation in all the sub-modules to avoid Jenkins build issue 2023-10-13 16:54:02 +02:00

README.md

Keycloak D4Science Themes

Keycloak D4Science Themes module collects the implementations of base D4Science theme and a set of specific per gateway themes implementations.

Each Keycloak theme is made of a set of Freemarker templates. Themes of Keycloak account section is implemented in React.

Structure of the project

The themes are in src/main/resources/themes subfolder. The util subfolder contains some utility test scripts to create Keycloak clients that uses a specific theme.

Built With

Documentation

This is one of the modules that composes the EAR deployment defined in the "brother" module keycloak-d4science-spi.

To build the module JAR file it is sufficient to type

mvn clean package

Installation

Qurkus based Keycloak

In order to deploy the module it is sufficient to copy into the [keycloak-home]/providers folder.

Development

For details see Theme section of Keycloak developer docs.

As specified in Deploying Themes section of the documentation, themes can be deployed to Keycloak by copying the theme directory to themes or it can be deployed as an archive.

In the development phase, we suggest to disable themes caching in Keycloak configuration file. To do this edit standalone.xml. For theme set staticMaxAge to -1 and both cacheTemplates and cacheThemes to false.

To test theme in a Keycloak instance you can clone this repo somewhere and create a symbolic link for each theme you want to deploy, eg:

mkdir /opt/git
cd /opt/git
git clone https://code-repo.d4science.org/gCubeSystem/keycloak-d4science-spi-parent.git

cd /opt/keycloak/themes
ln -s /opt/git/keycloak-d4science-spi-parent/keycloak-d4science-theme/src/main/resources/theme/d4science/
ln -s /opt/git/keycloak-d4science-spi-parent/keycloak-d4science-theme/src/main/resources/theme/d4science.v2/

ln -s /opt/git/keycloak-d4science-spi-parent/keycloak-d4science-theme/src/main/resources/theme/dev4.d4science.org/
...

Note: d4science and d4science.v2 are the base D4Science themes, that are required by all \*.d4science.org per gateway specific themes.

If you are already logged-in in Keycloak administration console you have to logout and then re-login. At that you can set one of the new themes per Keycloak Realm or for a specific Keycloak Client in the realm.

Change log

See CHANGELOG.md file for details

See Releases.

Authors

License

This project is licensed under the EUPL V.1.1 License - see the LICENSE.md file for details.

About the gCube Framework

This software is part of the gCubeFramework: an open-source software toolkit used for building and operating Hybrid Data Infrastructures enabling the dynamic deployment of Virtual Research Environments by favouring the realisation of reuse oriented policies.

The projects leading to this software have received funding from a series of European Union programmes including:

  • the Sixth Framework Programme for Research and Technological Development
    • DILIGENT (grant no. 004260);
  • the Seventh Framework Programme for research, technological development and demonstration
    • D4Science (grant no. 212488), D4Science-II (grant no.239019), ENVRI (grant no. 283465), EUBrazilOpenBio (grant no. 288754), iMarine(grant no. 283644);
  • the H2020 research and innovation programme
    • BlueBRIDGE (grant no. 675680), EGIEngage (grant no. 654142), ENVRIplus (grant no. 654182), Parthenos (grant no. 654119), SoBigData (grant no. 654024),DESIRA (grant no. 818194), ARIADNEplus (grant no. 823914), RISIS2 (grant no. 824091), PerformFish (grant no. 727610), AGINFRAplus (grant no. 731001);