Skip to content

Commit 0752742

Browse files
committed
docs: refine passkey ACR/AMR tables with original remarks and layout fixes
Restore original remarks content including login_hint JSON examples for mid_al2_any, mid_al4_any, and mid_al4_passkey rows. Remove AL and Phishing-Resistant columns, optimize icon column widths, fix double horizontal scrollbar issue by overriding VitePress table defaults.
1 parent 68f0e9d commit 0752742

2 files changed

Lines changed: 31 additions & 5 deletions

File tree

docs/.vitepress/theme/custom.css

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,12 @@ body {
5959
margin: 1em 0;
6060
}
6161

62+
.vp-doc table.acr-table,
63+
.vp-doc table.amr-table {
64+
display: table;
65+
overflow: visible;
66+
}
67+
6268
.vp-doc table th,
6369
.vp-doc table td {
6470
white-space: normal;

docs/oidc-integration-guide/passkey-authentication.md

Lines changed: 25 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -236,15 +236,15 @@ The following table shows how passkeys fit into the MobileID Authentication Leve
236236
<th rowspan="2">acr_values</th>
237237
<th colspan="4" style="text-align:center">Authentication Method</th>
238238
<th colspan="2" style="text-align:center">Additional Checks</th>
239-
<th rowspan="2" class="col-icon">NIST<br>AAL3</th>
239+
<th rowspan="2" class="col-icon">NIST-AAL3</th>
240240
<th rowspan="2">Remarks</th>
241241
</tr>
242242
<tr>
243243
<th class="col-icon"><img src="/img/oidc/simkarte_LIGHT.png" width="22" height="22"><br>SIM</th>
244244
<th class="col-icon"><img src="/img/oidc/smartphone_LIGHT_1.png" width="22" height="22"><br>App</th>
245245
<th class="col-icon"><img src="/img/oidc/mobile-message_LIGHT.png" width="22" height="22"><br>OTP</th>
246246
<th class="col-icon"><img src="/img/oidc/passkey-icon-nobg.png" width="22" height="22"><br>Passkey</th>
247-
<th class="col-icon"><img src="/img/oidc/map_pointer_LIGHT.png" width="22" height="22"><br>CH Loc</th>
247+
<th class="col-icon"><img src="/img/oidc/map_pointer_LIGHT.png" width="22" height="22"><br>CH</th>
248248
<th class="col-icon"><img src="/img/oidc/passport_LIGHT.png" width="22" height="22"><br>KeyRing</th>
249249
</tr>
250250
</thead>
@@ -258,7 +258,7 @@ The following table shows how passkeys fit into the MobileID Authentication Leve
258258
<td class="col-icon"><img src="/img/oidc/lightbulb.svg" width="16" height="16"></td>
259259
<td class="col-icon"><img src="/img/oidc/lightbulb.svg" width="16" height="16"></td>
260260
<td class="col-icon"><img src="/img/oidc/lightbulb.svg" width="16" height="16"></td>
261-
<td>Passkey-preferred if <code>passkeys_enabled:true</code>. Fallback to SIM/App/SMS if passkey auth fails.</td>
261+
<td><strong>Passkey-preferred</strong>, if <code>passkeys_enabled:true</code> for the client account.<br><strong>User can select a fallback method</strong> if Passkey Auth fails.<br>Use this AL if UX is more important than security.<br><br>Optional <code>login_hint</code> to provide MSISDN:<br><code class="code-inline">{"enableManualInput": false, "hints": [{"msisdn":"+41765XXXXXX"}]}</code></td>
262262
</tr>
263263
<tr>
264264
<td class="col-acr"><code>mid_al3_any</code></td>
@@ -313,7 +313,7 @@ The following table shows how passkeys fit into the MobileID Authentication Leve
313313
<td class="col-icon"><img src="/img/oidc/lightbulb.svg" width="16" height="16"></td>
314314
<td class="col-icon"><img src="/img/oidc/lightbulb_on.svg" width="16" height="16"></td>
315315
<td class="col-icon"><img src="/img/oidc/lightbulb.svg" width="16" height="16"></td>
316-
<td>Passkey-preferred if <code>passkeys_enabled:true</code>. Fallback to SIM/App. RP must provide <code>sn</code> and <code>keyringId</code> in <code>login_hint</code>.</td>
316+
<td><strong>Passkey-preferred</strong>, if <code>passkeys_enabled:true</code> for the client account.<br>User can select a fallback method if Passkey Auth fails.<br>Use this AL if security is important and phishing risk is acceptable.<br><br>RP must provide <strong>SN</strong> and <strong>KeyRingId</strong> (if Passkey is enabled) in <code>login_hint</code>:<br><code class="code-inline">{"enableManualInput": false, "hints": [{"msisdn":"+41765XXXXXX", "sn":"+574XXXXXX", "keyringId":"MIDPKXXXXXXXXXX"}]}</code></td>
317317
</tr>
318318
<tr>
319319
<td class="col-acr"><code>mid_al4_any_ch</code></td>
@@ -357,7 +357,7 @@ The following table shows how passkeys fit into the MobileID Authentication Leve
357357
<td class="col-icon"><img src="/img/oidc/lightbulb.svg" width="16" height="16"></td>
358358
<td class="col-icon"><img src="/img/oidc/lightbulb_on.svg" width="16" height="16"></td>
359359
<td class="col-icon"><img src="/img/oidc/lightbulb_on.svg" width="16" height="16"></td>
360-
<td><strong>Passkey-only</strong> &amp; phishing-resistant. RP must provide <code>keyringId</code> in <code>login_hint</code>. NIST AAL3 if FIPS 140-2 certified authenticator.</td>
360+
<td><strong>Passkey-only</strong> &amp; <strong>phishing-resistant</strong>.<br>Use this AL if security and phishing-resistance is important, with a trade-off that only Passkeys can be used.<br><br><strong>Optionally</strong>, this scenario may be used to comply with <strong>NIST AAL3</strong>, which requires the user to have a FIPS 140-2 certified authenticator (passkey) registered.<br><br>RP must provide <strong>KeyRingId</strong> in <code>login_hint</code>:<br><code class="code-inline">{"hints": [{"msisdn":"+41765XXXXXX", "keyringId":"MIDPKXXXXXXXXXX"}]}</code></td>
361361
</tr>
362362
</tbody>
363363
</table>
@@ -539,7 +539,10 @@ Start with `mid_al2_any` (passkey-preferred with fallback) for the smoothest use
539539

540540
.acr-table,
541541
.amr-table {
542+
display: table;
543+
overflow: visible;
542544
width: auto;
545+
min-width: 1200px;
543546
border-collapse: collapse;
544547
font-size: 0.9em;
545548
margin-bottom: 20px;
@@ -578,16 +581,33 @@ Start with `mid_al2_any` (passkey-preferred with fallback) for the smoothest use
578581
text-align: center;
579582
white-space: nowrap;
580583
width: 1%;
584+
min-width: 0 !important;
581585
padding: 6px 8px;
582586
}
583587

584588
.col-acr {
585589
white-space: nowrap;
586590
}
587591

592+
.acr-table td:last-child,
593+
.acr-table th:last-child {
594+
min-width: 500px;
595+
}
596+
588597
.acr-table td img,
589598
.amr-table td img {
590599
vertical-align: middle;
591600
display: inline-block;
592601
}
602+
603+
.acr-table .code-inline,
604+
.amr-table .code-inline {
605+
display: block;
606+
margin-top: 4px;
607+
padding: 4px 8px;
608+
background-color: var(--vp-c-bg-soft);
609+
border-radius: 4px;
610+
font-size: 0.82em;
611+
word-break: break-all;
612+
}
593613
</style>

0 commit comments

Comments
 (0)