Organizzazione

Cos'è l'organizzazione?

L'organizzazione ti permette di condividere le app con il tuo team, controllando esattamente chi può fare cosa. Ogni account Capgo appartiene ad almeno un'organizzazione e puoi crearne quante ne desideri.

L'accesso è gestito tramite controllo degli accessi basato sui ruoli (RBAC). A ogni membro del team viene assegnato un ruolo — a livello di organizzazione o limitato a una specifica app — che determina cosa può vedere e fare. L'accesso ai Channel può essere ulteriormente personalizzato con permessi specifici per ogni canale.

---

Panoramica delle impostazioni dell'organizzazione

Accedi alla pagina delle impostazioni dell'organizzazione cliccando su Impostazioni nella barra laterale sinistra, quindi selezionando il/la Organizzazione in alto. Da qui, puoi navigare tra le seguenti sezioni:

Scheda	Descrizione
Generali	Visualizza e modifica nome, logo ed email di gestione dell'organizzazione
Membri	Gestisci i membri del team e i loro permessi
Gruppi	Crea e gestisci gruppi di utenti per assegnare i ruoli in blocco
Chiavi API	Gestisci le chiavi API per l'accesso programmatico
Piani	Visualizza e gestisci il tuo piano di abbonamento
Crediti	Visualizza e acquista crediti aggiuntivi
Sicurezza	Configura le policy di sicurezza (2FA, requisiti password)
Utilizzo	Monitora le statistiche di utilizzo della tua organizzazione
Log di audit	Visualizza i log di attività della tua organizzazione
Webhook	Configura le integrazioni webhook
Fatturazione	Gestisci informazioni di fatturazione e fatture

Come cambiare organizzazione

Clicca sul selettore di organizzazione menu a discesa in alto a sinistra nella sidebar per visualizzare e passare tra le organizzazioni a cui hai accesso.

---

Gestione dei membri

Visualizzazione membri

La sezione Members mostra tutti gli utenti che hanno accesso alla tua organizzazione con:

• Membro: Avatar e nome
• Ruolo: Ruolo attuale (Super Admin, Admin, Billing Manager o Member) con un Attivo o In attesa badge
• Azioni: Modifica ruolo, gestisci l'accesso a livello app o rimuovi dall'organizzazione

I membri attivi sono ordinati per priorità di ruolo. Gli inviti in sospeso compaiono con un badge In attesa arancione.

Invitare un membro

1. Clicca sul + Aggiungi pulsante nella sezione Membri
2. Un Seleziona un ruolo apparirà una modale — scegli il ruolo a livello di org per il nuovo membro:

I ruoli disponibili a livello di org sono:

• Membro — Accesso in sola lettura
• Gestione fatturazione — Accesso solo alla fatturazione
• Admin — Amministrazione completa (senza billing o cancellazione)
• Super Admin — Controllo totale

3. Clicca su Verifica, quindi compila il modulo di invito (email, nome/cognome facoltativo, captcha) e clicca su Invia invito.

L'utente invitato riceverà un'email con un magic link. Una volta accettato, verrà aggiunto all'organizzazione con il ruolo selezionato.

Assegnazione dei ruoli a livello di app

Oltre al ruolo a livello di organizzazione, puoi dare a un membro l'accesso a specifiche app con un ruolo più mirato. Clicca sul Controllo degli accessi pulsante (icona scudo) accanto a un membro per aprire la modal di accesso alle app:

Da questa modal puoi:

1. Cercare e selezionare un'app
2. Seleziona un ruolo a livello di app dal menu

I ruoli disponibili a livello di app sono:

• Admin App — Amministrazione completa dell'app
• Sviluppatore App — Upload bundle e gestione device, senza operazioni distruttive
• Uploader App — Lettura dati app e upload bundle
• App Reader — Accesso in sola lettura all'app

3. Clicca su Assegna per assegnare il ruolo.

Modifica del ruolo di un membro

Clicca sull'icona della chiave inglese accanto a un membro per modificarne il ruolo a livello di organizzazione. Lo stesso Seleziona un ruolo modale mostrerà il ruolo attuale già preselezionato.

Constraints:

• Non puoi cambiare il ruolo del creatore dell'organizzazione
• Non puoi rimuovere l'ultimo Super Admin — deve essercene sempre almeno uno
• Per promuovere o declassare un Super Admin, devi essere tu stesso un Super Admin

Rimuovere un membro

