CRP Gateway Docker Downloads

Docker Images, MySQL Database Scripts & WSL Setup

Navigation

Version 2.x Releases Version 1.x Releases

🚀 Version 2.2.4 (Latest)

Important: Version 2.x requires Java 21. NO legacy version v1.x support from this build.
Note: NO new SQL scripts for this version.
Download Release Notes

Harbor Registry (Private - Recommended):

docker image pull harbor.k8s.cashify.com.hk/crp-gateway/credit-reference-platform/crp-gateway/crp-gateway:production-2.2.4

Run Container:

docker run -d --name crp-gateway-2.2.4 -p 8080:8080 harbor.k8s.cashify.com.hk/crp-gateway/credit-reference-platform/crp-gateway/crp-gateway:production-2.2.4

Upgrade Steps

  • Refer to CRP Gateway Patching Guide v2.0 or above

Bug Fixes

  • Upgrade TU Converter to v1.6.1 to fix the incorrect handling on the spaces right before the end segment ES02**

Version 2.2.3

Download crp-gateway-2.2.3.jar Download Release Notes

Upgrade Steps

  • Refer to CRP Gateway Patching Guide v2.0 or above

New Features

  • Upgrade TU Converter to version 1.6.0 to support TUEF version 12

Bug Fixes

  • Missing ReturnCode Enum Entries
    • Added missing ReturnCode enum entries for complete error code coverage
    • Added Hire Purchase (HPL) codes: HPL00001 through HPL00018
    • Added Historical Message Enquiry (HME) codes: HME00001 through HME00003
    • Added Historical Message Resend (HMR) codes: HMR00001 through HMR00003
    • Added miscellaneous business notification, data listing, footprint listing, and other missing error codes
    • Total of 40+ new error codes added for comprehensive error handling
  • Error Log Messages
    • Fixed incorrect and duplicated error log messages in FileManagementApiController
    • Corrected error messages for message signing key regenerate, historical message enquiry, historical message resend, report enquiry, certificate upload, and certificate revoke operations
    • Error logs now accurately describe the actual operation being performed

Improvements

  • Session Expiration Handling
    • Fix issue where calling API with expired session causes raw 403 Forbidden error
    • Add session expiration detection and graceful handling in frontend
    • Show user-friendly alert message when session expires
    • Redirect to login page after session expiration alert
    • Improve user experience by providing clear guidance instead of error codes
  • Historical Message Enquiry Request UI Enhancement
    • Added informational remark to the Historical Message Enquiry Request form on the date range limits
  • License Management
    • Add license management features and UI updates

Version 2.2.2

Important: Version 2.x requires Java 21.
View on Docker Hub Download Docker Image (TAR) Download Release Notes

Docker Hub (Public Registry):

docker pull tphsad/crp:production-2.2.2 # Or use latest tag docker pull tphsad/crp:latest

Harbor Registry (Private - Recommended):

docker image pull harbor.k8s.cashify.com.hk/crp-gateway/credit-reference-platform/crp-gateway/crp-gateway:production-2.2.2

Run Container:

docker run -d --name crp-gateway-2.2.2 -p 8080:8080 harbor.k8s.cashify.com.hk/crp-gateway/credit-reference-platform/crp-gateway/crp-gateway:production-2.2.2

Upgrade Steps

  • Refer to CRP Gateway Patching Guide v2.0 or above

New Features

  • Support Multiple Active Encryption Certificates
    • Allow activation of more than one encryption certificate simultaneously
    • System will attempt to map the correct encryption certificate for message symmetric key decryption
    • If no matching certificate is found, system will return CER00001 error to CRP
    • Manual decryption in Account Management will iterate through all active encryption private keys
  • Certificate Pair Validation
    • Added validation to ensure uploaded private key and certificate are a correct pair
    • System will verify the cryptographic relationship between private key and certificate before activation

Bug Fixes

  • TU Converter Improvements
    • Updated TU converter to version 1.5.1 for better error message display
    • Fixed CSV file processing to trim spaces and detect empty lines
  • Empty File Decompression
    • Fixed issue where system would attempt to decompress empty files
    • Added validation to check if decrypted file is not empty before decompression
  • Error Message Handling
    • Improved error message storage and display for CRP errors
    • Enhanced error handling for Credit Report Enquiry and Data File Submission operations
    • Refactored error handling methods for better maintainability

