ID-Auth demo application setup guide
Part -1 To configure and build the partner management tool
Step 1:
Download the zip file of the Partner-management tool using the link given below
note: download the appropriate branch needed(Here used is 1.2.0).
https://github.com/mosip/gist/tree/1.2.0
Step 2:
Unzip and through the path → gist-1.2.0\partnermanagement\src\main\resources
...
5. Now Build the tool using the command given below and refer the picture for the build path.
mvn clean install -Dgpg.skip=true -Dmaven.test.skip=true
...
6. After the successful build, A target folder is been generated.
Now run the jar using the command given below and refer the picture for the path.
java -jar partnermanagement-0.0.1-SNAPSHOT.jar
...
7. By running the jar, the below swagger url will be accessible to create the partner.
...
Part-2 To Create Authentication and misp partner user in keycloak
Step 1:
Login to the keycloak --> users --> add users-->fill in the details and save.
...
2. For misp partner - mpartner-misp-003.
Step 2:
Set the password in the credentials option.
Note : Copy the password from the application.properties of the Partner management tool
and use here.
...
Step 3:
For the created user assign the roles in the role mapping option as below.
...
Part-3 To create policy group and auth policy
Step 1:
Create another user or use existing user and map the following roles :-
...
partner management Portal.
step 2:
Create policy group by clicking --> policy--> policy group--> create policy group.
...
Reference picture below.
...
Step 3:
To create auth policy--> click auth policy -->create auth policy-->
...
Add the policies data, given below --> save and Activate. Refer the picture below.
{"authTokenType":"partner","allowedKycAttributes":[{"attributeName":"fullName"},{"attributeName":"gender"},{"attributeName":"bloodType"},{"attributeName":"dateOfBirth"},{"attributeName":"addressLine1"},{"attributeName":"addressLine2"},{"attributeName":"residenceStatus"},{"attributeName":"referenceIdentityNumber"},{"attributeName":"state"},{"attributeName":"city"},{"attributeName":"locality"},{"attributeName":"postalCode"},{"attributeName":"phone"},{"attributeName":"email"},{"attributeName":"photo"}],"kycLanguages":["eng"],"allowedAuthTypes":[{"authSubType":"FINGER","authType":"bio","mandatory":false},{"authSubType":"IRIS","authType":"bio","mandatory":false},{"authSubType":"FACE","authType":"bio","mandatory":false},{"authSubType":"","authType":"otp","mandatory":false},{"authSubType":"","authType":"otp-request","mandatory":false},{"authSubType":"","authType":"kyc","mandatory":false},{"authSubType":"","authType":"demo","mandatory":false}]}
...
Part-4 To Register AUTH and MISP partner
Step 1:
To Register auth partner, Use the swagger (refer part 1-- > step 7)-->
...
You’ve created. Refer below.
{
"environmentVersion": "LTS",
"partnerModel": {
"partnerAddress": "Aurangabad",
"partnerContactNumber": "9999999999",
"partnerEmailId": "ganesh.taru1@infystrat.com",
"partnerId": "mpartner-auth-0003",
"partnerOrganizationName": "mpartner-auth-0003",
"partnerType": "AUTH",
"policyGroup": "mpolicy-auth-0003"},
“policyName": "mpolicy-auth-0003"
}
NOTE:- Remove the extra spaces in the request, before executing.
Step 2 :
From the response, copy the partnerApiKey value for the upcoming use.
Step 3 :
To Register misp partner, Use the same swagger --> configure partner/create partner -->
...
Note: Edit the partner id, partner organization name, as same as you’ve created. Ref below.
{
"environmentVersion": "LTS",
"partnerModel": {
"partnerAddress": "Aurangabad",
"partnerContactNumber": "9999999999",
"partnerEmailId": "ganesh.taru2@infystrat.com",
"partnerId": "mpartner-misp-0003",
"partnerOrganizationName": "mpartner-misp-0003",
"partnerType": "MISP" ,
"policyGroup": "mpolicy-auth-21" }
...
Step 4 :
From the response copy the partnerMispLicenseKey value for the upcoming use.
Step 5 :
After the partner creation, .p12 file will be generated inside the temp folder. Find the temp folder
in the below mentioned path.
C:\Users\hp\AppData\Local\Temp\IDA-localhost\mpartner-auth-0003 (Or Use windows + R and search %temp%)
...
Copy the certificates created and rename them as same as your partner id.
Step 6 :
Download the Id- Authentication demo application UI from the below given link.
...
https://github.com/mosip/authentication-demo-ui/tree/release-1.2.0/authentication-demo-
Step 7 :
Now place the renamed certificates into the keys folder of the Authentication-demo-UI. Refer below.
...
Step 8 :
In the application.properties of the Authentication-demo-UI edit the following fields and
...
Paste the partnerApiKey and partnerMispLicenseKey which was generated while creating partner.
Add the mosip-regproc-client secret key.
Change the partner id and organization name.
Edit the environment url.
Reference picture below.
...
Step 9 :
Run the ID-Authentication-Demo-UI.bat .
...