diff --git a/IUA-Simulator/installation.md b/IUA-Simulator/installation.md
index 59d294e9f5af2b6440a5213f9d36f6870240a1b6..9bfab425c64de4f58ea40b1f9991152e65734cba 100644
--- a/IUA-Simulator/installation.md
+++ b/IUA-Simulator/installation.md
@@ -4,7 +4,7 @@ subtitle: IUA Simulator
 author: Pierre-Marie VAN HOUTEGHEM, CLaude LUSSEAU
 function: Software Engineer
 date: 2023-04-05
-toolversion: 1.0.0
+toolversion: 1.0.2
 version: 1.00
 status: To be reviewed
 reference: KER1-MAN-IHE-IUA-SIMULATOR_INSTALLATION-1\_01
@@ -38,3 +38,30 @@ Once the application is deployed, open a browser and go to http://yourserver/iua
 If the deployment is successful, you should receive a 200 Ok Response.
 
 The sources of the projects are available on [Inria's gitlab](https://gitlab.inria.fr/gazelle/public/simulation/iua-simulator.git).
+
+## Keycloak Configuration
+
+In order to use IUA at full capacity, a few things have to be configurated inside keycloak by hand.
+
+### Create a client  
+
+Access Keycloak through the Admin interface by going at http://yourserver/iua-sso
+On the top left select the realm in which you wish to create your client.
+Go to the clients menu and press "Create Client"
+
+On the first page, verify the value of client type is "OpenID Connect" and put the client id of your new client.
+On the next page, turn on the Client Authentication switch, then check "Standard flow", "Direct access grants" and "service accounts roles".
+On the last page, add the url of the client, and their redirect and logout redirects uris. You can then click save.
+
+Don't forget to retrieve the client authenticator and client secret for your requests. 
+
+### Dynamic scopes for CH scopes
+
+By default starting from version 1.0.2, Keycloak handles the dynamic variabilty of a few scopes sent in the ITI transactions.
+But they need to be added by hand for each client that uses them.
+
+For this, go to the keycloak admin interface, then go the CH IUA realm. 
+Find your client in the clients list, select it and go to the Client scopes tab.
+In this tab, press "Add client scope". A popup appears where you can select every item. Then press Add then Optional. 
+
+Now your client is ready to recieve dynamic scopes and put them in its access token.
\ No newline at end of file
diff --git a/IUA-Simulator/release-note.md b/IUA-Simulator/release-note.md
index f2b624a32f8d6d919ced7ef48da2b4c26a4807cc..f10d06de3b7ab909a20a04fccb76afb696375a51 100644
--- a/IUA-Simulator/release-note.md
+++ b/IUA-Simulator/release-note.md
@@ -1,7 +1,7 @@
 ---
 title: Release note
 subtitle: IUA Simulator
-toolversion: 1.0.0
+toolversion: 1.0.2
 releasedate: 2023-04-20
 author: Pierre-Marie VAN HOUTEGHEM, Claude LUSSEAU
 function: Software Engineer
diff --git a/IUA-Simulator/user.md b/IUA-Simulator/user.md
index 38652144dbf7a1a3126ece4bfd3fb81be8f52da1..1768fde7fa5127c5d755983a7604232b229edeea 100644
--- a/IUA-Simulator/user.md
+++ b/IUA-Simulator/user.md
@@ -3,7 +3,7 @@ title: User Manual
 subtitle: IUA Simulator
 author: Pierre-Marie VAN HOUTEGHEM, Claude LUSSEAU
 releasedate: 2023-04-20
-toolversion: 1.0.0
+toolversion: 1.0.2
 function: Software Engineer
 version: 1.00
 status: To be reviewed