PProtocol Lab
Identity & Civil Registration

Identity & Civil Registration

How a state establishes, credentials, and asserts the identity of its people while retaining full custody of the register.

Overview

Every layer of digital public infrastructure resolves, eventually, to one question: who is this person, and who says so? The identity layer is where that question is answered — and where sovereignty is either secured or quietly surrendered.

This publication sets out a reference architecture for national identity built on three separable layers: the registry (the authoritative record), the credential (the artifact a person holds), and the assertion protocol (how identity is proven to a relying service without exposing the register itself).

An identity register is not a piece of infrastructure but a constitutional artifact.

Separating these layers is the central architectural move. It allows credentials and assertion mechanisms to evolve — cards, mobile IDs, biometrics — without ever re-opening custody of the register.

Reference architecture

The three-layer model isolates what must remain under exclusive sovereign control (the registry and its cryptographic root) from what can safely be delivered through vendors and partners (credential media, verification devices).

unknown node

Layer 1 — the registry. Authoritative record, sovereign key custody, never exposed directly.

Layer 2 — credentials. Cards, mobile IDs, verifiable credentials — replaceable media.

Layer 3 — assertion protocol. Yes/no answers to relying services, minimal disclosure.

Relying services — a bank opening an account, a clinic pulling an entitlement — receive assertions, not records. The register answers yes or no; it does not hand over the file.

Design principles

Six principles govern every architectural decision in this publication. They are cited elsewhere as PL-01, P-1 through P-6.

unknown node

Terminologies & definitions

A standardized glossary ensures clarity across administrative and engineering teams in sovereign identity deployments.

Term

Expansion

Definition

API

Application Programming Interface

Rules and protocols enabling distinct software applications to communicate.

DPI / DPG

Digital Public Infrastructure / Good

Foundational public digital platforms and open-source software/standards.

IdP / SP

Identity Provider / Service Provider

Entities that manage identity/authentication vs services relying on authentication.

JWT

JSON Web Token

Compact, URL-safe format (RFC 7519) representing claims transferred securely.

OAuth 2.0 / OIDC

Open Authorization / OpenID Connect

Authorization framework and identity verification layer built on OAuth 2.0.

PAERA

Public Admin Enterprise Ref Architecture

GovStack framework breaking complex government systems into reusable blocks.

PKCE

Proof Key for Code Exchange

Extension (RFC 7636) securing OAuth 2.0 flows on mobile and single-page apps.

PKI / mTLS

Public Key Infra / Mutual TLS

Certificates/trust infrastructure and mutual client-server cryptographic verification.

LoA

Level of Assurance

Categorization measuring confidence in identity verification (LoA1–LoA3).

PPID / PSUT

Pairwise Pseudonymous Token

Privacy-preserving identifiers distinct across requesting agencies.

UIN / NIN

Unique / National Identity Number

Ground-truth sovereign identifier issued to a verified citizen.

Technical & Interoperability Standards

The reference architecture enforces open standards across transport, cross-functional service contracts, and whole-of-government governance layers.

Interoperability Hierarchy

  • Protocol Interoperability: Enforces HTTPS with TLS 1.3, JSON over REST, UTF-8, ISO 8601 UTC timestamps, API versioning, and standardized authentication. This is necessary but insufficient alone for component-level replaceability.
  • Cross-Functional Interoperability: Aligns API endpoint schemas, request parameters, and response structures to GovStack Building Block specifications (govstack-bb-*). Guarantees software component replaceability without breaking dependent applications.
  • Whole-of-Government Interoperability: Enforces binding organizational, legal, and semantic data exchange standards across state bodies, enabling life-event automation (e.g., birth registration updating social and health registers).

Core Technical Specifications

Interface

Standard

Role in the architecture

ASSERT

OpenID Connect / OID4VP / SAML 2.0

Assertion of identity with selective disclosure and legacy SAML compatibility.

CRED

W3C Verifiable Credentials 2.0

Portable, cryptographically signed credential format across media.

BIO

ISO/IEC 19794 · IEEE 2857

Biometric capture and template interchange at enrolment.

REG-API

OpenAPI 3.1 (published spec)

The registry's only doorway — versioned, audited, rate-governed.

SEC-PRIV

mTLS · OAuth 2.0 PKCE · PPID

Zero-trust mutual authentication, PKCE for client security, pairwise tokens for data minimization.

