Skip to content

Conversation

@priley86
Copy link
Contributor

@priley86 priley86 commented Oct 28, 2025

Description

Adds some additional copy around CIBA Notification channels.

Some related PRs:
https://github.com/atko-cic/manhattan/pull/8138
https://github.com/atko-cic/auth0-server/pull/16424

References

JIRA: AIDX-130

Testing

Impacts the following pages:

Asynchronouis Authorization (overview page):
https://auth0-genai-async-auth-updates.mintlify.app/intro/asynchronous-authorization#user-consent-and-notification-channel-selection

Prerequisites (adds "Configure Notification Channel settings" section to all of the Async Authorization quickstarts):
https://auth0-genai-async-auth-updates.mintlify.app/get-started/asynchronous-authorization#prerequisites

Checklist

  • I have added documentation for new/changed functionality in this PR or in auth0.com/docs
  • All active GitHub checks for tests, formatting, and security are passing
  • The correct base branch is being used, if not the default branch

- **User's email verification status**: if the user's email is not verified, we assume sending emails to an unverified email address is not desired, and the request will be rejected.

You can read more about the notification channel selection in the [Configure Client-Initiated Backchannel Authentication](https://auth0.com/docs/get-started/applications/configure-client-initiated-backchannel-authentication) documentation.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This section is largely based on the internal doc here, and needs thorough review:
https://oktawiki.atlassian.net/wiki/spaces/ISGI/pages/3431662076/RFC+CIBA+with+Email+and+SMS#Notification-Channel-Selection

should a flow diagram also be added?

- **User's enrolled authenticators**: if the user is not enrolled to use an MFA push authenticator, the current behavior is to fallback to Email instead of rejecting the request.
- **User's email verification status**: if the user's email is not verified, we assume sending emails to an unverified email address is not desired, and the request will be rejected.

You can read more about the notification channel selection in the [Configure Client-Initiated Backchannel Authentication](https://auth0.com/docs/get-started/applications/configure-client-initiated-backchannel-authentication) documentation.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

are we planning to also enhance this page or any others related to CIBA within Auth0 docs for this @lrzhou25 ?

Asynchronous Authorization
</a>
{" "} documentation.
</Step>,
Copy link
Contributor Author

@priley86 priley86 Oct 28, 2025

Choose a reason for hiding this comment

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

Preference here is to keep updates minimal within the quickstarts, and link back to an overview page about this overfall flow / notification logic. My thinking is this logic could evolve and seems this would be an ok place to make reference to the configuration and allow them to dive further should it be necessary.

@priley86 priley86 changed the base branch from main to feat/connected_accounts_doc_updates October 29, 2025 16:05
@priley86 priley86 changed the base branch from feat/connected_accounts_doc_updates to main October 29, 2025 16:09
@priley86 priley86 changed the base branch from main to feat/connected_accounts_doc_updates October 29, 2025 16:10
@priley86 priley86 changed the base branch from feat/connected_accounts_doc_updates to main October 29, 2025 16:10
@priley86 priley86 changed the base branch from main to feat/connected_accounts_doc_updates October 29, 2025 16:12
@lrzhou25 lrzhou25 force-pushed the feat/connected_accounts_doc_updates branch from 9381d2c to 770d1cb Compare October 29, 2025 17:57
Copy link
Contributor

@pmalouin pmalouin left a comment

Choose a reason for hiding this comment

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

lgtm, would let Lucy also do another pass, but this is great 💪

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants