Skip to content

Conversation

@ajfarkas
Copy link
Contributor

@ajfarkas ajfarkas commented Jan 5, 2026

Relevant Ticket or Conversation:

Portal #60 Easier linking to IAL and AAL values

Description of Changes:

Creation of a new page for the Partnerships team to link to, describing IAL and AAL values (assurance level values). This uses the same partials as the OIDC and SAML authorization pages. This page also includes deprecated values as the protocol pages do.

There is no design or content guide for this page, so please give feedback on any text that is outside of the protocols partials, and on the name and placement of the nav link.

PR Checklist:

  1. Have you linted and tested your code locally prior to submission?
  2. Have you tagged the appropriate dev(s) for review?
  3. Have you linked to any relevant tickets or conversations?

PR Review Standards:

  • Consider using Conventional Comments to ensure that your feedback is clear and actionable.
  • Ideally, PRs should be reviewed by at least 2 team members.
  • All PRs must be approved before being merged.

Authentication Assurance Level determines what second factors are allowed for user sign-in.
{{ aal_values }}

# Deprecated Service Values
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[thought] hmm would it be possible to collapse these in an accordion? my preferences would be for them to be a little hidden (or only available on the oidc/saml specific views)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can collapse these, no problem.
I'm interested in discussing how this page should work: my initial thought was that this should go in the FAQ, but the ticket calls for a separate page. I'm also not too keen on this getting equal billing on the main nav.

At any rate, I'll wait for review from Nick before merging.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i think it would be fine to be in the FAQ page, my desire for this (which was the impetus of the ticket) was to have a "neutral" place to link to rather than one that referenced a specific protocol

Copy link
Contributor

@Sgtpluck Sgtpluck left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

one small thought, but otherwise looks good

@ajfarkas
Copy link
Contributor Author

ajfarkas commented Jan 6, 2026

ok, as discussed in coworking, I've moved the assurance levels info to the overview page ("Integration" in the nav, /overview in the URL).
I've also improved the formatting on other pages where this text exists by constraining it to the proper column width.

href: "#user-flow"
- text: Service provider configuration
href: "#service-provider-configuration"
- text: Service Levels
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The other side nav titles are only 1st word capitalized thought out the dev docs. I'd like to keep that consistent so this should probably be changed. Authentication Assurance Levels should likely be changed too.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll update Service levels. AAL is a proper noun, so I think it should be capitalized.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nope, you were right, NIST uses lowercase for AAL


Authentication Assurance Level determines what second factors are allowed for user sign-in.

{{ aal_values }}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why does {{ type_of_service }} exist in <div class="usa-prose" markdown="1"> but this doesn't? I think it should?

@Jeremy1026 Jeremy1026 self-requested a review January 8, 2026 15:20
@Jeremy1026
Copy link
Contributor

LGTM

@ajfarkas ajfarkas merged commit 7be831b into main Jan 8, 2026
6 checks passed
@ajfarkas ajfarkas deleted the aj/portal-60_link-ial-aal-values branch January 8, 2026 16:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants