OpenCRVS API for MOSIP

This package ensures a secure and a robust integration between OpenCRVS and MOSIP. For instructions on how to setup the integration, please refer to the installation.md. For local development, see instructions below. For features and core versions supported, please refer to the compatibility.md.

Development

# start the web server
cd packages/server
yarn install
yarn dev

# optionally run MOSIP mock server
cd packages/mosip-mock
yarn install
yarn dev

Pull request deploys

Pull requests deploy a new version to the opencrvs/e2e -environment using mosip branch. It uses develop @ opencrvs/opencrvs-core and mosip @ opencrvs/opencrvs-farajaland by default. In case the PR branch name is available in core and/or Farajaland, the respective branches are being used.

Country configuration

@opencrvs/opencrvs-countryconfig/src/index.ts

-import { eventRegistrationHandler } from '@countryconfig/api/event-registration/handler'
+import { mosipRegistrationHandler } from '@opencrvs/mosip'

 server.route({
   method: 'POST',
   path: '/event-registration',
-  handler: eventRegistrationHandler,
+  handler: mosipRegistrationHandler({ url: "http://localhost:2024" })),
   options: {
     tags: ['api'],
     description:
       'Opportunity for sychrounous integrations with 3rd party systems as a final step in event registration. If successful returns identifiers for that event.'
   }
 })

Usage

The gateway runs by default in port 2024, the same year the stable version of the MOSIP integration is released. The MOSIP-mock service runs in 20240.