asgardeo / asgardeo/javascript

feat: support for organization discovery strategies

Aperta
#124 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
TypeScript
Stelle
18
Fork
67
Merge medio
4h 6m
PR unite (30g)
13

Descrizione

### Problem

Currently, Asgardeo SDK users need to manually specify the `organizationHandle` in their configuration when implementing B2B authentication flows. This creates several challenges:

1. **Manual Configuration**: Developers must hardcode organization handles or implement custom logic to extract them from URLs
2. **Limited URL Support**: No built-in support for common B2B URL patterns like:
- Path-based: `/o/{orgHandle}` or `/o/{orgId}`
- Query-based: `/?o={orgHandle}` or `/?o={orgId}`
- Subdomain-based: `{orgHandle}.example.com`
3. **Repetitive Implementation**: Each application needs to implement similar organization extraction logic
4. **Error-Prone**: Manual extraction is susceptible to bugs and inconsistencies across applications

### Proposed Solution

Implement automatic **Organization Discovery Strategies** that can extract organization handles from URLs and automatically inject them into authentication requests as `signInOptions={{ fidp: 'OrganizationSSO', orgId: '' }}`.

**URL Path Strategy** (`urlPath`):

- Extracts from patterns: `/o/{handle}`, `/o/{id}`
- Example: `https://app.com/o/acme-corp` → `acme-corp`

**URL Query Strategy** (`urlQuery`):

- Extracts from query parameters: `?o={handle}`, `?org={handle}`
- Example: `https://app.com/?o=acme-corp` → `acme-corp`

**Subdomain Strategy** (`subdomain`):

- Extracts from subdomain patterns: `{handle}.domain.com`
- Example: `https://acme-corp.app.com` → `acme-corp`

**Base URL Strategy** (`baseUrl`):

- Extracts from the configured baseUrl pattern
- Example: `baseUrl: "https://api.asgardeo.io/t/acme-corp"` → `acme-corp`

### Alternatives

_No response_

### Please select the package issue is related to

@asgardeo/express, @asgardeo/javascript

### Version

0.1.12

### Reporter Checklist

- [x] I have searched the existing issues and this is not a duplicate.
- [x] I have provided all the necessary information.
- [x] I have verified the feature on the latest version of the package.

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia individuando la configurazione di organizationHandle e la gestione di signInOptions nei pacchetti @asgardeo/express e @asgardeo/javascript. Verifica in che modo ciascuna strategia URL proposta dovrebbe estrarre un handle o un ID e come il valore individuato dovrebbe essere inserito nelle richieste di autenticazione. Il lavoro è completato quando le strategie funzionano con i pattern URL elencati in entrambi i pacchetti correlati.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
express, typescript
Ambito
authentication, backend
Tipo di issue
Funzionalità
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.