Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 7 Next »

General Pre-requisites

Hardware

  1. Workstation: Windows 10 laptop or desktop with min. 8 GB RAM and about 50 GB free space on the hard disk

  2. The workstation should be TPM 2.0 enabled. This URL (click here) will guide you with the sequence of steps to check if your workstation is TPM enabled.

It is important that your workstation is TPM 2.0 enabled and not with any older version of TPM. If your workstation has an older version of TPM, like TPM 1.2, then you may have to upgrade your BIOS firmware to upgrade to TPM 2.0. You should contact your vendor in this respect if you are not aware on how to do this.

Software

  • Mock MDS - This will simulate biometric capture if you do not have real biometric devices with you. https://github.com/mosip/mosip-mock-services

  • TPM Utility - This is used for registering the workstation on which registration client would be executed.

zip archive

  • JAVA - JAVA 11 installed and JAVA_HOME is in the PATH

Provide the workstation details

text file

  1. Download and extract TPM utility as explained in README.txt from command prompt

  2. Download the files machine.csv and fill in the details. Replace the variables in <> angle brackets with the actual value.

  3. Send the files machine.csv with your MOSIP contact.

  4. Your MOSIP contact will register your workstation on the designated MOSIP server and communicate the credentials for logging into the registration client back to you.

Running Mock MDS

  1. Download and extract the Mock MDS zip provided

  2. Certificates need to placed in Biomatric Devices>Face>keys Biomatric Devices>Finger>key Biomatric Devices>Iris>keys The certificates need to be placed in the certificate paths as highlighted in the mock MDS

  3. Update the application.property file as below after placing the certificates Need to change with your details in highlighted part

  4. Build the Mock MDS in command prompt in the same directory where the pom file exists (run“mvn clean install” )

  5. After building Mock Mds Target Folder will be created in same directory

  6. Open Target folder and execute run.bat (double click)

  7. By default the Purpose will be set for Registration and the Biometric Type will be set to Biometric Device also the device discovery port by default will be 4501. To change the Purpose or Biometric Type edit the run.bat file in a notepad.

    You can set the Purpose as “Registration” or “Auth” (For reg-client purpose will be Registration)

    If you set Biometric Type to Biometric Device, All the devices will be displayed during device discovery if you want to set it to a specific device type you can set from the following options.

    Biometric Device

    Finger

    Face

    Iris

  8. Mock MDS will starting running and starting listening on a port between 4501 and 4600.

  9. If run successfully, you would see the following output

Ensure that Mock MDS is always running whenever you are running the registration client

  1. If need to add own biometrics, open-Profile folder>add new folder with own biometrics

  2. while running mock mds use API to change Biometrics folder Post method URI: http://127.0.0.1:4501/admin/profile Request: { "type": "Biometric Device", //it can be Biometric device, Face, Iris or Finger "profileId": "Name" //Name given to Biometric folder }

Setting up the Registration Client  

  1. Download the registration client from  https://extint1.mosip.net/registration-client/1.1.5.5-SNAPSHOT/reg-client.zip (reg-client has to be installed in the D drive because packet creation needs some settings which is sometimes not there in C drive.) Set an environment system variable 'mosip.hostname' with value as <mosip server URL>. For example

    • mosip.hostname = extint1.mosip.net

  2. Extract the registration client zip file and click on run.bat. Make sure that you have JAVA in your path.

  3. Login with the credentials provided to you

Reg-Client : Registration steps

  1. Login using credentials

  2. Click on Synchronize Data

  3. Click on New Registration

  4. Enter demographics details

  5. Click on continue

  6. Upload documents - Address Proof and Identify Proof mandatory then scan,capture and save

  7. Click on continue

  8. Add Biometric details by scanning

  9. Click on continue

  10. Click on Agree and continue

  11. Provide password and continue

  12. Navigate to Home

  13. Click on pending Approval, Approve and Authenticate by providing credentials

  14. In Home - click on Registration Data Upload

  15. Select packet and Click Upload

  16. After upload check for RID in D-drive where packet folder will be created and inside folder packet will be there with a Name same as RID. (Packet folder will be generated in D drive or place where reg-client installed)

  17. Authenticate Post method:- https://extint1.mosip.net/v1/authmanager/authenticate/clientidsecretkey request:- {   "id": "string",   "metadata": {},   "request": {     "appId": "regproc",     "clientId": "mosip-regproc-client",     "secretKey": "abc123"   },   "requesttime": "2020-12-09T04:45:46.079Z",   "version": "string" }

  18. Add RID in URI Get method:- https://extint1.mosip.net/idrepository/v1/identity/idvid/{{RID}}?type=All Find UIN in Response

  • No labels