Difference between revisions of "Mobile Driver's License with WebAPI"

From MgmtWiki
Jump to: navigation, search
Line 3: Line 3:
* The following items are out of scope for SIO 18013-5:
* The following items are out of scope for ISO 18013-5:
# how mDL holder consent to share data is obtained;
# how mDL holder consent to share data is obtained;
# requirements on storage of mDL data and mDL private keys.
# requirements on storage of mDL data and mDL private keys.

Revision as of 09:17, 24 May 2021

Full Title

How to use WebAPI with a Mobile Driver's License (mDL) compliant with ISO 18013-5,


  • The following items are out of scope for ISO 18013-5:
  1. how mDL holder consent to share data is obtained;
  2. requirements on storage of mDL data and mDL private keys.
  • If the mDL reader receives the token and URL from the mDL, either during device engagement or device data retrieval, it may retrieve mDL data from the issuing authority via the Internet or locally. If the reader chooses to use the internet, either OIDC or WebAPI can be used to retrieve the information.
  • This context discusses only server retrieval using WebAPI over the Internet. (It may be that Device retrieval has been attempted before server retrieval.)
  • Data elements are signed by the issuing authority (IA).
  • The mDL produces a signature or message authentication code over session data. The private key used to authenticate the session data is stored only in the mDL. The corresponding public key in turn is signed by the IA.
  • Communications between mDL and mDL reader are encrypted and authenticated. The method is not defined.
  • The reader must have a private key and certificate signed by a competent authority. It is theoretically possible for the wallet to check the key.
  • Revocation methods are mentioned in the standard, but are not defined.
  • TLS is required Server transfers. TLS client is required, which appears to mean mutual TLS is required, although other methods are possible.
  • One time tokens are required for server transfers. This typically means a packet ID or nonce is supplied.
  • CBOR data is used from the mDL in CDDL tstr per RFC 8610 which is converted to json according the RFC 7049 section 4.1.
  • All data element names are prefixed with “org.iso.18013.5.1:”. No provision for a header namespace declaration is defined.

The following are the data retrieval steps from Data retrieval using WebAPI.

  1. The Issuing Authority may request consent or presence from the mDL holder. The details of consent or presence are not provided in 18013-5.
  2. An HTTPS POST to the server is made over a secure (encrypted) session.
  3. The message body shall be the mdoc response as defined in clause (that is the issuing authority response looks like the mDL response.)


Term mDL Purpose or Behavior WebAPI issues
Holder The person that has the license to drive
Wallet the device software that holds the mDL (aka mdoc) software statement
Reader the device used by the verifier to get data from the mDL client (RP)
user agent A program, such as a browser or other Web client, that mediates the communication between holders, issuers, and verifiers. (This does not match DID core well at all.) Place to store Cookies
Attacker a bogus wallet that is attempting to illicitly gain access or steal data from the reader
Issuing Authority typically the DMV or other state agency. used in Federation


  • If the Reader might use server retrieval for some transactions, but not all, then the type of access can leak information from the reader to an attacker.
  • Activation of the mDL is not defined in the standard and there are two access methods: NFC and QR. Other access methods available to the wallet MUST not be used for activation.
    • Oddly the issuing authority is responsible to avoid unauthorized access by an mDL reader when mDL activation is triggered by NFC or QR.
    • Nothing is said about the holder's role in activation.
    • The reader must support both NFC and QR according to the standard.
  • Protect storage of holder data in the wallet is not defined in the standard. Again, the issuing authority is given responsibility for storage in the wallet.
  • The OIDC standard does not make any claim about data contained in JWT packets. The local implementation needs to clarify the protect levels needed by the transfers.


  • The transaction has been designed such that it is not necessary for the mDL holder to physically hand over the mobile device to the mDL verifier.
  • A wallet that wants to be activated only from local devises should never use and radios than NFC as the others can be very distant from the holder.
  • Even after reading data from the wallet, the reader can still decide to go to the Internet to retrieve data on the holder.


From 18013-5

Step 3 Authorisation Authorisation Request: