A centralized Identity system a la SSN in the USA has been sorely lacking in India. But with the critical mass the Aadhaar scheme has gained and the API ecosystem maturing around it, finally, we have a viable option for identity.We have been leveraging this in many applications to implement disruptive use cases like social lending.Here, we are going to show how to integrate Aadhaar verification using Aadhaar Bridge in Laravel.
Following are the steps to achieve the verification process
2.1 Create a private key with a validity
keytool -genkey
-alias ALIAS_NAME
-keyalg RSA
-keystore COMP_NAME.jks
-keysize 2048
-dname “CN=COMMON_NAME, EMAILADDRESS=sample@abc.com, C=IN,
OU=ORG_UNIT, O=ORGANIZATION_NAME”
2.2 Create CSR (Certificate Signing Request) for the above key
keytool -certreq -alias ALIAS_NAME -file COMP_NAME.csr -keystore COMP_NAME.jks
Details to be ensured while generating the “CSR” through the terminal window by the customer:
Generation of a new Certificate: Once the CSR file is generated, generate the certificate by uploading the CSR on the same page itself. If the CSR file is validated, a certificate will be generated and thereafter will be shown on the screen. Download the certificate and save it in the local system.
To set up the server we need to download the setup zip file from the following link:
Resources –>JAVA DEVELOPERS
The Setup Zip file will contain the .jar and application.properties files. We need to configure the application.properties file to complete the server setup.
Generating and adding the P12 file path is one of the important configuration processes. Run the following command to generate the P12 file
keytool -importkeystore
-srckeystore COMP_NAME.jks
-destkeystore COMP_NAME.p12
-srcstoretype jks
-deststoretype pkcs12
In the application properties file, enter the configuration based on our profile. URLs for the same are mentioned below:
PropertyEndpoint
Once the properties file is configured with our certificate location, keystore passcode, service URL and SubAUA code, run the gateway application using the following command:java -jar aadhaar-gateway-.jar
(Note : On Executing the command, the JAR will auto-launch the Tomcat server, which requires Java-7 to be installed on our server.)
Here are a few code snippets for the Laravel API calls.Sample Base URL:
https://128.199.50.45:5181 (server is running on IP 128.199.50.45 at port 5181)
Add the following route in the routes.php:Route::group(['prefix' => 'aadhaar/'], function () {
Route::post('verification', 'AadhaarVerificationController@adhaarVerification');
});
Add the following controller file AadhaarVerificationController.php with function adhaarVerificationpublic function adhaarVerification(Request $request)
{
$validator = Validator::make($request->all(), [
'aadhaarid' => 'required',
'name' => 'required',
'pincode' => 'required'
]);
if ($validator->fails()) {
return response(array(
'message' => 'parameters missing',
'missing_parameters' => $validator->errors()
), 400);
}
$aadhaarid = $request->input('aadhaarid');
$name = $request->input('name');
$pincode = $request->input('pincode');
$client = new Client([ 'headers' => [ 'Content-Type' => 'application/json' ]]);
$res = $client->post('https://128.199.50.45:5181/auth/raw',
['body' => json_encode(
['aadhaar-id'=>$aadhaarid,
"location" => ["type" => "pincode", "pincode" => $pincode ],
"modality" => "demo",
"certificate-type" => "prod",
"demographics" =>
["name" =>
["matching-strategy" => "exact", "name-value" => $name]
]
]
)]
);
if($res->getStatusCode()==200){
if($reply->success){
$reply=json_decode($res->getBody()->getContents());
return response()->json(['message'=>'Aadhaar Verification Successful'],200);
} else{
return response()->json(['errmessage'=>'Aadhaar Verification Not Successful'],400);
}
} else{
return response()->json(['errmessage'=>'Aadhaar Verification Not Successful'],400);
}
}
Sample API call for Aadhaar verification:https://128.199.50.45:8000/api/v1/aadhaar/verification
Input:{"aadhaarid":"640000000000","name":,"pincode":"600000"}
Output:{"message":"Aadhaar Verification Successful"}
Therefore, integrating Aadhaar verification using Aadhaar Bridge in Laravel represents a significant advancement in leveraging India's centralized identity system.
Our detailed guide has outlined the necessary steps—from digital agreement creation and IP whitelisting to server setup and Laravel integration—to seamlessly incorporate Aadhaar verification into healthcare and other applications.
Take steps towards enhancing your system's security and efficiency by implementing Aadhaar verification today. Contact us to explore how we can help streamline your authentication processes with RPA-driven solutions tailored to your needs.
.png)