-
Notifications
You must be signed in to change notification settings - Fork 2
/
index.html
636 lines (592 loc) · 28.9 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
<!DOCTYPE html>
<html>
<head>
<title>Verifiable Driver's License Vocabulary v0.1</title>
<meta http-equiv=" Content-Type" content="text/html;charset=utf-8">
<script src="https://www.w3.org/Tools/respec/respec-w3c" class="remove"></script>
<script type="text/javascript" class="remove">
const respecPagesJson = {
name: "vdl-vocab",
status: "unofficial",
github: "digitalbazaar/vdl-vocab",
group: {
name: "Credentials Community Group",
url: "https://www.w3.org/community/credentials/",
list: "public-credentials",
patentUri: "https://www.w3.org/community/about/agreements/cla/",
},
editors: [],
bibliography: {
"RDF-DATASET-NORMALIZATION": {
title: "RDF Dataset Normalization 1.0",
href: "http://json-ld.github.io/normalization/spec/",
authors: ["David Longley", "Manu Sporny"],
status: "CGDRAFT",
publisher: "JSON-LD Community Group",
},
},
};
var respecConfig = {
// specification status (e.g., WD, LCWD, NOTE, etc.). If in doubt use ED.
specStatus: "unofficial",
// the specification's short name, as in http://www.w3.org/TR/short-name/
shortName: "vdl-vocab",
// if there a publicly available Editor's Draft, this is the link
edDraftURI: "https://w3id.org/vdl",
// if this is a LCWD, uncomment and set the end of its review period
// lcEnd: "2009-08-05",
// if you want to have extra CSS, append them to this list
// it is recommended that the respec.css stylesheet be kept
//extraCSS: ["spec.css", "prettify.css"],
// editors, add as many as you like
// only "name" is required
editors: [{
name: "Manu Sporny", url: "https://www.linkedin.com/in/manusporny/",
company: "Digital Bazaar", companyURL: "http://digitalbazaar.com/"
}, {
name: "Tobias Looker", url: "https://www.linkedin.com/in/tplooker/",
company: "MATTR", companyURL: "https://mattr.global/"
}, {
name: "Timothée Haudebourg", url: "https://github.com/timothee-haudebourg/",
company: "Spruce Systems, Inc.", companyURL: "https://spruceid.com/"
}, {
name: "Oliver Terbu", url: "https://github.com/awoie",
company: "Spruce Systems, Inc.", companyURL: "https://spruceid.com/"
}],
// extend the bibliography entries
//localBiblio: webpayments.localBiblio,
// group: "w3c-ccg",
// wg: respecPagesJson.group.name,
// // URI of the public WG page
// wgURI: respecPagesJson.group.url,
// // name (with the @w3c.org) of the public mailing to which comments are due
// wgPublicList: respecPagesJson.group.list,
// URI of the patent status for this WG, for Rec-track documents
// !!!! IMPORTANT !!!!
// This is important for Rec-track documents, do not copy a patent URI from a random
// document unless you know what you're doing. If in doubt ask your friendly neighbourhood
// Team Contact.
// wgPatentURI: respecPagesJson.group.patentUri,
// URI of the patent status for this WG, for Rec-track documents
// !!!! IMPORTANT !!!!
// This is important for Rec-track documents, do not copy a patent URI from a random
// document unless you know what you're doing. If in doubt ask your friendly neighbourhood
// Team Contact.
// wgPatentURI: "",
maxTocLevel: 2,
/*preProcess: [ webpayments.preProcess ],
alternateFormats: [ {uri: "diff-20111214.html", label: "diff to previous version"} ],
*/
localBiblio: respecPagesJson.bibliography,
};
</script>
<script src="./common.js" class="remove"></script>
</head>
<body>
<section id="abstract">
<p>
This specification describes <b>an experimental vocabulary</b> for expressing
a Verifiable Driver's License, which is intended to be fully conformant with
the ISO 18013 Mobile Driver's License data model.
</p>
</section>
<section id="sotd">
This document is experimental.
</section>
<section class="informative">
<h2>Introduction</h2>
<p>
This specification describes <b>an experimental vocabulary</b> for expressing
a Verifiable Driver's License, which is intended to be fully conformant with
the ISO 18013 Mobile Driver's License data model.
</p>
<section class="informative">
<h3>Use Cases and Requirements</h3>
<p>
The following use cases outline a number of key scenarios that readers might
find useful:
</p>
<ul>
<li>
Expressing driving privileges on the Web.
</li>
<li>
Serializing driving privileges in an optical carrier (e.g., QR Code).
</li>
<li>
Selectively disclosing driving privileges.
</li>
<li>
Compatability with the W3C Verifiable Credentials data model.
</li>
</ul>
</section>
<section class="informative">
<h3>Example</h3>
<p>
The following examples are provided ...
</p>
<pre class="example" title="A ISO18013-5 mDL expressed as a W3C Verifiable Credential">
{
"@context": [
"https://www.w3.org/2018/credentials/v1",
"https://w3id.org/vdl/v2",
"https://w3id.org/vdl/aamva/v1"
],
"type": [
"VerifiableCredential",
"Iso18013DriversLicenseCredential"
],
"issuer": {
"id": "did:key:z6MkjxvA4FNrQUhr8f7xhdQuP1VPzErkcnfxsRaU5oFgy2E5",
"name": "Utopia Department of Motor Vehicles",
"url": "https://dmv.utopia.example/",
"image": "https://dmv.utopia.example/logo.png"
},
"issuanceDate": "2023-11-15T10:00:00-07:00",
"expirationDate": "2028-11-15T12:00:00-06:00",
"name": "Utopia Driver's License",
"image": "data:image/jpeg;base64,iVBORw0KGgoAAAANSUhEUg...kSuQmCC",
"description": "A license granting driving privileges in Utopia.",
"credentialSubject": {
"id": "did:example:12347abcd",
"type": "LicensedDriver",
"driversLicense": {
"type": "Iso18013DriversLicense",
"document_number": "542426814",
"family_name": "TURNER",
"given_name": "SUSAN",
"portrait": "data:image/jpeg;base64,/9j/4AAQSkZJR...RSClooooP/2Q==",
"birth_date": "1998-08-28",
"issue_date": "2023-01-15T10:00:00-07:00",
"expiry_date": "2028-08-27T12:00:00-06:00",
"issuing_country": "UA",
"issuing_authority": "UADMV",
"driving_privileges": [{
"codes": [{"code": "D"}],
"vehicle_category_code": "D",
"issue_date": "2019-01-01",
"expiry_date": "2027-01-01"
},
{
"codes": [{"code": "C"}],
"vehicle_category_code": "C",
"issue_date": "2019-01-01",
"expiry_date": "2017-01-01"
}],
"un_distinguishing_sign": "UTA",
"aamva_aka_suffix": "1ST",
"sex": 2,
"aamva_family_name_truncation": "N",
"aamva_given_name_truncation": "N"
}
}
}
</pre>
</section>
</section>
</section>
<section class="informative">
<h2>Terminology</h2>
<div
data-include="./terms.html"
></div>
</section>
<section class="informative">
<h2>Concepts</h2>
<p>
TBD
</p>
</section>
<section class="normative">
<h2>The Verifiable Driver's License Core Vocabulary</h2>
<p>
This vocabulary assumes all terms specified in the base Verifiable Credentials
[[VC-DATA-MODEL]] context. In addition, the following classes are available for
specifying information related to ISO18013 data model compatible Driving
Licenses.
</p>
<table class="simple">
<thead>
<tr>
<th>Identifier</th>
<th>Field Name</th>
<th>Field Description</th>
<th>Data Type</th>
</tr>
</thead>
<tbody>
<tr>
<td>family_name</td>
<td>Family name</td>
<td>Last name, surname, or primary identifier, of the licence holder.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>given_name</td>
<td>Given names</td>
<td>First name(s), other name(s), or secondary identifier, of the licence holder.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>birth_date</td>
<td>Date of birth</td>
<td>Day, month, year on which the licence holder was born. If unknown, approximate.</td>
<td><a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339 full-date</a></td>
</tr><tr>
<td>issue_date</td>
<td>Date of Issue</td>
<td>Date licence document was issued.</td>
<td><a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339 date-time</a> or <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339 full-date</a></td>
</tr><tr>
<td>expiry_date</td>
<td>Date of Expiry</td>
<td>Date licence document expires.</td>
<td><a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339 date-time</a> or <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339 full-date</a></td>
</tr><tr>
<td>issuing_country</td>
<td>Issuing country</td>
<td>Country code as alpha 2 code, defined in ISO 3166-1, which issued the mDL or within which the licensing authority is located.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>issuing_authority</td>
<td>Issuing authority</td>
<td>Name of licensing authority, or issuing country if separate licensing authorities have not been authorized.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>document_number</td>
<td>Licence number</td>
<td>The number assigned or calculated by the issuing authority.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>administrative_number</td>
<td>Administrative number</td>
<td>An audit control number assigned by the licensing authority</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>driving_privileges</td>
<td>Categories of vehicles/restrictions/conditions</td>
<td>Driving privileges the licence holder is authorized to drive. It consists of category issue date, expiry date, restriction/condition sign code, restriction/condition sign and restriction/condition value.</td>
<td><a href="http://www.w3.org/1999/02/22-rdf-syntax-ns#JSON">JSON</a></td>
</tr><tr>
<td>un_distinguishing_sign</td>
<td>UN distinguishing sign</td>
<td>Distinguishing sign of the issuing country according to 18013-1 annex F NOTE this field is added for purposes of the UN conventions on driving licences.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>sex</td>
<td>Sex</td>
<td>Licence holder’s sex using values as defined in ISO/IEC 5218.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32 bits unsigned integer number</a></td>
</tr><tr>
<td>height</td>
<td>Height (cm)</td>
<td>A Licence holder’s height in centimetres.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32 bits unsigned integer number</a></td>
</tr><tr>
<td>weight</td>
<td>Weight (kg)</td>
<td>A Licence holder’s weight in kilograms O F3N uint.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32 bits unsigned integer number</a></td>
</tr><tr>
<td>eye_colour</td>
<td>Eye colour</td>
<td>Licence holder’s eye colour: black, blue, brown, dichromatic, grey, green, hazel, maroon, pink or unknown.
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>hair_colour</td>
<td>Hair colour</td>
<td>Licence holder’s hair colour: bald, black, blond, brown, grey, red, auburn, sandy, white or unknown.
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>birth_place</td>
<td>Place of birth</td>
<td>Country and municipality or state/province where the licence holder was born.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>resident_address</td>
<td>Permanent place of residence</td>
<td>The place where the licence holder resides and/or may be contacted (street/house number, municipality etc.)</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>portrait</td>
<td>Portrait of mDL Holder</td>
<td>A reproduction of the licence holder’s portrait.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#base64Binary">Base 64</a></td>
</tr><tr>
<td>portrait_capture_date</td>
<td>Portrait image timestamp</td>
<td>Date when picture was taken.</td>
<td><a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339 date-time</a></td>
</tr><tr>
<td>age_in_years</td>
<td>Age attestation: How old are you (in years)?</td>
<td>The age of the mDL Holder.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32 bits unsigned integer number</a></td>
</tr><tr>
<td>age_over_18</td>
<td>Age attestation: Nearest “true” attestation above 18.</td>
<td>Is the holder over 18.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#boolean">Boolean</a></td>
</tr><tr>
<td>age_over_21</td>
<td>Age attestation: Nearest “true” attestation above 21.</td>
<td>Is the holder over 21.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#boolean">Boolean</a></td>
</tr><tr>
<td>age_over_25</td>
<td>Age attestation: Nearest “true” attestation above 25.</td>
<td>Is the holder over 25.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#boolean">Boolean</a></td>
</tr><tr>
<td>age_over_62</td>
<td>Age attestation: Nearest “true” attestation above 62.</td>
<td>Is the holder over 62.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#boolean">Boolean</a></td>
</tr><tr>
<td>age_over_65</td>
<td>Age attestation: Nearest “true” attestation above 65.</td>
<td>Is the holder over 65.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#boolean">Boolean</a></td>
</tr><tr>
<td>age_birth_year</td>
<td>Age attestation: In what year were you born?</td>
<td>The year when the mDL Holder was born.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32 bits unsigned integer number</a></td>
</tr><tr>
<td>issuing_jurisdiction</td>
<td>Issuing jurisdiction</td>
<td>Country subdivision code as defined in clause 8, ISO 3166-2. The first part of the code shall be the same as the value for issuing_country. This element is intended to be used in cases where the issuing jurisdiction is different from the issuing authority.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>nationality</td>
<td>Nationality</td>
<td>Nationality of the mDL Holder as two letter country code (alpha-2 code) defined in ISO 3166-1.
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>resident_city</td>
<td>Resident city</td>
<td>The city where the mDL Holder lives.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>resident_country</td>
<td>Resident country</td>
<td>The country where the mDL Holder lives.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>resident_state</td>
<td>Resident state/province/district</td>
<td>The state/province/district where the mDL Holder lives.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>resident_postal_code</td>
<td>Resident postal code</td>
<td>The postal code of the mDL Holder.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>family_name_national_character</td>
<td>Family name of holder in full UTF-8 character set</td>
<td>The family name of the mDL Holder in his/her national characters.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>given_name_national_character</td>
<td>Given name of holder in full UTF-8 character set</td>
<td>The given name of the mDL Holder in his/her national characters.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>signature_usual_mark</td>
<td>Signature / usual mark</td>
<td>Image of the signature or usual mark of the mDL Holder.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#base64Binary">Base 64</a></td>
</tr><tr>
<td>terseStatusListBaseUrl</td>
<td>Terse Status List Base URL</td>
<td>The base URL location of a status list.</td>
<td>URL</td>
</tr><tr>
<td>terseStatusListIndex</td>
<td>Terse Status List Index</td>
<td>An index within a status list.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32 bits unsigned integer number</a></td>
</tr>
</tbody>
</table>
</section>
<section class="normative">
<h2>The Verifiable Driver's License AAMVA Vocabulary</h2>
<p>
This vocabulary extends the Verifiable Driver's License Core Vocabulary with
terms for all data elements defined by the mDL Implementation Guidelines issued
by the American Association of Motor Vehicle Administrators (AAMVA). It can be
imported as a JSON-LD context behind the URL
<a href="https://w3id.org/vdl/aamva/v1">https://w3id.org/vdl/aamva/v1</a>.
</p>
<p>
</p>
<table class="simple">
<thead>
<tr>
<th>Identifier</th>
<th>Field Name</th>
<th>Field Description</th>
<th>Data Type</th>
</tr>
</thead>
<tbody>
<tr>
<td>aamva_aka_family_name_v2</td>
<td>Alias / AKA family name</td>
<td>Other family name by which credential holder is known.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a> (latin1, 150 characters maximum)</td>
</tr><tr>
<td>aamva_aka_given_name_v2</td>
<td>Alias / AKA given name</td>
<td>Other given name by which credential holder is known.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a> (latin1, 150 characters maximum)</td>
</tr><tr>
<td>aamva_aka_suffix</td>
<td>Alias / AKA Suffix name</td>
<td>Other suffix by which credential holder is known. Allowed values are <code>JR</code>, <code>SR</code>, <code>1ST</code>, <code>I</code>, <code>2ND</code>, <code>II</code>, <code>3RD</code>, <code>III</code>, <code>4TH</code>, <code>IV</code>, <code>5TH</code>, <code>V</code>, <code>6TH</code>, <code>VI</code>, <code>7TH</code>, <code>VII</code>, <code>8TH</code>, <code>VIII</code>, <code>9TH</code> or <code>IX</code>.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>aamva_cdl_indicator</td>
<td>CDL indicator</td>
<td>FMCSA required field that denotes whether the credential is a <q>Commercial Driver’s License</q> or a <q>Commercial Learner’s Permit</q>. This field is either absent or has value <code>1</code> (Commercial Driver’s License).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32bits unsigned integer number</a></td>
</tr><tr>
<td>aamva_dhs_compliance</td>
<td>Compliance type.</td>
<td>Indicates compliance with REAL ID. Allowed values are <code>F</code> (fully compliant) or <code>N</code> (non-compliant).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>aamva_dhs_compliance_text</td>
<td>Non-REAL ID credential text</td>
<td>Text, agreed on between the Issuing Authority and DHS, appearing on credentials not meeting REAL ID requirements.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>aamva_dhs_temporary_lawful_status</td>
<td>Limited duration document indicator</td>
<td>Denotes whether the credential holder has temporary lawful status. This field is either absent or has value <code>1</code> (temporary lawful status).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32bits unsigned integer number</a></td>
</tr><tr>
<td>aamva_domestic_driving_privileges</td>
<td>Domestic categories of vehicles / restrictions / conditions.</td>
<td>Vehicle types the license holder is authorized to operate.</td>
<td><a href="http://www.w3.org/1999/02/22-rdf-syntax-ns#JSON">JSON</a></td>
</tr><tr>
<td>aamva_edl_credential</td>
<td>EDL indicator</td>
<td>Either absent or has one of the following values if the credential is an EDLc: <code>1</code> (Driver’s license) or <code>2</code> (Identification card).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32bits unsigned integer number</a></td>
</tr><tr>
<td>aamva_family_name_truncation</td>
<td>Family name truncation</td>
<td>Code that indicates whether the field has been truncated (<code>T</code>), has not been truncated (<code>N</code>), or unknown whether truncated (<code>U</code>).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>aamva_given_name_truncation</td>
<td>Given name truncation</td>
<td>Code that indicates whether either the first name or the middle name(s) have been truncated (<code>T</code>), have not been truncated (<code>N</code>), or unknown whether truncated (<code>U</code>).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>aamva_hazmat_endorsement_expiration_date</td>
<td>HAZMAT endorsement expiration date</td>
<td>Date on which the hazardous material endorsement granted by the document is no longer valid.</td>
<td><a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339 full-date</a></td>
</tr><tr>
<td>aamva_name_suffix</td>
<td>Name suffix</td>
<td>Name suffix of the individual that has been issued the credential. Allowed values are <code>JR</code>, <code>SR</code>, <code>1ST</code>, <code>I</code>, <code>2ND</code>, <code>II</code>, <code>3RD</code>, <code>III</code>, <code>4TH</code>, <code>IV</code>, <code>5TH</code>, <code>V</code>, <code>6TH</code>, <code>VI</code>, <code>7TH</code>, <code>VII</code>, <code>8TH</code>, <code>VIII</code>, <code>9TH</code> or <code>IX</code>.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>aamva_organ_donor</td>
<td>Organ donor.</td>
<td>Denotes whether the credential holder is an organ donor. This field is either absent or has value <code>1</code> (Donor).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32bits unsigned integer number</a></td>
</tr><tr>
<td>aamva_race_ethnicity</td>
<td>Race / ethnicity.</td>
<td>Codes for race or ethnicity of the credential holder, as defined in AAMVA D20.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>aamva_resident_county</td>
<td>Resident county</td>
<td>The 3-digit county code of the county where the credential holder lives, as per the 2010 FIPS Codes for Counties and County Equivalent Entities.</td>
<td><a href="http://www.w3.org/2001/XMLSchema#string">String</a></td>
</tr><tr>
<td>aamva_sex</td>
<td>Credential holder’s sex.</td>
<td>In line with the AAMVA Card Design Specification, this element can have one of the following values: <code>1</code> (Male), <code>2</code> (Female) or <code>9</code> (Not Specified).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32bits unsigned integer number</a></td>
</tr><tr>
<td>aamva_veteran</td>
<td>Whether the credential holder is a veteran.</td>
<td>This field is either absent or has value <code>1</code> (Veteran).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32bits unsigned integer number</a></td>
</tr><tr>
<td>aamva_weight_range</td>
<td>Weight range</td>
<td>Indicates the approximate weight range of the credential holder: <code>0</code> (up to 31 kg), <code>1</code> (32 – 45 kg), <code>2</code> (46 - 59 kg), <code>3</code> (60 - 70 kg), <code>4</code> (71 - 86 kg), <code>5</code> (87 - 100 kg), <code>6</code> (101 - 113 kg), <code>7</code> (114 - 127 kg), <code>8</code> (128 – 145 kg), <code>9</code> (146+ kg).</td>
<td><a href="http://www.w3.org/2001/XMLSchema#unsignedInt">32bits unsigned integer number</a></td>
</tr>
</tbody>
</table>
</section>
<section class="informative">
<h2>Privacy Considerations</h2>
<p>
This section details the general privacy considerations and specific
privacy implications of deploying this specification into production
environments.
</p>
</section>
<section class="informative">
<h2>Security Considerations</h2>
<p>
There are a number of security considerations that implementers should
be aware of when processing data described by this specification.
Ignoring or not understanding the implications of this section can
result in security vulnerabilities.
</p>
<p>
While this section attempts to highlight a broad set of security
considerations, it is not a complete list. Implementers are urged to
seek the advice of security and cryptography professionals when
implementing mission critical systems using the technology outlined in
this specification.
</p>
</section>
<section class="informative">
<h2>Accessibility Considerations</h2>
<p>
There are a number of accessibility considerations implementers should
be aware of when processing data described in this specification. As
with any web standards or protocols implementation, ignoring
accessibility issues makes this information unusable to a large subset
of the population. It is important to follow accessibility guidelines
and standards, such as [[WCAG21]], to ensure all people, regardless of
ability, can make use of this data. This is especially important when
establishing systems utilizing cryptography, which have historically
created problems for assistive technologies.
</p>
<p>
This section details the general accessibility considerations to take
into account when utilizing this data model.
</p>
</section>
<section class="informative">
<h2>Internationalization Considerations</h2>
<p>
There are a number of internationalization considerations implementers
should be aware of when publishing data described in this specification.
As with any web standards or protocols implementation, ignoring
internationalization makes it difficult for data to be produced and
consumed across a disparate set of languages and societies, which would
limit the applicability of the specification and significantly diminish
its value as a standard.
</p>
<p>
This section outlines general internationalization considerations to
take into account when utilizing this data model.
</p>
</section>
</body>
</html>