smartid-auth

Smart-ID authentication client module for Node.JS

Install

npm install smartid-auth

Trying out with Demo

1. Download SmartID Demo app for Android
2. Set up your demo app in your phone
3. cd node_modules/smartid-auth/
4. npm run demo [countrycode EE/LT/LV] [Personal-ID-Number] Example: npm run demo EE 12345678901

Usage

Documentation is in progress, refer to the example below:

const SmartIDAuth = require('smartid-auth');
const smartauth = new SmartIDAuth({
  host: 'https://sid.demo.sk.ee/smart-id-rp/v1',
  requestParams: {
    relyingPartyUUID: '00000000-0000-0000-0000-000000000000',
    relyingPartyName: 'DEMO',
    certificateLevel: 'QUALIFIED'
  }
});

smartauth.authenticate('EE', 'ESTONIAN-ID-CODE-GOES-HERE', 'MESSAGE-TO-DISPLAY-ON-PHONE-GOES-HERE').then(session => {
  // This is the verification code you should display to the user (on your site):
  console.log('Verification code: ' + session.verificationCode);
  console.log('Waiting for user action...');
  session.pollStatus().then(response => {
    console.log('Authentication OK!');
    console.log(response.data);
  }).catch(err => {
    console.error('Authentication error', err);
  });
}).catch(err => {
  console.error('Error on initializing authentication', err);
});

Demo output example

$ npm run demo EE 10101010005
Verification code: 8865
Waiting for user action...
Authentication OK!
{ countryName: 'EE',
  surname: 'SMART-ID',
  givenName: 'DEMO',
  serialNumber: 'PNOEE-10101010005',
  commonName: 'SMART-ID,DEMO,PNOEE-10101010005',
  organizationalUnitName: 'AUTHENTICATION' }

Running tests

Smart-ID provides test accounts for automated testing. Running npm run test will go through those:

EndResult	Country	national-identity-number	certificateLevel
OK	EE	10101010005	QUALIFIED
OK	LV	010101-10006	QUALIFIED
OK	LT	10101010005	QUALIFIED
USER_REFUSED	EE	10101010016	QUALIFIED
USER_REFUSED	LT	10101010016	QUALIFIED