Organizzazione
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Cos'è l'organizzazione?
Sezione intitolata âCosâè unâ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
Sezione intitolata âPanoramica delle impostazioni dellâ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:
| Scheda | Descrizione |
|---|---|
| Generali | Visualizza e modifica nome, logo e email di gestione dell'organizzazione |
| Membri | Gestisci i membri del team e le loro autorizzazioni |
| 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 le informazioni di fatturazione e le fatture |
Come cambiare organizzazione
Sezione intitolata âCome cambiare organizzazioneâ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.
Gestione dei membri
Sezione intitolata âGestione dei membriâVisualizzazione membri
Sezione intitolata â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 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.
Invitare un membro
Sezione intitolata âInvitare un membroâ- Clicca sul + Aggiungi pulsante nella sezione Membri
- Un Seleziona un ruolo VerrĂ visualizzata una modale: scegli il ruolo a livello di organizzazione per il nuovo membro:

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
- 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.
Assegnazione dei ruoli a livello di app
Sezione intitolata âAssegnazione di ruoli a livello di appâ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:

Da questa modale puoi:
- Cercare e selezionare un'app
- Scegli un ruolo a livello di app dal menu a tendina

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
- Clicca su Assegna per assegnare il ruolo.
Modifica del ruolo di un membro
Sezione intitolata â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
Sezione intitolata âRimozione di 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
Sezione intitolata â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 manifest. L'accesso ai canali può essere ulteriormente personalizzato con override dei permessi per canale.
Ruoli dell'organizzazione
Sezione intitolata âRuoli dell'organizzazioneâAssegnato quando inviti un membro. Si applica a tutta l'organizzazione.
| Ruolo | Nome interno | Descrizione |
|---|---|---|
| Super Admin | org_super_admin | Controllo completo â fatturazione, eliminazione, trasferimento. Concesso automaticamente al creatore dell'organizzazione. |
| Admin | org_admin | Amministrazione completa â gestione di membri, app e canali. Nessuna fatturazione, nessuna eliminazione. |
| Responsabile fatturazione | org_billing_admin | Solo fatturazione â visualizza/aggiorna pagamenti, fatture e audit di fatturazione. Nessun accesso alle app o ai membri. |
| Membro | org_member | Accesso in sola lettura per l'intera organizzazione e tutte le sue app. |
Ruoli dell'app
Sezione intitolata âRuoli appâLimitati a una singola app. Usali quando un membro del team deve lavorare su una sola app e non sull'intera organizzazione.
| Ruolo | Nome interno | Descrizione |
|---|---|---|
| Admin App | app_admin | Controllo completo su un'app â canali, dispositivi, team. Non può eliminare o trasferire l'app. |
| Sviluppatore App | app_developer | Carica bundle, gestisci dispositivi, avvia build, aggiorna canali. Nessuna eliminazione o modifica delle impostazioni. |
| App Uploader | app_uploader | Accesso in lettura + upload di nuove versioni dei bundle. |
| App Reader | app_reader | Solo lettura â statistiche, bundle, canali, log, dispositivi. |
Override dei permessi dei canali
Sezione intitolata âOverride dei permessi dei canaliâ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.
Gestione dell'accesso a livello di app
Sezione intitolata âGestione dell'accesso a livello di appâ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â
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
Sezione intitolata âModifica di un ruolo appâClicca sul modifica pulsante (icona chiave inglese) accanto a un utente per modificarne il ruolo a livello di 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
Override dei permessi del canale
Sezione intitolata âSovrascrittura dei permessi del canaleâClicca sul permessi del canale pulsante (icona scudo) accanto a un utente per sovrascrivere i permessi del canale predefinito:

Il modale mostra il ruolo app corrente dell'utente ed elenca tutti i canali con tre permessi che possono essere sovrascritti singolarmente:
| Permesso | Descrizione |
|---|---|
| Lettura | Visualizza il canale e il bundle attuale |
| Cronologia | Visualizza lo storico delle assegnazioni bundle |
| Associa bundle | Imposta 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.
Come funzionano i gruppi
Sezione intitolata âCome funzionano i gruppiâ- 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.
Visualizzazione dei gruppi
Sezione intitolata â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
Sezione intitolata âCreare un gruppoâClicca sul + Aggiungi pulsante per aprire la pagina di creazione del gruppo:

Compila:
- Nome (obbligatorio) e Descrizione (opzionale)
- Ruolo dell'organizzazione â assegna facoltativamente un ruolo a livello di organizzazione (None, Admin, Billing Manager o Member)
- 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.
Gestione dei membri del gruppo
Sezione intitolata â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.
Fatturazione
Sezione intitolata âFatturazioneâ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.
Posso creare piĂš di un'organizzazione?
Sezione intitolata â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?
Sezione intitolata â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?
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.
Qual è la differenza tra Admin e App Admin?
Sezione intitolata â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
Sezione intitolata â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.