# Steps to set up ABIS for testing

A partner can test their biometric ABIS’s with MOSIP’s Compliance Toolkit. In this document, we have provided the steps that can be followed by the partner to enable the ABIS testing.

The diagram below illustrates the CTK deployment architecture.

![](https://168731645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOrxzFOqLUpvxyg8Kvdlg%2Fuploads%2Fgit-blob-f992d333829952e3afeb5ad26a10d45d1b1658fd%2Fctk-deployment-architecture-abis.png?alt=media)

## Test using a Mock ABIS

Below is a quick demonstration followed by steps to set up ABIS for testing.

{% embed url="<https://www.youtube.com/watch?v=dAeQ_YdTfzE>" %}

* Checkout MOSIP’s Mock Services from `https://github.com/mosip/mosip-mock-services`. Make sure to checkout the code from **develop** branch.
* Go to `REPO_ROOT/mock-abis`.
* For setting ABIS queue configuration, follow the steps below:

  * Step 1: Create `registration-processor-abis.json` in the resources folder with the below details.

  ```
  {
      "abis": [{
      "name": "ABIS",
      "host": "",
      "port": "",
      "brokerUrl": "tcp://activemq.${env}.mosip.net:61616",
      "inboundQueueName": "ctk-to-abis",
      "outboundQueueName": "abis-to-ctk",
      "pingInboundQueueName": "ctk-to-abis",
      "pingOutboundQueueName": "abis-to-ctk",
      "userName": "artemis",
      "password": "XXXXXXX",
      "typeOfQueue": "ACTIVEMQ",
      "inboundMessageTTL": 2700
      }]
  }
  ```

  * Step 2: Update the following details in `application-local.properties`.

  ```
  secret_url=https://api-internal.${env}.mosip.net/v1/authmanager/authenticate/clientidsecretkey
  local.development=true
  abis.bio.encryption=false
  ```

  * Step 3: Update the following details in `config.properties`.

  ```
  secret_url=https://api-internal.${env}.mosip.net/v1/authmanager/authenticate/clientidsecretkey
  secret_url.clientnId=mosip-regproc-client
  secret_url.id=string
  secret_url.secretKey=XXXXXXXXXXX
  secret_url.appId=regproc
  secret_url.requesttime=2023-03-27T06:12:52.994Z
  secret_url.version=string

  analytics.confidence=90
  analytics.internalscore=112
  analytics.key1=value1
  analytics.key2=value2
  ```

  * Step 4: Build the code with the command `mvn clean install -Dmaven.test.skip=true -Dgpg.skip=true`.
* If you are testing with newer queues, then you need to first create them manually in `active mq` console.

```
Create Address > ctk-to-abis >  anycast > save
Create Address > abis-to-ctk >  anycast > save
```

* After build is successful, place your ABIS jar in the `\mock-abis` folder
* create a bat file to run `mock ABIS`.

```
    cd <LOCAL_PATH>\mock-abis
    java -jar -Dlocal.development=true -Dabis.bio.encryption=true -Dspring.profiles.active=local -Dmosip_host=https://$   {env}.mosip.net target/mockabis.jar
```

Here `LOCAL_PATH` is the installation folder path for the mosip-mock-service.

* Once the mock ABIS service is running, check if the JAR is working using the Swagger available at URL: `http://localhost:8081/v1/mock-abis-service/swagger-ui.html`
* In CTK ,for the ABIS project configure the below details:

```
"Url": "wss://activemq.${env}.mosip.net/ws",
"RequestQueueName": "ctk-to-abis",
"ResponseQueueName": "abis-to-ctk",
"userName": "artemis",
"password": "XXXXXX"
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mosip.io/compliance-tool-kit/how-to-guides/abis-testing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.