Apache Milagro MFA JS Client Incubator

Clone this repo:



  1. a1f8b90 Merge https://github.com/miracl/milagro-mfa-js-client by Nick Kew · 2 years, 5 months ago master
  2. 841a971 Transfer to library desire authentication protocols. (#10) by bbvox · 2 years, 5 months ago
  3. 69ec5f5 Merge pull request #9 from miracl/mass/compatible by bbvox · 2 years, 5 months ago
  4. 513d0d9 Show status of mobile authentication by Pavlin Angelov · 2 years, 6 months ago
  5. f6fe492 Add mobile QR code screen by Boyan Bakov · 2 years, 7 months ago

M-Pin JavaScript Client

The M-Pin System consists of two groups of Services - Customer-hosted Services and Miracl-hosted Services.

The third, but no less important component, is the Client. Currently there are two clients available - the Browser Client, also called the PIN Pad, and the Mobile Client, known as the Mobile App

##PIN Pad

The PIN Pad is a JavaScript software component that should be integrated into the Customer's Application Web Page. The PIN Pad encapsulates all the operations and logic that needs to be performed at the front-end, in order to register and authenticate an end-user.

##Mobile App

The Mobile App is a JavaScript application, much similar to the PIN Pad. The Mobile App also carries out the operations needed to register and authenticate an end-user, but the user is authenticated to a browser session, rather than to a session on the mobile device.

##Building automatically the PIN Pad You can run the following script to install all dependencies for you and build both the PIN PAD and Mobile App

    > ./build.sh

It is building with default Milagro theme. The built apps should be placed in <work-dir>/build/out/browser and <work-dir>/build/out/mobile.

##Building the PIN Pad

  1. NOTE: You might have to update your package distribution system. For Ubuntu you would need to do: sudo apt-get update
  2. Install Node Package Manager and Node. For instance on Ubuntu you need to do:
  3. sudo apt-get install npm
  4. sudo npm install -g n
  5. sudo n 0.10.33. NOTE that you need curl installed to do this.
  6. Install grunt and the required modules
  7. sudo npm install -g grunt-cli
  8. Install handlebars and the required modules
  9. sudo npm install -g handlebars@3.0.1
  10. Install bower and the required modules
  11. sudo npm install -g bower
  12. Checkout/Clone the repository to <work-dir>
  13. Install the locally required modules for Node
  14. cd <work-dir>/browser or cd <work-dir>/mobile
  15. sudo npm install
  16. Create settings.json file
  17. cp settings.json_build settings.json
  18. NOTE Available templates: milagro.
  19. Build the app
  20. grunt build

The built app should be placed in <work-dir>/build/out/browser or <work-dir>/build/out/mobile.

NOTE that the settings.json file that was created above, should be modified with the correct base URL for the PIN Pad resources and with the desired template. For more details see the bellow documentation.

For further details on Milagro, please see the Milagro Documentation