Skip to content

Instantly share code, notes, and snippets.

@SantoshSrinivas79

SantoshSrinivas79/Online Aadhaar Hackathon.md

Last active August 29, 2015 14:22
Show Gist options
  • Save SantoshSrinivas79/3bd118de27f4b3a1cd03 to your computer and use it in GitHub Desktop.
Save SantoshSrinivas79/3bd118de27f4b3a1cd03 to your computer and use it in GitHub Desktop.
Download ZIP
Online Aadhaar Hackathon
Raw
Online Aadhaar Hackathon.md

#Online Aadhaar Hackathon

##Meteor Development

  • Use HOMER as the base template. The views to be used are:
    • Landing Page
    • Projects
    • Login

Images to be resized to: 281 x 244

Dummy pictures: http://lorempixel.com/160/200/people/. http://lorempixel.com/160/200/people/ http://lorempixel.com/160/200/

encoding - Node.js get image from web and encode with base64 - Stack Overflow

##Coding

For demographic auth

{
    "aadhaar-id": "9210 9776 9235",
    "location": 
        {
        "type": "pincode",
        "pincode": "560035"
        },
    "modality": "demo",
    "certificate-type": "preprod",
    "demographics": {
    "name": {
    "matching-strategy": "exact",
    "name-value": "Santosh Kumar Srinivas"
    }
    }
}

For otp auth

First request.

{
    "aadhaar-id": "9210 9776 9235",
    "location":{
                "type": "pincode",
                "pincode": "560035"
            },
    "channel":"SMS"
}

Authentication request.

    {
        "aadhaar-id": "**88759082**",
        "modality": "otp",
        "otp": "893192",
        "device-id": "public",
        "certificate-type": "preprod",
        "location": {
        "type": "pincode",
        "pincode": "201014"
        }
    }

Aadhaar Bridge Overview

Aadhaar Bridge is a Khosla Labs AUA/KUA product, which works on a SAAS model. The product provides various modes of service usage :

  • As a Sub AUA - Only use Auth/BFD services.
  • As a Hosted AUA - Use your own AUA license to host in our standard environment.
  • As a Hosted KUA - Use your own KUA license to perform KYC.

Aadhaar Bridge provides a thin API wrapper over the Aadhaar Auth/BFD/KYC Api and provides a self managing portal. The portal provides the various management capabilities along with dashboard and reports.

##Development Details

Contents

The hackathon kit contains the following artifacts

  • Aadhaar Bridge Client API Documentation
  • Aadhaar Bridge Gateway Documentation
  • Android SDK App
  • Standalone SDK for Auth/KYC Packet Creation (for nonandroid platforms)
  • Gateway URL
  • Samples

SDK

SDK details are explained in Aadhaar Hackathon Developer Guide.pdf. I am going to develop a standalone application as hence as explained.

For nonandroid application a Java library has been provided, which can be included as a maven or as a lib dependency. To install as a maven artifact please use the script provided as part of the folder(for sample application it is included as a local repo).

Please note that the library include the following components

  • Client API POJOs
  • Aadhaar protobuf schema (google protobuf)
  • UIDAI Public certificates

Look at the sample for usage and code documentation.

Client API Documentation The client SDK documentation can found on the following link with code snippets. http://bridge.aadhaarconnect.com/clientsdk.html

Gateway API Documentation The gateway SDK documentation can found on the following link with code snippets. http://bridge.aadhaarconnect.com/gatewaysdk.html

Gateway URL All requests are required to be submitted to the following URLs with Content Type as “ application/json ”

For Standalone Application (AadhaarPacketCreatorStandaloneSample)

For nonandroid applications (desktops, webapp), the kit provides a Java library that creates a Aadhaar compliant packet, which then can be submitted to the hackathon gateway for Auth/KYC. The code includes a sample methods for building Authentication and KYC Packets. The sample is a maven project, hence use Eclipse and import it (existing maven project).

Getting Started with Aadhaar Authentication Android Application

A good example at Aadhaar Bridge

##Potential Use Cases

Aadhaar can be used in multiple scenarios as explained in this link.

Aadhaar Application Hackathon | HackerEarth

Aadhaar Use Cases

##Notes

Aadhaar is an identity platform. That's it!

From the very beginning, Aadhaar had been envisioned as an online identity platform – one that changes the paradigm in identity to be about the person being identified rather than the card or identity token. It fundamentally also only focuses on Identity, not on any form of entitlement – unlike a Drivers License or a Voters Registration Card or a Passport which are a right to drive, vote, or proof of citizenship. Aadhaar proves Identity – nothing more, nothing less. (http://blog.hackerearth.com/2015/06/go-ahead-have-fun-and-show-us-what-you-can-do-that-will-transform-india.html)

Aadhaar was initially focused for government benefits

While the initial focus from a government perspective was to transform the administration of government benefits, the private sector itself has hundreds of use cases that can improve the efficiency/cost of delivery of services while improving the customer experience. Its no wonder that whenever I discuss Aadhaar to experts around the world, their eyes light up in envy – people cannot believe that the “Government has put up an online biometric authentication platform”!!!

##Judging Criteria

The judging criteria and weightage is as follows -

  • Use of Aadhaar API’s (40%)
  • Uniqueness and Value of Idea (20%)
  • Degree of Implementation (20%)
  • Usabilty (10%)
  • Presentation (10%)

##Themes

Payments

Can you think of an Aadhaar based solution to make paying local vendors easy and paperless.

Government Benefits

How can you Aadhaar to make claiming and allotting government benefits easier? Think of using internet enabled services that will help you do this.

Healthcare

Access health records of people across multiple hospitals using one Aadhaar number? Make government hospitals smarter using Aadhaar? It's your choice.

Online to Offline

Not all of India is online. How can Aadhaar leverage the power of online and deliver it offline? Think and build

Open Category

Think of any other way you think Aadhaar can impact our day to day life and make our every day transactions more convenient.

FMCG

Think of Aadhaar to make manufacturers and merchant interactions simpler. Or an Aadhaar based inventory management tool.

Financial Services

Centralise banking using Aadhaar number. Or make banking authentication seamless and simple

##Aadhaar APIs

The following two Aadhaar API's will be exposed to all participants:

You can leverage these 2 APIs for the following

  • Demographic Authentication
  • OTP Authentication
  • OTP eKYC
  • Biometric Authentication*
  • Biometric eKYC*

The last two functions marked * require approved biometric sensors. You can procure your own biometric sensors (approved by UIDAI) or our biometric sensor partner, Morpho will provide USB-based biometric sensors with their SDK for Android and Windows at a special cost of Rs. 3000 - you can purchase these online on or before May 31, 2015. Please read the FAQ to know more about it.

Access to APIs and SDKs

To participate in the Hackathon, you will need SDKs and APIs that you can use to build applications on top of Aadhaar APIs. You can find the documentation and access to those SDKs and APIs in the following Developer Guide

Download SDK & Documentation

The SDK from Morpho will be available for download as soon as you order the sensor. You will be redirected to a link after the purchase from where you can download the SDK.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment