Skip to content

Commit bc82ebe

Browse files
docs: remove outdated architecture section and consolidate authentication flow descriptions
Jira Ticket: https://linuxfoundation.atlassian.net/browse/LFXV2-888 Assisted by [Claude Code](https://claude.ai/code) Signed-off-by: Mauricio Zanetti Salomao <mauriciozanetti86@gmail.com>
1 parent 5dccc02 commit bc82ebe

File tree

1 file changed

+0
-32
lines changed

1 file changed

+0
-32
lines changed

docs/auth-flows/README.md

Lines changed: 0 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -73,35 +73,3 @@ All Auth0 Management API calls are abstracted through the Auth Service, which co
7373
3. **Email Verification**: Flow E validates the email in `id_token_pwdless` matches the requested email before linking
7474
4. **Token Scoping**: Each access token is scoped to specific audiences and permissions
7575
5. **Abstraction Layer**: Management API calls go through Auth Service, not directly from client
76-
77-
## Architecture Changes (December 2025)
78-
79-
### Consolidation to Regular Web Clients
80-
81-
Based on the PoC implementation in `poc/2025-12-Express-Two-Audiences`, the authentication architecture has been updated to remove the SPA client and consolidate to regular web applications:
82-
83-
**Previous Architecture:**
84-
- LFX One Client (Regular Web) - Main login
85-
- LFX One Profile Client (SPA) - Management API access and social linking
86-
- LFX One Passwordless Client (Regular Web) - Email verification
87-
88-
**Updated Architecture:**
89-
- LFX One Client (Regular Web) - Main login for LFX v2 API access
90-
- LFX One Profile Client (Regular Web) - All Management API operations, social linking, and passwordless flows
91-
92-
### Dual Authentication Pattern
93-
94-
The new architecture implements a dual authentication pattern:
95-
96-
1. **Primary Authentication**: Users first authenticate with the LFX One Client to establish their session and get LFX v2 API access
97-
2. **Secondary Authentication**: When Management API access is needed, users authenticate again with the LFX One Management Client to get audience-specific tokens
98-
99-
This pattern provides better security isolation and allows for different scopes and permissions for different purposes while maintaining a unified user experience.
100-
101-
### Benefits
102-
103-
- **Simplified Architecture**: Fewer clients to manage and configure
104-
- **Better Security**: Clear separation between different token audiences
105-
- **Consistent UX**: All flows use server-side redirects instead of mixed SPA/popup patterns
106-
- **Easier Deployment**: No client-side secret management or CORS concerns
107-

0 commit comments

Comments
 (0)