Clicca sul pulsante di eliminazione (icona del cestino) accanto a un membro. Comparirà una finestra di conferma che avvisa che l'azione non può essere annullata. Clicca Elimina per confermare. L'operazione revoca immediatamente ogni accesso all'organizzazione, alle sue app e ai suoi canali.

---

Panoramica dei ruoli

Capgo utilizza controllo degli accessi basato sui ruoli con ruoli organizzati per ambito. Puoi assegnare un ruolo a livello organizzazione globale (accesso a tutto), o limitarlo a un singolo app. L'accesso ai canali può essere personalizzato con permessi specifici per ogni canale.

Ruoli dell'organizzazione

Assegnati quando inviti un membro. Si applicano a tutta l'organizzazione.

Ruolo	Nome interno	Descrizione
Super Admin	org_super_admin	Controllo totale — fatturazione, eliminazione, trasferimento. Assegnato automaticamente al creatore dell'org.
Admin	org_admin	Amministrazione completa — gestisci membri, app e canali. Nessun fatturazione, nessuna cancellazione.
Gestione fatturazione	org_billing_admin	Solo fatturazione — visualizza/aggiorna pagamenti, fatture e audit. Nessun accesso ad app o membri.
Membro	org_member	Accesso in sola lettura a tutta l'org e alle sue app.

Ruoli dell'app

Limitato a una singola app. Usa questi ruoli se un membro del team deve lavorare su una sola app, non sull'intera organizzazione.

Ruolo	Nome interno	Descrizione
Admin App	app_admin	Controllo totale di un'app — canali, dispositivi, team. Non può eliminare o trasferire l'app.
Sviluppatore App	app_developer	Carica bundle, gestisci dispositivi, avvia build e aggiorna i canali. Nessuna cancellazione o modifica impostazioni.
App Uploader	app_uploader	Accesso in lettura + upload nuove versioni bundle.
App Reader	app_reader	Sola lettura — stats, bundle, canali, logs, dispositivi.

Override dei permessi del canale

Di default, l'accesso al canale è ereditato dal ruolo dell'app. Puoi sovrascrivere i permessi di canali specifici per utente o gruppo — ad esempio, permettendo a un App Reader di associare bundle sul staging canale. Vedi Gestione accessi a livello di App qui sotto per sapere come configurarlo.

Tip

Per il dettaglio completo dei permessi per ruolo, la gerarchia dei ruoli e l'uso di API/CLI, consulta Riferimento controllo accessi.

---

Gestione accessi a livello di app

Ogni app ha un proprio Accesso scheda dedicata dove puoi gestire chi ha accesso all'app e cosa può fare — inclusi i ruoli dell'app e le sovrascritture dei permessi per canale.

Visualizzazione dell'accesso alle app

Vai alla tua app e clicca su Accesso tab. La lista degli accessi mostra ogni utente o gruppo con:

• Email — l'email dell'utente (o il nome del gruppo)
• Ruolo — il ruolo a livello di app (App Admin, App Developer, App Uploader o App Reader)
• Assegnato il — quando è stato assegnato il ruolo
• Azioni — permessi del canale (icona scudo), modifica ruolo (icona chiave inglese) e rimozione (icona cestino)

Modificare un ruolo dell'app

Clicca sul modifica pulsante (icona chiave inglese) accanto a un utente per cambiare il suo ruolo a livello di app:

Seleziona il nuovo ruolo e clicca su Verifica. I ruoli disponibili sono:

• Sviluppatore App — Carica bundle e gestisce i dispositivi, ma senza operazioni distruttive
• Uploader App — Legge i dati dell'app e carica i bundle
• App Reader — Accesso in sola lettura

Nota

Admin App non è visibile in questa modal perché viene assegnato dalla pagina Members a livello di organizzazione. Vedi Assegnazione dei ruoli a livello di app sopra.

Override dei permessi del canale

Clicca sul permessi del canale pulsante (icona scudo) accanto a un utente per sovrascrivere i permessi del suo canale predefinito:

La modal mostra il ruolo attuale dell'utente nell'app e l'elenco di tutti i canali con tre permessi sovrascrivibili singolarmente:

Permesso	Descrizione
Read	Visualizza il canale e il suo bundle attuale
Cronologia	View the bundle assignment history
Associa bundle	Imposta o cambia il bundle attivo sul canale

