Vai al contenuto

Organizzazione

L’organizzazione ti consente 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 servono.

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 un’app specifica — che determina cosa può vedere e fare. L’accesso ai canali può essere ulteriormente regolato con override delle autorizzazioni per canale.


Panoramica impostazioni organizzazione

La pagina Impostazioni organizzazione si apre facendo clic su Impostazioni nella barra laterale sinistra, quindi selezionando la Organizzazione scheda in alto. Da lĂŹ puoi navigare tra le seguenti sezioni:

SchedaDescrizione
GeneraliVisualizza e modifica nome, logo e email di gestione dell'organizzazione
MembriGestisci i membri del team e le loro autorizzazioni
GruppiCrea e gestisci gruppi di utenti per assegnare i ruoli in blocco
Chiavi APIGestisci le chiavi API per l'accesso programmatico
PianiVisualizza e gestisci il tuo piano di abbonamento
CreditiVisualizza e acquista crediti aggiuntivi
SicurezzaConfigura le policy di sicurezza (2FA, requisiti password)
UtilizzoMonitora le statistiche di utilizzo della tua organizzazione
Log di auditVisualizza i log di attivitĂ  della tua organizzazione
WebhookConfigura le integrazioni webhook
FatturazioneGestisci le informazioni di fatturazione e le fatture

Clicca sul selettore di organizzazione menu a tendina in alto a sinistra nella barra laterale per visualizzare e cambiare tra le organizzazioni a cui hai accesso.


Elenco membri dell'organizzazione

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 oppure 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.

  1. Clicca sul + Aggiungi pulsante nella sezione Membri
  2. Un Seleziona un ruolo VerrĂ  visualizzata una modale: scegli il ruolo a livello di organizzazione per il nuovo membro:
Modale di selezione del ruolo

The available org-level roles are:

  • Membro — Accesso in sola lettura
  • Responsabile fatturazione — Accesso solo alla fatturazione
  • Admin — Amministrazione completa (senza fatturazione, senza eliminazione)
  • Super Admin — Controllo completo
  1. Clicca su Verifica, quindi compila il modulo d'invito (email, nome e cognome facoltativi, captcha) e fai clic su Invia invito.

L'utente invitato riceverĂ  un'email con un magic link. Quando lo accetta, verrĂ  aggiunto all'organizzazione con il ruolo selezionato.

Oltre al ruolo a livello di organizzazione, puoi concedere a un membro l'accesso ad app specifiche con un ruolo piĂš mirato. Clicca su Controllo degli accessi pulsante (icona a scudo) accanto a un membro per aprire la modale di accesso alle app:

Modale di controllo accessi

Da questa modale puoi:

  1. Cercare e selezionare un'app
  2. Scegli un ruolo a livello di app dal menu a tendina
Menu a tendina dei ruoli app

I ruoli a livello di app disponibili sono:

  • Admin App — Amministrazione completa di un'app
  • Sviluppatore App — Upload di bundle, gestione dei dispositivi, ma nessuna operazione distruttiva
  • App Uploader — Lettura dei dati dell'app e upload di bundle
  • App Reader — Accesso in sola lettura a un'app
  1. Clicca su Assegna per assegnare il ruolo.

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
Dialogo di conferma eliminazione

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.


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 manifest. L'accesso ai canali può essere ulteriormente personalizzato con override dei permessi per canale.

Assegnato quando inviti un membro. Si applica a tutta l'organizzazione.

RuoloNome internoDescrizione
Super Adminorg_super_adminControllo completo — fatturazione, eliminazione, trasferimento. Concesso automaticamente al creatore dell'organizzazione.
Adminorg_adminAmministrazione completa — gestione di membri, app e canali. Nessuna fatturazione, nessuna eliminazione.
Responsabile fatturazioneorg_billing_adminSolo fatturazione — visualizza/aggiorna pagamenti, fatture e audit di fatturazione. Nessun accesso alle app o ai membri.
Membroorg_memberAccesso in sola lettura per l'intera organizzazione e tutte le sue app.

Limitati a una singola app. Usali quando un membro del team deve lavorare su una sola app e non sull'intera organizzazione.

RuoloNome internoDescrizione
Admin Appapp_adminControllo completo su un'app — canali, dispositivi, team. Non può eliminare o trasferire l'app.
Sviluppatore Appapp_developerCarica bundle, gestisci dispositivi, avvia build, aggiorna canali. Nessuna eliminazione o modifica delle impostazioni.
App Uploaderapp_uploaderAccesso in lettura + upload di nuove versioni dei bundle.
App Readerapp_readerSolo lettura — statistiche, bundle, canali, log, dispositivi.

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


Ogni app ha una scheda dedicata Accesso dove puoi gestire chi ha accesso all'app e cosa può fare, inclusi i ruoli dell'app e gli override dei permessi per canale.

Visualizzazione dell'accesso alle app

Section titled “Viewing app access”
Scheda App Access

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)

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

Seleziona un ruolo app

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

  • Sviluppatore App — Upload di bundle, gestione dei dispositivi, ma nessuna operazione distruttiva
  • App Uploader — Lettura dei dati dell'app e upload di bundle
  • App Reader — Accesso in sola lettura

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

Modale permessi canale

Il modale mostra il ruolo app corrente dell'utente ed elenca tutti i canali con tre permessi che possono essere sovrascritti singolarmente:

PermessoDescrizione
LetturaVisualizza il canale e il bundle attuale
CronologiaVisualizza lo storico delle assegnazioni bundle
Associa bundleImposta o cambia il bundle attivo sul canale

Ogni permesso è impostato di default su Predefinito (consenti) — il che significa che eredita dal ruolo dell'app. Puoi modificare qualsiasi autorizzazione in modo esplicito Consenti oppure Nega per un canale specifico, ottenendo un controllo granulare senza modificare il ruolo complessivo dell'app dell'utente.


I gruppi ti consentono di assegnare ruoli a un insieme di utenti in un'unica operazione, invece di gestire ogni membro singolarmente. Un gruppo appartiene a un'organizzazione e può contenere binding di ruolo a qualsiasi scope — org o app.

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

  • Un gruppo è org-scoped — appartiene a un'unica organizzazione e non può estendersi a piĂš org.
  • Assegni i ruoli a un gruppo allo stesso modo in cui li assegni a un utente: il gruppo appare come principal nei binding di ruolo.
  • Quando vengono verificate le autorizzazioni di un utente, le sue appartenenze ai gruppi vengono risolte automaticamente. Se uno dei suoi gruppi possiede un ruolo che concede l'autorizzazione richiesta, l'accesso viene concesso.
  • Un utente può appartenere a piĂš gruppi e le autorizzazioni di tutti i gruppi vengono combinate.
Elenco 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).

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

Pagina di creazione del gruppo

Compila:

  1. Nome (obbligatorio) e Descrizione (opzionale)
  2. Ruolo dell'organizzazione — assegna facoltativamente un ruolo a livello di organizzazione (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 oppure Admin per creare gruppi.

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

Dettaglio gruppo — Tab Membri

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

Aggiungi membri al gruppo

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


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


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

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?

Sezione intitolata “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 oppure 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.

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.

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.