Cash Reserve Ratio Installation Guide
This document aims at explaining the installation procedures required to install the CBMB_CashReserveRatio cbmb-provider-iris.war package successfully in Temenos Transact.
System Requirements
The following are the pre-requisites for installing this package.
- Temenos Transact release 202007 and above.
- Web application server.
- JDK.
- WAR files for IRIS components.
General Considerations
When transferring the pack via FTP, the transport method must be set to binary.
Steps for Installing the Package
Follow the steps bellow to install the package.

For building the cbmb-provider-iris.war and generating the war file, perform the steps below.
- Uncomment the t24.security.context property in the jms.properties file available in the war file.
- Comment the below mentioned line applicationContext.xml.
- Download the token generator war file from repository. The war can be downloaded from the following link. http://maven.temenosgroup.com/content/groups/temenos/com/temenos/irf/irf-auth-token-generation-container/DEV.0.0-SNAPSHOT/
- Deploy the war file in the Temenos > jboss >standalone > deployments folder in UTP.

The installation steps are described below.
- Deploy the IRIS war in jboss, cbmb-provider-iris.war: \jboss\standalone\deployments.

A default private key is already present in the irf-auth-token-generation-container -<version>.war.
temenos_iris.jks is the key store file and the properties are mentioned in keystore.properties file.
- Inside the war file, under the WEB-INF > Classes be found the keystore.properties and temenos_iris.jks files.
- The content of the keystore.properties file is as per below.
- Place the keystore file in a local path and run the below command in command prompt to get the .cer file, to validate this generated JWT token signature.
keytool -export -keystore temenos_iris.jks -alias temenos -file temenos_iris.cer
The default password setup for the file is temenos123. - The certificate is generated in the local path.

- In the .war\WEB-INF\web.xml file uncomment the below lines under inside the <context-param> if they are commented already.
- Enable Spring security filter. IRIS web application gets enabled with Spring security filter chains by configuring respective tags in the web.xml of IRIS application. Uncomment the below springSecurityFilterChain. By default, this is disabled.
- Add the required claim values in the spring-jwt-iris-authenticator file inside the .war\WEB-INF\classes\, as per below.
- In the in spring-jwt-iris-authenticator file, Issuer refers to value in 'iss' in the generated JWT token and pkCertFilePath refers to the public key certificate path in the local directory.
- Use the GET method to generate security token in Postman. The URL for the GET method is: http://localhost:9089/irf-auth-token-generation-container-DEV.0.0-20220512.093018-1026/api/v1.0.0/generateauthtoken
- Once the above steps are done, redeploy the container war in the jboss deployments

- Use the GET method to generate security token in Postman. The URL for the GET method is: http://localhost:9089/irf-auth-token-generation-container-DEV.0.0-20220512.093018-1026/api/v1.0.0/generateauthtoken
- Place this token under authorisation of postman while hitting the request through Postman.
- Create the cash balance in deposit capture by using the POST method. The URL for the POST method is: http://localhost:9089/cbmb-provider-iris/api/v1.0.0/holdings/cashBalances
- A body example is provided below.
- The Postman response is displayed below.
- Update the cash balance in deposit capture by using the PUT method. The URL for the PUT method is: http://localhost:9089/cbmb-provider-iris/api/v1.0.0/holdings/cashBalances/GB72DEMO60161300100037.03.2021.10
- A body example is provided below.
- The Postman response is displayed below.
- Retrieve the list of banks for which the deposit balances has not been provided for a given period by using the GET method. The URL for the cash balances API GET method is: http://localhost:9089/cbmb-provider-iris/api/v1.0.0/holdings/cashBalances/03.2021
- The Postman response is displayed below.
- Fetch the outstanding cash balance in deposit capture by using GET method. The URL for the GET method is: http://localhost:9089/cbmb-provider-iris/api/v1.0.0/holdings/cashBalances/outstandings/03.2021
- The Postman response is displayed below.
API Details
The API details are provided below.
API |
API functionality |
---|---|
GET API |
API to retrieve the list of cash reserve maintained by the financial institutions with the central bank for a given period. |
GET API |
API to retrieve the list of banks for which the deposit balances have not been provided to the central bank for a given period. |
The provider URL's are given below.
API | URI |
---|---|
GET API | http://<hostname>:<jboss_port>/<iris_war>/api/v1.0.0/holdings/cashBalances/{calendarPeriod} |
GET API | http://<hostname>:<jboss_port>/<iris_war>/api/v1.0.0/holdings/cashBalances/outstandings/{calendarPeriod} |
Samples of the API's are provided below.
- GET API: http://localhost:9089/cbmb-provider-iris/api/v1.0.0/holdings/cashBalances/03.2021
- GET API: http://localhost:9089/cbmb-provider-iris/api/v1.0.0/holdings/cashBalances/outstandings/03.2021
In this topic