- 
                Notifications
    
You must be signed in to change notification settings  - Fork 17
 
feat: [AIDX-130] add notification channel settings content updates #189
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: feat/connected_accounts_doc_updates
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | 
|---|---|---|
| 
          
            
          
           | 
    @@ -66,6 +66,26 @@ The flow generally proceeds as follows: | |
| </Step> | ||
| </Steps> | ||
| 
     | 
||
| ## User consent and Notification Channel Selection | ||
| 
     | 
||
| When sending the backchannel authorization request, Auth0 must decide the appropriate notification channel when reaching the user for approval. These are the currently available options (in order of preference): | ||
| 
     | 
||
| 1. **MFA Push Notification**: Challenge MFA Push factor which sends a push notification to the user's enrolled device. Authentication and authorization happens in the device that received the notification. | ||
| 2. **Email**: Sends an email to a verified address associated to the user. The email contains a link and authentication & authorization happens in the browser. | ||
| 
     | 
||
| <Note> | ||
| **Enterprise Feature:** Email notifications for asynchronous authorization are now available for Enterprise plans. | ||
| </Note> | ||
| 
     | 
||
| The selection logic of the channel will be by the order in the list above. However, there are factors that may influence the decision. | ||
| - The **Auth0 client's notification channel**: within the Auth0 application details screen, notification channels can be enabled or disabled for asynchronous authorization requests. These will configure the client's `async_approval_notification_channels` array setting. Currently available options are `guardian-push` and `email`. | ||
| - **Requested expiry**: when the agent's backend specifies a *requested expiry* greater than 5 minutes, MFA Push notification becomes a non-eligible option. | ||
| - **MFA configuration at the tenant level**: a MFA Push Notification channel must be configured for the tenant for this notification channel to be selected. See more details [here](https://auth0.com/docs/secure/multi-factor-authentication/auth0-guardian#enroll-in-push-notifications) about configuring your tenant to use Auth0 Guardian with push notifications. (***note***: *only the Auth0 Guardian push factor is supported at this time.*) | ||
| - **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. | ||
| 
     | 
||
| 
         There was a problem hiding this comment. Choose a reason for hiding this commentThe 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: should a flow diagram also be added?  | 
||
| ## Get started | ||
| 
     | 
||
| To begin using Asynchronous Authorization in your AI agents, refer to the following resources: | ||
| 
          
            
          
           | 
    ||
| Original file line number | Diff line number | Diff line change | 
|---|---|---|
| 
          
            
          
           | 
    @@ -47,6 +47,22 @@ export const Prerequisites = ({ | |
| type. | ||
| </Step>, | ||
| 
     | 
||
| <Step title="Configure Notification Channel settings"> | ||
| Configure the notification channels (such as email or push notifications) for your Auth0 Application. Go to{" "} | ||
| <strong> | ||
| Applications > [Your Application] > Settings > Client-Initiated Backchannel Authentication (CIBA) section > | ||
| </strong>{" "} | ||
| and enable the{" "} notification channel(s) to use with the asynchronous authorization requests for this application. | ||
| 
     | 
||
| To learn more about <strong>configuring notification channels</strong> and using the <strong>requested expiry</strong> setting, read the {" "} | ||
| <a | ||
| href="/ai/docs/intro/asynchronous-authorization#user-consent-and-notification-channel-selection" | ||
| target="_self" | ||
| > | ||
| Asynchronous Authorization | ||
| </a> | ||
| {" "} documentation. | ||
| </Step>, | ||
| 
         There was a problem hiding this comment. Choose a reason for hiding this commentThe 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.  | 
||
| <Step title="Enable Guardian Push"> | ||
| Enable Mutli-factor authentication (MFA) with Guardian Push Notifications | ||
| for your Auth0 tenant. To learn more about MFA with Guardian, read the{" "} | ||
| 
          
            
          
           | 
    ||
There was a problem hiding this comment.
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 ?