A PAS plugin to set roles to imio keycloak users
Kimug is a acronym for "Keycloak IMio User & Group"
Full documentation, with architecture and authentication-flow diagrams, is in docs/kimug.md.
Requires uv. This installs Plone 6.2.3 in .venv
(use PLONE_VERSION=6.1.6 make install for another version):
make installmake create-siteYou have to initialize a certificate with tests/mkcert.sh .
make docker-startThis command will start a keycloak instance available at https://keycloak.127.0.0.1.nip.io
| Realm | login | password | |
|---|---|---|---|
| master | admin | admin | |
| imio | kimug | kimug_at_imio.be | kimug |
| plone | plone | plone_at_imio.be | plone |
| sso-apps | imio-apps-plone_belleville-ac | imio-apps_at_kimug.be | Kimug123456*** |
cd tests
docker compose exec keycloak /opt/keycloak/bin/kc.sh export --file /opt/keycloak/data/import/realm-imio.json --realm imio
docker compose exec keycloak /opt/keycloak/bin/kc.sh export --file /opt/keycloak/data/import/realm-plone.json --realm plone
docker compose exec keycloak /opt/keycloak/bin/kc.sh export --file /opt/keycloak/data/import/realm-sso-apps.json --realm sso-appsTests start Keycloak themselves through Docker (pytest-docker).
.venv/bin/pytest tests -sor only one class
.venv/bin/pytest tests -s -k TestMigrationThrough tox, as the CI does (make test-all runs every Plone / Python combination):
make test
uvx --with tox-uv tox -e py312-plone61make checkThe project is licensed under GPLv2.