This is one of the modules that composes the EAR deployment defined in the "brother" module [keycloak-d4science-spi](../keycloak-d4science-spi-ear/README.md).
In order to configure the `Orchestrator`'s server endpoint URL it is sufficient to create a new client inside the `d4science` realm (or in the realm specified in the `target-orchestrator-realm` configuration) with id `conductor-server` and set-up the API URL in the `Home URL` field (e.g. https://conductor.dev.d4science.org/api/workflow/).
To perform authorized requests to the `orchestrator`, with an UMA token as `bearer`, a specific client with id `keycloak-server` has to be created in the same realm of the orchestrator client. This client should be configured to obtain an UMA ticket with audience: `conductor-server`.
Additionally, if the `Home URL` for this client is configured with a token endpoint URL, this will be used to obtain the UMA ticket, instead of the token URL of the Keycloak instance where the SPI is running.
Since version `2.24.0` it is possible to configure the SPI configurations with the following entries:
*`target-orchestrator-realm` - to specify in which realm looking for the the configured clients, overriding the default that is: `d4science`
*`include-realms` - to specify the interesting realms (default are: `d4science` and `master`)
*`exclude-realms` - to specify the non interesting realms
*`include-admin-types` - To specify the admin's `ResourceType`s to include (default are: `user`, `client` and `realm`)
*`exclude-admin-types`- To specify the admin's `ResourceType`s to exclude
*`include-events` - To specify the `EventType`s to include (default are: `register` and `delete_account`)
*`exclude-events` - To specify the `EventType`s to exclude
The prefix to add for the configuration is `spi-events-listener-orchestrator-event-publisher-` and f.e. to configure the interesting realms it is sufficient to use:
This can be achieved either by adding some lines to the `[keycloak-home]/conf/keycloak.conf` configuration file, by using the CLI parameters or using the ENV variables.
(Please, refer to the [Keycloak documentation section](https://www.keycloak.org/server/configuration) for further info)