Issues with Local MOSIP Compliance Toolkit Setup

Support
1

I have installed the MOSIP Compliance Toolkit locally.(v1.4.2)

On my test PC, I deployed mosip-infra V3 (version 1.2.0.2) using RKE.
The following components have been installed:

  • conf-secrets
  • config-server
  • artifactory
  • keymanager
  • mock-smtp
  • kernel
  • masterdata-loader
  • biosdk
  • pms

I’m currently facing the following three issues and need assistance resolving them:

1. Keycloak Initialization Error

While executing keycloak-init.sh for the Compliance Toolkit, an error occurred related to the provider "recaptcha-u-p-form".
To bypass this, I removed the authentication_flows section from the keycloak-init-values.yaml file.

2. Login Page Issue

The login screen of the locally deployed Compliance Toolkit looks different from the one at https://compliance.synergy.mosip.net.
Specifically, the “Register User” option is missing.
As a workaround, I manually created a user directly in Keycloak.

image
image543×409 10.2 KB

3. Missing Template Error After Login

After logging in to the toolkit, I see the following error:
ERROR - Template not found. Upload template and try again!
I followed the instructions in the official documentation under
“Steps to upload terms and conditions velocity templates to the Database”,
but an error still occurs during the upload process.

2

Hi @wjyang,

Thank you for reaching out to us, our team is checking on your issue. Will revert back to you on the same

Regards,
Varaniya
Team MOSIP

3

Hi @wjyang

1 & 3. Do follow 1.4.0 | Compliance Tool Kit
2. In keycloak, you will have to enable “user registration” option under the realm. After that you will get Register User option in the UI.

Hope this helps.
~ Mayura

4

Hi @Varaniya1 @mayuradesh,

Thank you for your responses to my question.

I realized that the version of the Compliance Toolkit I installed was 1.4.1, not 1.4.2.
Sorry for the confusion.

1. Keycloak Initialization Error

image
image1472×688 128 KB

@Varaniya1,
You mentioned:

“1 & 3. Do follow 1.4.0 | Compliance Tool Kit”

However, I couldn’t find any reference to "recaptcha-u-p-form" in the 1.4.0 documentation or configuration.

Did you mean that I should use version 1.4.0 of the Compliance Toolkit instead of 1.4.1?

Thanks in advance!

5

image
image1111×576 95.3 KB

6

image
image1059×189 35.9 KB

7

Hi @wjyang

Same CTK setup steps documentation as 1.4.0 applies to 1.4.1 and 1.4.2 as well. So you can try with any of these.
This documentation will not include keycloak setup and hence no reference to “recaptcha-u-p-form” is there in this documentation.

Which image are you running with toolkit-keycloak-init job?
It should be mosipid/keycloak-init:1.2.0.1

8

hi @mayuradesh

I used the following keycloak-init.sh script:

If I used the wrong file, I would appreciate it if you could share the correct link.

2. Login Page Issue

image
image567×539 20.1 KB

I confirmed that the Register option appeared after applying the following configuration.
Thank you.

9

image
image486×428 7.05 KB

10

Hi @wjyang

Can you ensure that mosip-toolkit-client is created in the realm? You can create it manually too.

image
image1920×831 105 KB

In case you are getting errors with the script.
Hope this helps.

11

hi @mayuradesh

1. Keycloak Initialization Error

I was able to run keycloak-init.sh and confirm that the Compliance Toolkit is working by removing the authentication_flows section from the keycloak-init-values.yaml file.

The reason I raised this issue is because the script refers to the "recaptcha-u-p-form" flow, which I assumed requires the recaptcha provider under Create Authenticator Execution > provider in Keycloak. However, I couldn’t find the recaptcha provider in my Keycloak installation.

If the Compliance Toolkit works fine without the recaptcha provider, I think I can proceed with testing as is.

Additionally, regarding 3. Missing Template Error After Login, I was able to verify that it works correctly by following these steps:
– Add a user role
– Log in with that user in the Compliance Toolkit UI
– Follow the instructions in “Steps to upload terms and conditions velocity templates to the Database”

image
image329×184 8.22 KB

12

Happy to hear this @wjyang.

I hope you are able to now work with CTK.