Organizzazioni B2B Multi-Tenant

Il sistema Organizations abilita la multi-tenancy B2B in Auris. Ogni organizzazione rappresenta un’entità cliente — un’azienda, un team o qualsiasi raggruppamento logico — che possiede un insieme di utenti membri, ha le proprie assegnazioni di ruolo e può configurare il proprio provider SSO enterprise. Le organizzazioni sono indipendenti l’una dall’altra: il ruolo di un utente nell’Organizzazione A non ha alcuna influenza sul suo accesso nell’Organizzazione B.

Questo modello è progettato per prodotti SaaS che vendono ad aziende: il tuo singolo tenant Auris ospita più organizzazioni cliente, ciascuna con membership e controllo degli accessi isolati.

Concetti Base

Organizzazione: Un’entità con nome e slug univoco. Le organizzazioni hanno metadati, display name e impostazioni. Sono sempre di proprietà di esattamente un utente (l’OWNER).

Membro dell’Organizzazione: Un utente che appartiene a un’organizzazione con uno di quattro ruoli: OWNER, ADMIN, MEMBER o VIEWER.

Invito: Un invito basato su token con scadenza temporale che consente a un utente (o a un indirizzo email non ancora registrato) di unirsi a un’organizzazione con un ruolo specificato.

SSO per Organizzazione: Ogni organizzazione può configurare il proprio identity provider SAML 2.0 o OIDC. Quando un utente esegue il login con un’email corrispondente a un dominio verificato, Auris lo reindirizza automaticamente all’IdP della sua organizzazione. Vedi Enterprise SSO.

Creazione delle Organizzazioni

Le organizzazioni possono essere create da qualsiasi utente con il permesso appropriato, o programmaticamente tramite il Management SDK.

Body della richiesta:

{
  "name": "Acme Corporation",
  "displayName": "Acme Corp",
  "slug": "acme-corp",
  "metadata": {
    "plan": "enterprise",
    "contractId": "CNT-2025-0042"
  }
}

Riferimento campi:

Ruoli dei Membri

Le organizzazioni usano un sistema di ruoli gerarchici a quattro livelli. I ruoli più alti ereditano tutte le capacità dei ruoli inferiori.

Gestione dei Membri

Risposta:

{
  "data": [
    {
      "userId": "usr_01HX...",
      "email": "[email protected]",
      "firstName": "Alice",
      "lastName": "Rossi",
      "role": "ADMIN",
      "joinedAt": "2025-01-15T10:00:00Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 12, "totalPages": 1 }
}

{
  "userId": "usr_01HX...",
  "role": "MEMBER"
}

Inviti

Gli inviti consentono di aggiungere utenti a un’organizzazione tramite email, anche se non hanno ancora un account Auris. Il flusso di invito:

1. Un ADMIN o OWNER invia un invito a un indirizzo email.
2. Auris genera un token univoco con scadenza temporale e invia un’email con un link di accettazione.
3. L’invitato clicca il link. Se ha già un account Auris, viene aggiunto immediatamente all’organizzazione. In caso contrario, viene invitato a creare un account, dopo il quale l’invito viene accettato.
4. Gli inviti scadono dopo 7 giorni se non accettati.

{
  "email": "[email protected]",
  "role": "MEMBER",
  "message": "Sei stato invitato a unirti ad Acme Corp sulla nostra piattaforma."
}

Stati degli inviti:

Utilizzo con l’SDK

import { useOrganization } from '@auris/react'
 
function OrgDashboard() {
  // Restituisce il contesto dell'organizzazione dalla sessione dell'utente autenticato.
  // L'organizzazione è derivata dai claims del token di accesso.
  const { organization, members, isLoading } = useOrganization()
 
  if (isLoading) return <div>Caricamento...</div>
  if (!organization) return <div>Nessuna organizzazione</div>
 
  return (
    <div>
      <h1>{organization.displayName}</h1>
      <p>Membri: {members.length}</p>
      <ul>
        {members.map((member) => (
          <li key={member.userId}>
            {member.email} — {member.role}
          </li>
        ))}
      </ul>
    </div>
  )
}

import { AurisClient } from '@auris/js'
 
const auris = new AurisClient({
  domain: 'https://auth.tuaapp.com',
})
 
const mgmt = auris.createManagementClient({
  clientId: process.env.AURIS_MGMT_CLIENT_ID,
  clientSecret: process.env.AURIS_MGMT_CLIENT_SECRET,
})
 
// Elenca tutte le organizzazioni
const { data: orgs } = await mgmt.organizations.list()
 
// Ottieni un'organizzazione specifica con i suoi membri
const org = await mgmt.organizations.get('org_01HX...')
const { data: members } = await mgmt.organizations.listMembers('org_01HX...')
 
// Crea un'organizzazione
const newOrg = await mgmt.organizations.create({
  name: 'Nuovo Cliente Srl',
  slug: 'nuovo-cliente',
})
 
// Invita un utente
await mgmt.organizations.createInvitation('org_01HX...', {
  email: '[email protected]',
  role: 'ADMIN',
})

import { createServerManagementClient } from '@auris/nextjs/server'
 
// In un Route Handler
export async function GET(
  request: Request,
  { params }: { params: { orgId: string } }
) {
  const mgmt = createServerManagementClient()
  const org = await mgmt.organizations.get(params.orgId)
  const { data: members } = await mgmt.organizations.listMembers(params.orgId)
 
  return Response.json({ org, members })
}

Metadati dell’Organizzazione

Come gli utenti, le organizzazioni supportano metadati JSON arbitrari. Usali per memorizzare dati specifici dell’applicazione insieme al record dell’organizzazione senza migrazioni di schema.

{
  "metadata": {
    "plan": "enterprise",
    "contractId": "CNT-2025-0042",
    "maxSeats": 250,
    "billingEmail": "[email protected]",
    "features": ["advanced-analytics", "custom-domains", "audit-export"]
  }
}

I metadati vengono restituiti in ogni risposta API dell’organizzazione e sono accessibili nel Management SDK.

Casi d’Uso

Multi-tenancy SaaS: Ciascuno dei tuoi clienti è un’organizzazione. La tua applicazione legge l’organizzazione dell’utente dal suo JWT o sessione e delimita tutte le query ai dati di quell’organizzazione. I nuovi clienti vengono onboarded creando un’organizzazione e invitando il loro amministratore.

Onboarding clienti enterprise: Crea l’organizzazione, aggiungi l’amministratore IT del cliente come OWNER e lascia che gestisca i propri utenti e configuri il proprio SSO aziendale. Il tuo team mantiene la visibilità a livello di tenant tramite la Console Admin.

Soluzioni white-label: Ogni organizzazione cliente può configurare il proprio SSO, la verifica del dominio e il display name. La pagina Hosted Login si adatta al branding per organizzazione quando l’email di un utente corrisponde a un dominio verificato.

Team di prodotto interni: Separa linee di prodotto o business unit in organizzazioni distinte per una gestione isolata dei ruoli, senza mantenere istanze tenant Auris separate.

Permessi Richiesti

Pagine Correlate

• Enterprise SSO per Organizzazione — Configura SSO SAML 2.0 o OIDC per singole organizzazioni
• SCIM 2.0 Provisioning — Automatizza la sincronizzazione dei membri da un IdP esterno
• Ruoli e Permessi — RBAC a livello tenant che complementa i ruoli organizzazione
• Console: Organizzazioni — Guida completa alla Console