Security, Privacy-by-Design & Accessibility

  • Data Minimization & Tokenization: Zero-knowledge proofs and sector-specific Pairwise Pseudonymous Identifiers (PPID) ensure citizens are never tracked across agencies via raw National Identity Numbers.
  • Non-Repudiation & Auditing: Structural XMLDSig/XEnc digital signatures and immutable ledger logs ensure full non-repudiation and transaction history.
  • Zero-Trust Architecture: Enforces mandatory mutual TLS (mTLS) across all internal API endpoints to prevent lateral movement upon perimeter breach.
  • Universal Accessibility: Systems comply with WCAG 2.1 UI standards and support low-tech channels (USSD and SMS rails) alongside web portals. Explicit citizen consent interfaces allow reviewing and revoking access permissions.
unknown node

Single Sign-On & Trust Infrastructure

Single Sign-On (SSO) on a sovereign scale operates as a foundational building block under the GovStack PAERA framework, serving registries, e-services, and payment rails.

PAERA Implementation Sequence

  1. Governance & Legal Layer: Legal recognition of federated digital identities, clear ownership demarcation, and strict PII protection complying with country/regional privacy acts.
  2. Architectural & Interoperability Layer: Open standard API endpoints (OIDC Core 1.0, OAuth 2.0 RFC 6749, SAML 2.0 Web Browser SSO profile).
  3. Integration with Foundational Identity: Native binding to the authoritative National Identity / Civil Registry for ground-truth verification.
  4. Security & Federation Layer: Centralized Identity Provider (IdP) deployment with API Gateways and trust federation (X-Road / PKI pattern).

Functional Specifications

Module

Requirement ID

Functional Rule

OIDC / OAuth 2.0

FR-SSO-OIDC-001

Authorization Code Flow with PKCE (RFC 7636); cryptographically signed JWTs (RS256/ES256); /jwks.json key exposure.

OIDC Discovery

FR-SSO-OIDC-002

Zero-configuration discovery at /.well-known/openid-configuration and RFC 7591 Dynamic Client Registration.

SAML 2.0

FR-SSO-SAML-001

Legacy support via HTTP-Redirect/POST bindings; XMLDSig SHA-256 signing; optional XEnc payload encryption.

Privacy Controls

FR-SSO-PRIV-001

Pairwise Pseudonymous Identifiers (PPID/PSUT) ensuring distinct sub claims per agency; raw NIN/UIN is never exposed directly.

Assurance (LoA)

FR-SSO-TRUST-002

Convey identity confidence (LoA1–LoA3) in token claims (acr); dynamic step-up MFA prompts if requested by an agency.

Logout (SLO)

FR-SSO-SESS-001

Universal Single Logout via OIDC Back-Channel Logout 1.0 HTTP POST tokens and SAML Single Logout Profile.

Policy, Legal & Regulatory Standards

A functional DPI requires legal and normative compliance backing the technical infrastructure across a three-tiered pyramid:

  • Soft Law & Specifications: Conformance with open international frameworks, including ISO/IEC 27001 (Security), ISO 20022 (Financial Messaging), and W3C Verifiable Credentials.
  • Regional & International Law: Structural alignment with macro frameworks such as the General Data Protection Regulation (GDPR) and regional cross-border data transfer protocols.
  • National Mandates: Statutory parameters enforcing data privacy, explicit citizen consent, anti-monopoly clauses, and the "Once-Only" principle (banning redundant data collection across state agencies).

Implementation options

The architecture is defined by its interfaces, not by products. The options below conform to the interfaces in the previous section, as assessed at time of publication (v1.0, 2026).

  • REGISTRY — open source: MOSIP · OpenCRVS (civil registration). Commercial: established registry/ABIS platforms (Idemia, Thales, NEC class).
  • CRED — open source: Inji wallet (MOSIP) · open verifiable-credential stacks. Commercial: vendor mobile-ID and smart-card suites.
  • ASSERT — open source: eSignet · Keycloak (OIDC). Commercial: commercial IAM platforms.
  • TRUST FEDERATION — open source: X-Road secure data exchange framework. Commercial: commercial API management & service meshes.
unknown node

Implementation guidance

For a ministry or agency beginning from an existing civil register, the recommended sequence is:

  1. Consolidate the register first. Digitize and deduplicate the authoritative record before issuing a single new credential. Credentials issued against a contested register inherit its disputes.
  2. Stand up the assertion layer as a thin service. A minimal yes/no verification API delivers value to relying services months before any new credential ships.
  3. Treat credential issuance as a rolling program, not a big bang. Begin with one high-frequency use case — SIM registration, social protection enrolment — and let demand pull coverage.
  4. Contract the exit before the entry. Escrow, data-return, and key-handover clauses are negotiated at their cheapest on the day of signature and at their most expensive on the day of dispute.

Downloads & citation

The full publication is available as a typeset PDF. Cite this work as:

Protocol Lab (2026). PL-01: Identity & Civil Registration, v1.0. Azul Tech Ltd, Kigali.