ABDM v3 · M1–M4 implemented

Guide Certification

From the ABDM sandbox to production: certification, security audit and the exit process

Working against the sandbox is the easy half. Production credentials come only after an empanelled agency has tested every milestone you claim, a security auditor has certified the application, and NHA’s committee has approved the file. This guide walks the route and says what to prepare before each gate.

01The route in one view

  1. Register the software on the sandbox and receive a client id and secret.
  2. Integrate and self-test every milestone you will claim, against the live sandbox rather than a mock.
  3. Start the exit from the form in your sandbox account.
  4. Functional and non-functional testing by an NHA-empanelled agency, which issues a report.
  5. Security testing by a CERT-In or STQC empanelled auditor, which issues a Safe-to-Host certificate once findings are closed.
  6. Submission of both, with the completed forms, to NHA’s committee.
  7. Production credentials, and a listing among certified integrators.

Steps 4 and 5 are paid, to the agency and the auditor. NHA charges nothing. The order is not negotiable: the agency tests the deployment the auditor will certify, and the committee wants both reports.

02Self-testing before you book

The agency runs NHA’s sheets; you should have run them first. Nothing done against a mock counts, because a mock speaks ABDM’s shapes and not its rules. For each milestone, drive the flow end to end on the sandbox with callback verification on:

  • M1: create an ABHA from Aadhaar and from a mobile, verify an existing one, read the profile and the card, and record it on the patient.
  • M2: link a care context HIP-initiated and user-initiated, receive a consent artefact, answer a health-information request with a bundle that contains only what the artefact covers, and refuse after revocation.
  • M3: raise a consent request, handle grant and denial, fetch the artefact, request and decrypt the records, and stop showing them after expiry.
  • Registries: search and register a facility in HFR, link its services to the bridge, and look up and register a professional in HPR.

Keep the evidence: request ids, callback payloads and screenshots, dated. The agency will ask for some of it, and it is what you will need if a case fails.

03Functional testing by the agency

Since August 2022 functional testing has been paid-for testing by one of the agencies NHA has empanelled. The agency takes your deployment, a test account and a demonstration, and works through the test-case sheet for each milestone you claimed. Many cases have a user-interface half: the consent text shown to a citizen, the OTP resend timer, how records are presented to a clinician. They are tested in the product a facility uses, not only at the API.

A failed case is fixed and re-tested. Cases you cannot show, because a route is disabled in the sandbox, are declared rather than failed. The report the agency issues is what goes to the committee.

04The security audit

A CERT-In or STQC empanelled auditor tests the application and its hosting and issues a Safe-to-Host certificate once the findings are closed. Implementers call it the WASA, for web application security audit, and describe a vulnerability-closure certificate; those names come from implementer write-ups rather than NHA, whose own reference is its Secure Application Development document.

Three findings appear on nearly every first scan: a content-security policy the scanner considers weak, cookie flags, and information disclosure in error pages. Decide your position on each before the audit and write it down for the auditor, with the control that mitigates it. Field-level encryption of Aadhaar numbers, OTPs and tokens, verification of consent-artefact signatures, and an append-only audit trail are the controls an auditor looks for in an ABDM application specifically.

05Committee and credentials

The functional testing report, the Safe-to-Host certificate and the completed forms go to NHA’s internal committee. On approval you receive production client credentials, register your production bridge URL, and appear in NHA’s list of integrated software, which is what a hospital checks when it links its facility to yours in HFR.

Production is not the sandbox with a different host. Registry hosts differ, credentials are issued per onboarding, and the consent manager id changes. Keep every base URL and identifier in configuration, per environment, and confirm each one against your onboarding pack before the first live call.

06What to declare up front

  • Routes the sandbox did not let you exercise, such as ABHA creation from a driving licence when it is switched off, or standing subscriptions where the subscription service refuses your HIU.
  • Milestones you are not claiming. Claiming M3 you have not built costs a failed sheet and a re-test.
  • Where the citizen-facing screens live, since the agency tests them.
  • Which facility in the sandbox is yours, registered in HFR and linked to your bridge, so the agency’s callbacks reach you.

07What a hospital inherits

Certification attaches to the software. A hospital that uses certified software does not repeat any of this; it registers its facility in HFR, links it to that software, and is on ABDM. That is the economic case for a shared connector: the agency testing, the audit and the production onboarding are done once, and every hospital on it inherits the result, including the next time NHA changes the sheets. The sandbox page covers how to start, and the cost guide what the routes cost.

FAQ Common questions

Frequently asked questions

Who tests an ABDM integration before production?
An agency NHA has empanelled for functional and non-functional testing runs ABDM's test-case sheets against your deployment and issues a report. Separately, a CERT-In or STQC empanelled auditor tests the application's security and issues a Safe-to-Host certificate.
Does every hospital need its own ABDM certification?
No. Certification is of the software, not the hospital. A hospital using certified software inherits it and needs only its HFR registration and bridge linkage. That is the main reason a shared, certified connector is cheaper than each vendor certifying separately.
What does the sandbox not test?
Some routes are not enabled there, such as ABHA creation from a driving licence at times, and some services behave differently from production. Declare what could not be exercised on the exit form rather than letting the agency discover it.

Next Keep reading

Related reading

ABDM SANDBOX

An ABDM sandbox you can call today

Get ABDM sandbox API credentials the moment you verify your email. Exercise ABHA, care-context linking, consent and FHIR data exchange against the NHA sandbox, with a starter facility, a live test console and a checklist for sandbox exit.

GUIDE

ABDM milestones M1, M2, M3 and M4, explained

What each ABDM milestone covers — M1 ABHA, M2 HIP linking and sharing, M3 HIU consent and retrieval, and what M4 refers to — which ones your product needs, how each is tested, and what stands between the sandbox and production.

SECURITY

How patient data is protected

Fidelius end-to-end encryption, field-level encryption at rest, consent scope enforced on every record release, and a full audit trail. Written for the hospital IT team that has to sign this off.

GUIDE

Registering a hospital in the Health Facility Registry, step by step

What HFR asks for and in what order: the facility manager's HPR ID, the four-step registration, the fields HFR refuses without saying why, address proof, the source of information, and the bridge linkage without which every ABDM call fails afterwards.

Try it against the sandbox

Sandbox API keys are issued the moment you verify your email. Create an ABHA, link a care context and watch the webhook arrive.