Ogni permesso è impostato di default su Default (consenti) — ovvero eredita dal ruolo dell'app. Puoi cambiare ogni permesso in modo esplicito Consenti o Nega per un canale specifico, ottenendo un controllo granulare senza modificare il ruolo dell'app dell'utente.

---

Gruppi

I gruppi ti permettono di assegnare ruoli a un set di utenti in un colpo solo, invece di gestire ogni singolo membro. Un gruppo appartiene a un'organizzazione e può contenere role binding a qualsiasi livello: org o app.

Esempio: Crea un gruppo “QA Team” e assegnagli il Sviluppatore App ruolo sulla tua app in produzione, e ogni membro di quel gruppo ottiene istantaneamente l'accesso Developer a quell'app. Quando qualcuno entra o esce dal team, basta aggiungerlo o rimuoverlo dal gruppo — senza dover modificare i singoli role binding.

Come funzionano i gruppi

• Un gruppo è org-scoped — appartiene a una sola organizzazione e non può estendersi su più org.
• Assegni i ruoli a un gruppo esattamente come faresti con un utente — il gruppo appare come un principal nei role binding.
• Quando vengono controllati i permessi di un utente, le sue appartenenze ai gruppi vengono risolte automaticamente. Se uno dei suoi gruppi possiede un ruolo che concede il permesso richiesto, l'accesso viene autorizzato.
• Un utente può appartenere a più gruppi e i permessi di tutti i gruppi vengono combinati.

Visualizzazione dei gruppi

Navigate to the Gruppi scheda nelle impostazioni dell'organizzazione. L'elenco dei gruppi mostra, per ogni gruppo, nome, descrizione, ruolo, data di creazione, e azioni (modifica o elimina).

Creazione di un gruppo

Clicca sul + Aggiungi pulsante per aprire la pagina di creazione del gruppo:

Compila:

1. Nome (obbligatorio) e Descrizione (opzionale)
2. Ruolo dell'organizzazione — opzionalmente assegna un ruolo a livello di org (None, Admin, Billing Manager o Member)
3. Controllo degli accessi tab — assegna i ruoli a livello di app cliccando + Aggiungi App, selezionando un'app e scegliendo un ruolo (es. App Uploader, App Developer)

Ti serve Super Admin o Admin per creare gruppi.

Gestione dei membri del gruppo

Clicca su un gruppo per aprire la relativa vista dettagli. Passa alla Membri scheda:

Da qui puoi vedere i membri attuali e le loro email. Clicca su + Aggiungi per aggiungere membri:

La finestra modale mostra tutti i membri dell'organizzazione. Cerca per nome, spunta i membri da aggiungere e clicca su Aggiungi membri.

Tip

Per l'uso di API e i dettagli tecnici sui gruppi, consulta Riferimento Access Control — Gruppi.

---

Fatturazione

Solo Super Admin (org_super_admin) e Gestione fatturazione (org_billing_admin) può gestire il billing. I piani sono collegati a un'organizzazione, non al tuo account personale.

Pericolo

L'acquisto di un piano influirà SOLO sull'organizzazione attualmente selezionata.

---

FAQ

Posso creare più di un'organizzazione?

Sì. Puoi creare tutte le organizzazioni che ti servono e passare da una all'altra tramite il selettore delle organizzazioni nella sidebar.

Come configuro le policy di sicurezza?

I Super Admin possono configurare l'obbligo del 2FA, le policy delle password e la sicurezza delle chiavi API dalla Sicurezza scheda. Consulta Sicurezza dell'organizzazione per i dettagli.

Posso dare a qualcuno accesso a una sola app o a un solo canale?

Sì — assegna loro un ruolo specifico per l'app (come Sviluppatore App o App Reader) tramite la pagina Members o la scheda Access dell'app. Puoi affinare l'accesso per singolo canale tramite override dei permessi per canale. Consulta Riferimento controllo accessi per l'elenco completo dei ruoli.

Qual è la differenza tra Admin e App Admin?

Admin (org_admin) ha autorità sull'intera organizzazione: tutte le app, tutti i canali e tutti i membri. Admin App (app_admin) ha lo stesso livello di controllo, ma solo su una specifica app e i suoi canali. Usa App Admin per delegare il controllo completo di un'app senza dare accesso al resto dell'org.

Continua da Organization

Se stai usando Organizzazione per pianificare le operazioni della dashboard e di API, collegalo a Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione delle chiavi API, Dispositivi per i dettagli di implementazione in Devices, e Bundle per il dettaglio di implementazione in Bundles.