Improvements

  • Certificate Management
    • Enhanced certificate comparison logic for better accuracy
    • Improved certificate activation and deactivation processes
    • Better error reporting for certificate-related operations
  • File Processing
    • Enhanced file validation and processing capabilities
    • Improved handling of various file formats and edge cases

Other Changes

  • Updated various module versions to maintain consistency across the codebase
  • Enhanced logging and error reporting throughout the system
  • Improved code maintainability and error handling patterns

Version 2.2.1

Important: Version 2.x requires Java 21.
View on Docker Hub Download Docker Image (TAR) Download Release Notes

Docker Hub (Public Registry):

docker pull tphsad/crp:production-2.2.1

Harbor Registry (Private - Recommended):

docker image pull harbor.k8s.cashify.com.hk/crp-gateway/credit-reference-platform/crp-gateway/crp-gateway:production-2.2.1

Run Container:

docker run -d --name crp-gateway-2.2.1 -p 8080:8080 harbor.k8s.cashify.com.hk/crp-gateway/credit-reference-platform/crp-gateway/crp-gateway:production-2.2.1

Upgrade Steps

  • Refer to CRP Gateway Patching Guide v2.0 or above

Bug Fixes

  • Reorder the items in the Name Segment (NA) for converting CSV to TUDF files
  • Fix the checking on signing secret for Built-in OAuth2 Service to accept secret longer than 32

Improvements

  • Accept UTF-8-BOM encoding for uploaded CSV conversion (TUDF / TUEF)

Version 2.1.4 (Combined Release 2.1.0-2.1.4)

Important: Version 2.x requires Java 21. This version combines all features and fixes from 2.1.0 through 2.1.4.
View on Docker Hub Download Docker Image (TAR) Download Release Notes Download MySQL Patches (Combined 2.1.0-2.1.4)

Docker Hub (Public Registry):

docker pull tphsad/crp:production-2.1.4

Harbor Registry (Private):

docker image pull harbor.k8s.cashify.com.hk/crp-gateway/credit-reference-platform/crp-gateway/crp-gateway:production-2.1.4

Run Container:

docker run -d --name crp-gateway-2.1.4 -p 8080:8080 tphsad/crp:production-2.1.4

New Features

  • Support Real-time Credit Report Enquiry for One Connect (LICENSE REQUIRED)
  • The feature is currently available for API triggered calls
  • Department Code is supported when making API calls for real-time credit report enquiry
  • Add Manual Decryption in Account Management

Bug Fixes

  • CRAOC Realtime Credit Report Enquiry
    • Return decrypted file for CRAOC realtime channel credit report enquiry in API response
    • Associate the enquiry chain to display the result in CRP Gateway Portal properly
    • Fix handling on the error response from CRAOC of type occra.rlt.cdrp.enqupl.fb.02 in JSON format
    • Fix incorrect signing secret used for submitting realtime credit report enquiry request
    • Fix incorrect value of occra_message.payload.app_header.trans.to in the message sending to CRAOC
  • File Management
    • Fix date related issues Certificate Upload Request and Report Enquiry
  • Fix Gateway Server Certificate and Encryption Certificate cannot be activated

Improvements

  • Display Error Message for Credit Report Enquiry History Detail
  • Disable the autocomplete in CRP Gateway for all password inputs

Other Changes

  • Extend the maximum length of Message Type from 20 to 50

📊 MySQL Database Scripts

Note: These MySQL scripts are required for database setup and upgrades. Apply them in the correct order based on your current version.
MySQL Scripts (Initial to v1.9.1) MySQL Patches v1.10.0 MySQL Patches v2.1.0 MySQL Configuration Email v1.9.7

MySQL in Docker:

docker run --name mysql-crp -e MYSQL_ROOT_PASSWORD=yourpassword -p 3306:3306 -d mysql:8.0 # Connect to MySQL container docker exec -it mysql-crp mysql -u root -p # Import SQL scripts docker exec -i mysql-crp mysql -u root -p your_database < your_script.sql

📦 Legacy Version Downloads

Download Docker Image v1.10.2 Download Current CRP Version
Note: Legacy versions (1.x) require Java 8. Consider upgrading to version 2.x for better performance and security.

📚 Additional Resources

Installation Guide v1.3 Patching Guide v1.5 Real-time Credit Report Enquiry Guide v1.0.2 Docker Compose File Dockerfile

Docker Compose Usage:

docker-compose up -d docker-compose logs -f docker-compose down