Gestire l'organizzazione nella finestra di amministrazione

La finestra di amministrazione permette a proprietari, amministratori e responsabili della fatturazione di gestire un'organizzazione con piano team: membri e inviti, gruppi e ruoli personalizzati, criteri, connessioni, utilizzo e fatturazione e registro di controllo. Si apre all'indirizzo https://cloud.altifigence.com/admin ed è separata dalle Impostazioni, che contengono le impostazioni personali e dell'app.

I ruoli indicati di seguito descrivono i permessi predefiniti. Ogni organizzazione può personalizzare i permessi di amministrazione; le sezioni e le azioni disponibili dipendono dai tuoi permessi effettivi. Vedi Permessi di amministrazione personalizzati.

Chi può aprire la finestra di amministrazione

La finestra di amministrazione è destinata alle organizzazioni con piano team (tipo di account Business o Academic). Le sezioni che si aprono dipendono dai tuoi permessi effettivi nell'organizzazione che gestisci. La tabella mostra le impostazioni predefinite, prima che l'organizzazione personalizzi i permessi.

La finestra mostra solo ciò che i tuoi permessi effettivi consentono e il servizio account verifica nuovamente ogni richiesta: modificare l'indirizzo non concede l'accesso.

I ruoli di base sono:

I ruoli personalizzati aggiungono permessi a una persona o a un gruppo (vedi Gruppi e ruoli personalizzati). Le impostazioni dei permessi specifiche dell'organizzazione e le assegnazioni personalizzate possono cambiare le sezioni e le azioni di amministrazione che un membro può utilizzare. Non concedono accesso ai contenuti dei progetti privati. I permessi del ruolo Proprietario non possono essere ridotti.

Aprire la finestra di amministrazione

1. Accedi ad Altifigence Cloud e verifica in quale organizzazione stai lavorando.

2. Apri il menu dell'account (il tuo nome nel pannello di navigazione) e scegli Amministrazione dell'organizzazione. Puoi anche aprire Impostazioni e scegliere Amministrazione dell'organizzazione, elencata insieme a Progetti, Dispositivi connessi e Accesso sviluppatore, oppure andare all'indirizzo https://cloud.altifigence.com/admin.

3. La finestra di amministrazione si apre a schermo intero con un menu a sinistra. La barra superiore mostra l'organizzazione gestita e il tuo ruolo. Usa il selettore dell'organizzazione per passare da un'organizzazione team all'altra. Scegli Torna a Cloud per tornare indietro.

Se Cloud usa un'organizzazione diversa da quella che vuoi gestire, la finestra chiede Passare a questa organizzazione in Cloud? Scegli Passa a per l'organizzazione desiderata oppure continua a gestire quella usata da Cloud. Il passaggio cambia l'organizzazione anche nelle altre schede di Cloud aperte.

Nell'app desktop, Amministrazione dell'organizzazione apre la finestra di amministrazione nel browser. Accedi se richiesto.

Le pagine IAM dell'organizzazione sono state spostate nella finestra di amministrazione. In Cloud, i vecchi indirizzi di Panoramica, Membri, Gruppi e Ruoli reindirizzano alla sezione di amministrazione corrispondente per l'organizzazione team selezionata. I vecchi indirizzi dei criteri Agent dell'organizzazione portano a Criteri. Quando viene mostrato un avviso di pagina spostata, il testo è Organization administration has moved e l'azione proposta è Open the admin window. Le organizzazioni personali non hanno una finestra di amministrazione.

Progetti, Dispositivi connessi e Accesso sviluppatore rimangono nelle Impostazioni. In Cloud, un vecchio indirizzo /console/projects o /console/manage/projects passa a Amministrazione dell'organizzazione → Progetti dopo che la lettura dei dati di amministrazione dei progetti riesce per l'organizzazione Business o Academic selezionata; query e frammento vengono conservati. Se la lettura è in attesa o non riesce, la pagina esistente della console rimane aperta. I vecchi indirizzi dei criteri dell'organizzazione passano a Criteri; senza un'organizzazione team aprono /admin per fornire indicazioni. L'app desktop non reindirizza automaticamente questi indirizzi. I portafogli di crediti e gli acquisti rimangono in Fatturazione nella console; i relativi vecchi indirizzi non vengono reindirizzati automaticamente. Usa Utilizzo e Fatturazione nella finestra di amministrazione per i report e la fatturazione dell'organizzazione. La pagina di pagamento per piani e pacchetti di tempo si apre su www.altifigence.com in una nuova finestra o scheda.

La voce Amministrazione dell'organizzazione viene mostrata per ogni ruolo in un'organizzazione Business o Academic. I membri senza permessi di amministrazione vedono la pagina di orientamento; la voce non concede loro permessi di amministrazione.

Le modifiche richiedono un accesso recente

Ogni modifica consentita dai tuoi permessi nella finestra di amministrazione richiede un accesso effettuato negli ultimi 10 minuti. Se il tuo ultimo accesso è meno recente, la finestra ti invia alla pagina di accesso e poi ti riporta alla pagina in cui ti trovavi. A seconda della pagina, la modifica prosegue automaticamente una sola volta oppure ti viene chiesto di ripeterla. Controlla la pagina prima di ripetere una modifica.

Le modifiche a membri, gruppi, ruoli e sicurezza richiedono un motivo di massimo 1.000 caratteri, che viene registrato insieme alla modifica. La pagina Controllo non mostra i motivi. Anche i criteri e le connessioni richiedono un motivo, che però non viene registrato. Non inserire password, chiavi o altre credenziali nei motivi.

Se vedi «Troppe richieste», attendi qualche minuto e riprova.

Panoramica

A cosa serve. Panoramica mostra il piano dell'organizzazione, il numero di posti in uso, il periodo QUOTA corrente (la quota rimanente e la data di azzeramento) e le attività da svolgere: inviti in sospeso e problemi di fatturazione, ad esempio un metodo di pagamento salvato scaduto o un contratto team non attivo. È presente una riga per gli avvisi di sicurezza, ma non è ancora disponibile. Le viste del piano e della QUOTA devono essere abilitate dal servizio.

Chi può usarla. Proprietario, Amministratore e Fatturazione per impostazione predefinita. Compaiono solo le schede consentite dai tuoi permessi di lettura.

Passaggi.

1. Apri la finestra di amministrazione. Panoramica è la prima pagina.

2. Scegli Esamina accanto agli inviti in sospeso per aprire la pagina Inviti.

3. Scegli Apri fatturazione per andare a Fatturazione quando viene mostrato un problema di fatturazione.

Membri e inviti

A cosa serve. Membri elenca le persone dell'organizzazione con il loro ruolo e stato. Da qui puoi invitare persone, cambiare ruoli, sospendere o rimuovere membri, ripristinare un membro, trasferire la proprietà e assegnare ruoli personalizzati. La scheda Posti a pagamento mostra il contratto e l'utilizzo di Standard/Premium quando i livelli sono configurati.

Chi può usarla. Proprietario e Amministratore per impostazione predefinita. Solo il proprietario può trasferire la proprietà.

Invitare un membro

1. Apri Membri e scegli Invita membro.

2. Inserisci l’indirizzo email della persona e scegli Membro, Amministratore o Fatturazione. Scegli A pagamento o Gratuito (sola visualizzazione); per un invito con posto a pagamento, scegli Standard o Premium. Scorri verso il basso per inserire un motivo.

3. Scegli Invia invito.

I nuovi inviti prevedono un posto a pagamento per impostazione predefinita. La persona riceve un'email e accetta l'invito sul sito account. Un invito scade 7 giorni dopo l'invio. Il periodo è fisso e non può essere modificato.

Seguire, inviare di nuovo o annullare gli inviti

1. Apri Membri e scegli Inviti.

2. Leggi lo stato di ogni invito: In sospeso, In attesa di un posto, Accettato, Annullato o Scaduto. Ogni riga mostra anche se l'email è stata inviata e quando scade l'invito.

3. Scegli Invia di nuovo per inviare una nuova email e avviare un nuovo periodo di 7 giorni. Il collegamento precedente smette di funzionare. Attendi un minuto tra gli invii. A uno stesso indirizzo vengono inviate al massimo 5 email di invito al giorno.

4. Scegli Annulla invito per impedire l'accettazione di un invito. Per un invito annullato o scaduto, scegli Invia nuovamente.

Un invito per un posto a pagamento contrassegnato come In attesa di un posto è stato accettato quando tutti i posti a pagamento erano occupati. Rimane in attesa finché non è disponibile capacità per un posto a pagamento (vedi Posti).

Cambiare un ruolo, sospendere o rimuovere un membro

1. Apri Membri e trova la persona. La ricerca nell'elenco dei membri riguarda i membri caricati fino a quel momento; scegli Carica altri per includere i restanti.

2. Scegli Cambia ruolo per impostare Amministratore, Membro o Fatturazione. Il ruolo Proprietario si assegna solo trasferendo la proprietà e nessuno può cambiare il proprio ruolo.

3. Scegli Sospendi per revocare l'accesso. Il membro perde l'accesso e le attività che stava eseguendo nell'organizzazione si interrompono. Se l'interruzione richiede del tempo, un avviso lo segnala e il tentativo viene ripetuto automaticamente.

4. Scegli Rimuovi per rimuovere la persona dall'organizzazione.

5. Inserisci un motivo e conferma.

Il proprietario non può essere sospeso o rimosso. Per cambiare proprietario, trasferisci prima la proprietà.

Ripristinare un membro tramite invito

L'accesso non viene ripristinato direttamente. Un membro sospeso o rimosso può rientrare solo accettando un nuovo invito.

1. Apri Membri e trova il membro sospeso o rimosso.

2. Scegli Ripristina.

3. Scegli il ruolo e il tipo di posto per il nuovo invito e, se è a pagamento, anche il livello. Scorri verso il basso, inserisci un motivo e scegli Invia invito.

4. La persona riceve un invito via email e deve accettarlo sul sito account prima di riottenere l'accesso. Come ogni invito, scade 7 giorni dopo l'invio.

Trasferire la proprietà

Solo il proprietario può farlo.

1. Apri Membri e scegli Trasferisci proprietà accanto a un membro attivo con email verificata.

2. Conferma di aver compreso che non sarai più il proprietario e inserisci un motivo.

3. Scegli Trasferisci proprietà. Il membro diventa il proprietario e tu diventi Amministratore.

Posti

La scheda Posti a pagamento in Membri mostra la capacità contrattuale e, quando disponibili, il periodo dei posti e lo stato del contratto. Mostra anche l'utilizzo di Standard e Premium rispetto al limite di ogni livello. Usa questi conteggi per livello e i posti rimanenti mostrati in Cambia posto per verificare la disponibilità dei posti a pagamento. Cambiare il tipo o il livello del posto di un membro è un'operazione distinta dalla modifica della capacità contrattuale.

Quando tutti i posti a pagamento sono in uso, un invito per un posto a pagamento accettato in quel momento rimane in attesa di capacità disponibile. Passare un membro attivo con un posto a pagamento a Gratuito (sola visualizzazione), sospenderlo o rimuoverlo libera un posto a pagamento. L'avviso di superamento del limite invita a passare i membri a posti gratuiti o a chiedere al proprietario dell'organizzazione di modificare la capacità a pagamento. La capacità contrattuale non si modifica nella finestra di amministrazione.

La scheda avvisa anche del limite complessivo dei posti, di una registrazione dei posti mancante o di un contratto revocato, terminato o non ancora iniziato. Se i limiti dei livelli non sono configurati, mostra I livelli dei posti non sono configurati per questa organizzazione. Contatta il reparto vendite. La scheda non contiene link o moduli di contatto. I numeri nelle schermate sono dati di esempio.

Tipi di posto

• I nuovi invitati ricevono un posto a pagamento per impostazione predefinita. I membri esistenti mantengono il posto a pagamento.

• Per cambiare un posto sono necessari entrambi i permessi Visualizza membri e Gestisci i posti dei membri. Proprietari e amministratori li hanno per impostazione predefinita; possono essere personalizzati per ogni organizzazione.

• Solo i posti a pagamento vengono conteggiati nella capacità dei posti a pagamento.

Per cambiare il tuo posto o quello di un altro membro, apri Membri (/admin/<organization>/members) e scegli Cambia posto nella sua colonna Posto. Seleziona A pagamento o Gratuito (sola visualizzazione). Per A pagamento, scegli Standard o Premium in Livello del posto a pagamento; un livello senza posti disponibili non può essere scelto per una nuova assegnazione. Controlla l'effetto, inserisci il Motivo e scegli Salva posto. È richiesto un accesso recente e il motivo viene registrato nella cronologia delle modifiche. Il ruolo nell'organizzazione rimane invariato.

Selezionare A pagamento spiega che un membro attivo utilizza un posto a pagamento, in base alla capacità disponibile, e mantiene il proprio ruolo nell'organizzazione.

Se la finestra indica Nessun posto è disponibile. o segnala che non ci sono posti disponibili nel livello selezionato, chiudila, aggiorna Membri e riapri Cambia posto quando la capacità è disponibile. Una modifica rifiutata non può essere inviata di nuovo da quella finestra. Nella nuova finestra, scegli un livello con posti disponibili o contatta l'amministratore della tua organizzazione.

La capacità del registro di controllo considera tutti i membri attivi, inclusi i membri con un posto gratuito; vedi Conservazione e capacità del registro di controllo.

Permessi di amministrazione personalizzati

Ogni organizzazione può personalizzare in dettaglio i permessi di amministrazione dei propri ruoli di base e concedere permessi tramite ruoli personalizzati a persone o gruppi.

I permessi del ruolo Proprietario non possono essere ridotti e almeno un proprietario mantiene sempre la gestione dei permessi. Chi gestisce i permessi può concedere solo quelli che possiede. I permessi di amministrazione non concedono accesso ai contenuti dei progetti.

1. Apri Ruoli e trova Permessi di base (/admin/{organization-id}/roles). Serve il permesso Gestisci permessi di base.

2. Seleziona o deseleziona i permessi per Amministratore, Fatturazione e Membro. Proprietario è fisso. I permessi concessi dai ruoli personalizzati continuano ad applicarsi anche se deselezioni il permesso corrispondente del ruolo di base.

3. Scegli Salva modifiche, esamina le modifiche, inserisci un motivo e scegli Salva permessi. Salva al massimo 100 modifiche insieme; aggiorna le associazioni prima di preparare un altro gruppo di modifiche.

4. Se l'accesso o l'organizzazione sono cambiati, scegli Aggiorna associazioni ed elimina bozza, esamina le associazioni correnti e ricomincia.

La navigazione segue i permessi effettivi. Un'assegnazione personalizzata può rendere accessibile la sezione corrispondente, ma entrare in una sezione non concede il permesso di leggerne i dati o di eseguire ogni azione. Una sezione non disponibile porta alla prima sezione utilizzabile; senza alcun permesso di amministrazione, viene mostrata la pagina di orientamento. La modifica dei permessi deve essere abilitata dal servizio prima di poter salvare le modifiche.

Gruppi e ruoli personalizzati

A cosa serve. Un ruolo personalizzato combina permessi esistenti dell'organizzazione. Un gruppo assegna ruoli personalizzati a più membri contemporaneamente. Puoi includere solo i permessi che possiedi.

Chi può usarla. Proprietario e Amministratore per impostazione predefinita.

I permessi riguardano membri e inviti, gruppi e ruoli, gestione dei permessi, cambio dei posti, sicurezza, criteri, connessioni (compreso lo sblocco MCP), amministrazione dei progetti, utilizzo e fatturazione, accesso e impostazioni del registro di controllo. Seleziona i permessi necessari per il lavoro. Le impostazioni predefinite e le protezioni del proprietario sono descritte in Permessi di amministrazione personalizzati.

Creare un ruolo personalizzato.

1. Apri Ruoli e scegli Nuovo ruolo.

2. Inserisci un nome e una descrizione del ruolo e seleziona i permessi.

3. Inserisci un motivo e scegli Crea ruolo.

Usa Modifica per cambiare un ruolo. Rimuovi elimina il ruolo e lo rimuove anche da ogni membro e gruppo a cui è assegnato.

Assegnare un ruolo personalizzato a un membro. Apri Membri, scegli Ruoli personalizzati per la persona, seleziona i ruoli e scegli Salva ruoli. Puoi assegnare solo ruoli di cui possiedi i permessi.

Creare un gruppo.

1. Apri Gruppi e scegli Nuovo gruppo.

2. Inserisci un nome per il gruppo, seleziona i membri attivi da aggiungere e i ruoli personalizzati assegnati dal gruppo.

3. Inserisci un motivo e scegli Crea gruppo.

Usa Modifica per cambiare un gruppo. Rimuovi elimina il gruppo: i suoi membri perdono i permessi assegnati dal gruppo, ma non vengono rimossi dall'organizzazione. La modifica di un gruppo con ruoli personalizzati richiede il permesso di assegnare ruoli personalizzati.

Progetti

A cosa serve. Progetti elenca i progetti dell'organizzazione e ne gestisce la proprietà, l'archiviazione e l'accesso diretto di membri e gruppi quando l'amministrazione dei progetti è abilitata. L'amministrazione dei progetti deve essere abilitata dal servizio.

Chi può usarla. Proprietario e Amministratore per impostazione predefinita. Lettura dei progetti, gestione dei membri, gestione dei gruppi, trasferimento della proprietà e archiviazione hanno permessi distinti e personalizzabili. Leggere l'inventario non concede accesso ai contenuti dei progetti privati.

1. Apri Progetti (/admin/{organization-id}/projects). Usa Cerca progetti per cercare per nome o slug e Tutti, Attivi o Archiviati per filtrare. Scegli Carica altri per altri risultati.

2. Scegli Gestisci accesso su un progetto per aprirne la pagina di amministrazione (/admin/{organization-id}/projects/{project-id}).

3. In Membri, usa Aggiungi membro per assegnare un ruolo nel progetto a un membro attivo dell'organizzazione; usa Cambia ruolo o Rimuovi su una riga esistente. I responsabili della fatturazione non possono essere aggiunti. In Gruppi, usa Aggiungi gruppo e seleziona Editor o Visualizzatore. Un gruppo non può essere proprietario di un progetto. Rimuovere un'assegnazione diretta mantiene gli eventuali accessi tramite gruppi; rimuovere l'assegnazione di un gruppo mantiene le altre assegnazioni.

4. Scegli Trasferisci proprietà. Se il progetto ha più proprietari, seleziona Proprietario cedente; un unico proprietario viene selezionato automaticamente e un progetto senza proprietario non ha un proprietario cedente. Seleziona Nuovo proprietario, inserisci un motivo e conferma. Il precedente proprietario rimane editor. Solo il proprietario dell'organizzazione può trasferire un progetto di sua proprietà.

5. Scegli Archivia progetto e conferma con un motivo. Un progetto archiviato rimane leggibile in Cloud; le scritture sui contenuti si interrompono, mentre la gestione degli accessi rimane disponibile. Ripristina progetto dall'archivio riattiva la modifica per le persone con un ruolo che la consente.

Le azioni compaiono in base ai tuoi permessi. Anche aggiungere persone o gruppi e scegliere un nuovo proprietario richiede il permesso di leggere il relativo elenco di membri o gruppi. Le modifiche richiedono un accesso recente e un motivo. Dopo aver effettuato nuovamente l'accesso, ripeti la modifica al progetto: non viene ripetuta automaticamente. Se un progetto è cambiato mentre lavoravi, chiudi il modulo e ricomincia dalla pagina aggiornata.

Se l'amministrazione dei progetti è disabilitata o il relativo percorso non è ancora disponibile, la pagina ripiega sui progetti di cui fai parte, spiega quali azioni non sono disponibili e propone Apri impostazioni progetto. Gli altri errori del servizio vengono mostrati come errori. Questo comportamento alternativo non dimostra che il servizio di amministrazione completo sia abilitato in produzione. In Cloud, i vecchi indirizzi Progetti delle Impostazioni passano a questa pagina di amministrazione dell'intera organizzazione solo dopo la lettura riuscita dei relativi progetti; se la lettura è in attesa o non riesce, la pagina della console rimane disponibile.

Accesso all'organizzazione

Account supporta l'accesso interno e l'amministrazione dell'organizzazione.

Supporto Single Sign-On e provisioning

Criteri

A cosa serve. Criteri definisce i limiti per tutti nell'organizzazione: accesso ad Agent, strumenti MCP, condivisione e chi può creare progetti. Le restrizioni dell'organizzazione hanno la precedenza sulle preferenze personali e del progetto e vengono applicate dal server, non solo dall'interfaccia. Le impostazioni predefinite personali di Agent rimangono nelle Impostazioni. Le restrizioni dell'organizzazione che si trovavano in Impostazioni, AI sono state spostate qui.

Chi può usarla. Proprietario e Amministratore per impostazione predefinita, in base ai permessi di lettura e aggiornamento dei criteri dell'organizzazione.

Passaggi.

1. Apri Criteri.

2. In Accesso ad Agent:

   • Consenti chiavi API personali (BYOK) permette ai membri di usare le proprie chiavi collegate entro le restrizioni esistenti.

   • Consenti ricerca web permette ai membri di scegliere di effettuare ricerche. Devono comunque fornire gli eventuali consensi richiesti.

   • Livello massimo di permessi di Agent imposta il permesso più elevato che un membro può scegliere: Chiedi, Consenti o Automatico.

3. In Strumenti MCP:

   • Abilita MCP attiva MCP per l'organizzazione. Gli strumenti devono anche essere abilitati nel criterio di connessione e concessi all'organizzazione.

   • Limita agli strumenti selezionati limita MCP agli strumenti selezionati in Strumenti consentiti. Se non selezioni nulla, tutti gli strumenti MCP vengono negati.

   • Strumenti negati ha sempre la precedenza sugli strumenti consentiti.

4. In Condivisione e progetti:

   • Consenti condivisione esterna limita ulteriormente la condivisione dei progetti dove è supportata. Non abilita la condivisione tramite collegamento per le organizzazioni Business o Academic. Attualmente i collegamenti di condivisione possono essere creati solo per progetti di proprietà di organizzazioni personali.

   • Limita creazione di progetti limita la creazione ai ruoli selezionati in Ruoli autorizzati a creare progetti. L'elenco si applica a ogni ruolo, inclusi proprietari e amministratori. Un elenco vuoto nega la creazione a tutti.

5. Apri Restrizioni avanzate di Agent per le regole sui domini e i limiti delle ricerche web, i permessi e i livelli di impegno utilizzabili dai membri, i limiti di output e istruzioni, il contesto del progetto leggibile da Agent e il periodo di conservazione della cronologia. Le restrizioni esistenti rimangono valide e vengono salvati solo i controlli che modifichi.

6. Inserisci un motivo (obbligatorio, massimo 1.000 caratteri) e scegli Salva criteri.

Le scritture automatiche di Agent sono disattivate per impostazione predefinita. Un amministratore autorizzato a gestire i criteri (Proprietario e Amministratore per impostazione predefinita) può abilitarle in Accesso ad Agent → Livello massimo di permessi di Agent, selezionando Automatico. Questo consente scritture automatiche entro i permessi esistenti relativi a progetti, strumenti e scrittura. Anche Restrizioni avanzate di Agent → Permessi di Agent consentiti permette di modificare l'insieme dei permessi consentiti; per abilitare le scritture automatiche deve includere Automatico. Modificare un altro criterio non abilita le scritture automatiche.

La pagina mostra la versione dei criteri e la revisione dell'organizzazione. Se una delle due è cambiata mentre modificavi, ricarica i criteri correnti, controlla le modifiche e salva di nuovo. L'AI fornita dall'azienda compare solo come Agent; i criteri non mostrano mai nomi di modelli.

Connessioni

A cosa serve. Connessioni gestisce gli account di servizio, le chiavi API dell'organizzazione, le connessioni MCP create dai membri e la connessione Git dell'organizzazione.

Chi può usarla. Proprietario e Amministratore per impostazione predefinita. L'organizzazione può personalizzare permessi distinti di lettura e gestione per account di servizio, chiavi API, MCP e Git.

Apri Connessioni e scegli una scheda: Account di servizio, Chiavi API, MCP o Git dell'organizzazione. Gli elenchi di account di servizio, chiavi API e MCP mostrano quando ogni elemento è stato creato e usato l'ultima volta. Ogni modifica richiede un motivo e un accesso recente.

Una chiave viene mostrata una sola volta. Quando ne crei o ruoti una, la pagina mostra Salva la nuova chiave. Copiala e conservala in modo sicuro. Non può essere riletta e non viene mai mostrata negli elenchi o salvata nei log. Se la perdi, ruota la chiave per ottenerne una nuova.

Account di servizio

1. Scegli Crea account di servizio, inserisci un nome e un motivo e conferma. L'ambito consente solo l'accesso in lettura all'organizzazione.

2. Copia la chiave quando viene mostrata, quindi scegli Fatto.

3. Usa Ruota per sostituire le chiavi dell'account di servizio. Tutte le chiavi precedenti smettono di funzionare immediatamente.

4. Usa Revoca per arrestare l'account di servizio. Anche le sue chiavi vengono revocate.

Chiavi API dell'organizzazione

1. Apri Chiavi API e scegli Crea chiave API. Inserisci un nome e un motivo e conferma.

2. Copia la chiave quando viene mostrata, quindi scegli Fatto.

3. Usa Ruota per sostituire una chiave. La chiave precedente smette di funzionare immediatamente. Usa Revoca per disattivare una chiave.

Una chiave concede solo accesso in lettura all'organizzazione. Non concede accesso dal browser o accesso di amministrazione. Per usare una chiave, invia GET /v1/organization-api/organization con Authorization: Bearer <organization API key> all'endpoint configurato dell'API dell'organizzazione. Non inviare cookie, un'intestazione Origin, parametri di query o un corpo della richiesta.

Connessioni MCP

La scheda MCP elenca le connessioni create dai membri dell'organizzazione con Altifigence MCP, indicando il membro, il client, gli ambiti e quando ogni connessione è stata creata, scade ed è stata usata l'ultima volta. I criteri dell'organizzazione rimangono in vigore.

Per terminare una connessione, scegli Revoca accanto ad essa e conferma. Questa azione revoca tutti gli accessi MCP di quel membro nell'organizzazione, compresi quelli già concessi, e non interessa altri membri o altre organizzazioni. Un membro a cui è stato revocato l'accesso rimane bloccato da MCP in questa organizzazione finché un amministratore autorizzato non lo sblocca esplicitamente. Per impostazione predefinita lo sblocco MCP spetta a proprietari e amministratori ed è personalizzabile per ogni organizzazione. Accedere di nuovo, riconnettersi o riattivare Abilita MCP non rimuove questo blocco specifico del membro.

1. Apri Connessioni → MCP (/admin/{organization-id}/connections).

2. Scegli Sblocca accesso MCP. Inserisci l'UUID utente del membro in ID utente del membro e inserisci il Motivo della modifica.

3. Scegli Conferma. Il membro deve fornire un nuovo consenso OAuth. Le vecchie connessioni, i token di accesso, i token di aggiornamento e i consensi non completati rimangono inutilizzabili; continuano ad applicarsi i divieti dei criteri dell'organizzazione e i permessi degli strumenti.

L'azione richiede il permesso Sblocca connessioni MCP. Se la pagina indica che l'API di sblocco non è disponibile, deve essere abilitata prima di poter usare questa azione.

Le connessioni precedenti la cui organizzazione non può essere verificata non vengono elencate, perché non possono essere attribuite all'organizzazione in modo sicuro. Quei membri devono riconnettersi e la riconnessione non rimuove le connessioni precedenti. Se l'elenco segnala che l'inventario è incompleto, passa alla pagina successiva prima di considerarlo completo.

Git dell'organizzazione

Git dell'organizzazione collega un'installazione di GitHub App appartenente alla tua organizzazione. Le connessioni Git personali vengono gestite separatamente.

1. Apri Git dell'organizzazione e scegli Collega GitHub.

2. Inserisci l'ID dell'installazione di GitHub App assegnata alla tua organizzazione, inserisci un motivo e conferma.

3. Per disconnettere, scegli Revoca. Questo blocca la successiva autorizzazione Git dell'organizzazione. I token GitHub già emessi possono rimanere validi fino alla scadenza.

MCP e Git dell'organizzazione richiedono una configurazione per la tua organizzazione. Se uno dei due non è disponibile, la rispettiva scheda lo spiega. Un'installazione di GitHub App deve essere assegnata alla tua organizzazione prima di poterla connettere.

Utilizzo e fatturazione

A cosa serve. Utilizzo mostra la QUOTA dell'organizzazione e il relativo utilizzo per membro, progetto e motore e lo esporta in CSV. Fatturazione mostra il piano, i posti, i metodi di pagamento, i dati di fatturazione e le fatture dell'organizzazione team. Le viste Utilizzo e Fatturazione devono essere abilitate dal servizio.

Chi può usarla. Proprietario, Amministratore e Fatturazione per impostazione predefinita. I permessi di utilizzo e fatturazione sono personalizzabili per ogni organizzazione; Fatturazione ha solo questi permessi di amministrazione per impostazione predefinita. Il tuo abbonamento personale non viene gestito qui: rimane sul sito account e Fatturazione contiene un collegamento Apri sito account per raggiungerlo.

Utilizzo

1. Apri Utilizzo. La scheda QUOTA mostra le quote di QUOTA rimanente, usata e riservata nel periodo corrente e quando si rinnova o si azzera. La QUOTA viene mostrata come frazioni del periodo, non come importi.

2. In Utilizzo per membro, progetto o motore, scegli Membro, Progetto o Motore in Raggruppa utilizzo per. Le righe dei motori mostrano Agent, Runtime del progetto, il nome del motore che ha eseguito un processo, Processo del motore o Altro.

3. Scegli le date Da (UTC) e A (UTC) e scegli Mostra. Scegli un intervallo del report di massimo 92 giorni di calendario UTC, includendo sia la data Da sia la data A. La data A deve essere oggi (UTC) o una data precedente.

4. Leggi le righe: Utilizzi, Crediti addebitati e Ultimo utilizzo. Le colonne Addebitato (USD) e Qualificazione nativa compaiono quando l'intervallo comprende tali addebiti; in quel caso, su schermi larghi fino a circa 1040 pixel, il report mostra ogni riga come un blocco con etichette. Il report termina con un totale. Le righe dei membri mostrano i nomi a chi può leggere i membri, «Tu» sulla propria riga e una chiave breve a tutti gli altri.

5. Con il permesso di esportare l'utilizzo, scegli Esporta CSV per scaricare il report. Il file elenca i membri tramite una chiave pseudonima, senza nome o indirizzo email (il report Membro lo indica sotto il pulsante).

Quando puoi leggere il report, il pulsante CSV compare solo con il permesso di esportare l'utilizzo, un intervallo valido, dati dettagliati di utilizzo disponibili e almeno una riga. Se hai il permesso di esportazione senza il permesso di lettura del report, Esporta CSV è disponibile per un intervallo valido senza mostrare il report; il servizio verifica comunque l'accesso e la disponibilità dei dati dettagliati di utilizzo. Il CSV di utilizzo contiene riepiloghi dei consumi anziché eventi di controllo. Questo download non crea la ricevuta di esportazione della cronologia di controllo descritta in Registro di controllo.

Fatturazione

1. Apri Fatturazione. La scheda Piano e pagamento mostra il piano, il suo stato, la fine del periodo corrente e le eventuali modifiche pianificate.

2. Leggi il riepilogo del contratto dei posti. I piani team e la capacità dei posti a pagamento seguono il tuo contratto. Controlla l'utilizzo di Standard/Premium in Membri per conoscere la disponibilità di ogni livello. Il tipo e il livello del posto di un membro si gestiscono separatamente in Posti.

3. La pagina mostra Piano, Posti, Metodi di pagamento, Dati di fatturazione e Abbonamento personale in questo ordine, in base ai tuoi permessi. In Dati di fatturazione, scegli Modifica accanto a Contatto di fatturazione, Indirizzo o Azienda, modifica quella sezione e scegli Salva. Ogni sezione viene salvata separatamente. Le modifiche si applicano alle fatturazioni future; le fatture esistenti mantengono i dati originali. La pagina mostra anche il prossimo pagamento, quando disponibile.

Metodi di pagamento

1. In Metodi di pagamento, leggi i metodi salvati e la loro scadenza.

2. Scegli Aggiungi o cambia metodo di pagamento, quindi Continua al fornitore di servizi di pagamento. Il fornitore di servizi di pagamento si apre in una nuova scheda e il collegamento funziona per un breve periodo.

3. Per rimuovere un metodo salvato, scegli Elimina e conferma. Un metodo usato da un abbonamento deve prima essere sostituito.

Fatture

1. Apri la scheda Fatture.

2. Leggi data, numero di fattura, importo e stato di ogni fattura. Scegli Carica altri per quelle meno recenti.

3. Scegli Ottieni PDF, quindi Apri PDF. Se un PDF non è pronto, la pagina lo segnala.

Cambiare un metodo di pagamento, eliminarne uno o modificare i dati di fatturazione richiede un accesso effettuato negli ultimi 10 minuti. Se la pagina mostra Accedi di nuovo, scegli questa opzione e ripeti la modifica. Fatturazione non conserva ciò che hai inserito.

I permessi di lettura, esportazione e modifica sono separati. Con il permesso di modifica ma senza quello di lettura, la pagina può consentire di sostituire una sezione di fatturazione senza mostrare i dati salvati oppure di eliminare un metodo di pagamento salvato tramite il suo ID. Segui le indicazioni della pagina sui permessi e sull'aggiornamento prima di apportare una modifica.

Registro di controllo

A cosa serve. Il registro di controllo mostra le attività di gestione e gli eventi di sicurezza dell'organizzazione. Puoi cercare, filtrare ed esportare i dati in CSV o JSON. Non mostra mai indirizzi email, indirizzi IP, contenuti delle richieste o i motivi inseriti dalle persone.

Chi può usarla. Proprietario e Amministratore per impostazione predefinita. Lettura/esportazione del registro e impostazioni del registro hanno permessi separati che l'organizzazione può personalizzare.

Il registro di controllo include le modifiche a membri, inviti, gruppi, ruoli e permessi; le modifiche ad accesso, proprietà e archiviazione dei progetti; le attività relative a criteri e connessioni dell'organizzazione; l'uso registrato delle chiavi API; le modifiche alle impostazioni di controllo; le letture e le esportazioni della cronologia di controllo. Compaiono anche le modifiche ai criteri di sicurezza, le modifiche ai domini e Disconnetti tutti i membri, insieme ai dinieghi di ingresso nell'organizzazione per motivi di sicurezza registrati. Le modifiche ai dati di fatturazione, la rimozione dei metodi di pagamento e le richieste al portale di fatturazione registrano un intento di autorizzazione prima dell'operazione del fornitore e un risultato finale separato una volta conclusa. Un intento non prova che l'operazione del fornitore sia riuscita. Compaiono solo gli eventi esplicitamente associati all'organizzazione; le attività di accesso storiche non pertinenti non vengono assegnate in base all'appartenenza attuale.

Conservazione e capacità del registro di controllo

Il criterio di conservazione dei dati di audit mantiene i record per 5 anni dopo la fine del contratto. L’eliminazione automatica in base al periodo di conservazione è attualmente disattivata, quindi l’impostazione di conservazione non elimina né nasconde i record. L’impostazione di conservazione (valore predefinito: 12 mesi) si applica solo quando viene attivata l’eliminazione automatica in base al periodo di conservazione.

Apri Controllo → Conservazione e capacità del registro di controllo (/admin/{organization-id}/audit; capacità: #capacity). Per vedere impostazioni e utilizzo serve il permesso di lettura delle impostazioni di controllo. Per modificarle serve anche il permesso di gestione delle impostazioni di controllo; il solo permesso di gestione non concede l'accesso in lettura. Il permesso di lettura degli eventi di controllo è separato.

L'impostazione Conservazione dell'organizzazione (mesi) accetta da 1 a 1,200 mesi interi. Capacità per membro (GB) è preimpostata a 1 GB per ogni membro attivo, inclusi quelli gratuiti e a pagamento; 1 GB equivale a 1,000,000,000 byte. Questo conteggio è separato dalla capacità dei posti a pagamento. Capacità sostitutiva dell'organizzazione (GB; lascia vuoto per usare i membri) sostituisce il totale basato sui membri. Rimuovere un membro può ridurre la capacità al di sotto dell'utilizzo memorizzato e non elimina i record esistenti.

Per cambiare queste impostazioni, inserisci un Motivo della modifica, scegli Salva impostazioni, controlla i valori precedenti e nuovi, quindi conferma. Non è ancora possibile ridurre il periodo di conservazione; puoi mantenerlo o aumentarlo. Per salvare occorre aver effettuato l'accesso negli ultimi 10 minuti. Salvare un'impostazione di conservazione non elimina di per sé record né libera spazio; l'eliminazione automatica rimane disattivata.

Utilizzo memorizzato mostra la stima dei GB memorizzati rispetto alla capacità e la percentuale utilizzata. Capacità riservata (separata dall'utilizzo memorizzato) e Margine per la risposta agli incidenti (nella capacità totale) vengono mostrati separatamente. Crescita giornaliera recente (aggiunte lorde) calcola la media dei giorni osservati tra gli ultimi sette giorni UTC completi; esclude oggi e non sottrae le eliminazioni. Meno di sette giorni osservati comportano un'indicazione di scarsa affidabilità. Data prevista di esaurimento (UTC) compare solo quando i dati sono completi, aggiornati e affidabili. Quando questa previsione affidabile scende a sette giorni o meno, la pagina può mostrare Al ritmo attuale, capacità esaurita tra circa {days} giorni. e Vai alle impostazioni di capacità, anche con gli avvisi automatici disattivati. L'utilizzo sconosciuto non è zero; il recupero dei dati storici, l'utilizzo non aggiornato e la cronologia archiviata non disponibile hanno messaggi distinti. Usa Ricarica impostazioni e utilizzo per controllare di nuovo. Un valore Sconosciuto non ha un risultato attuale affidabile: potrebbe non essere ancora stato calcolato oppure un risultato precedente potrebbe essere obsoleto; non significa zero.

L'applicazione del limite di capacità e gli avvisi automatici di previsione sono attualmente disattivati. Se l'utilizzo memorizzato raggiunge la capacità, la pagina spiega che l'applicazione del limite è disattivata; raggiungere il totale visualizzato non significa che la registrazione si sia fermata o che le modifiche amministrative vengano rifiutate. Anche l'archiviazione automatica è disattivata. L'esportazione scarica una copia; non elimina record e non libera capacità.

L'eliminazione automatica in base al periodo di conservazione è disattivata nella build di rilascio. Finché è disattivata, l'impostazione di conservazione non elimina né nasconde i record.

Cercare nel registro di controllo

1. Apri Controllo.

2. Inserisci un termine di ricerca. La ricerca è letterale e riguarda il codice grezzo dell'azione, l'ID dell'autore e l'ID della destinazione. Non cerca negli indirizzi email o nei dettagli degli eventi.

3. Restringi i risultati con Da (incluso) e A (escluso) in UTC, Azione (corrispondenza esatta), UUID utente dell'autore e ID destinazione (corrispondenza esatta). Per Azione, scegli un nome di evento leggibile o inserisci un codice azione esatto (lettere, numeri e _ . : -). Identificatori dell’evento su un evento ne mostra il codice grezzo. Scegli Applica filtri oppure Reimposta per ricominciare.

4. Leggi ogni evento. Il titolo è l'azione in linguaggio semplice, ad esempio Accesso MCP revocato o Membro aggiornato, con l'esito (Operazione riuscita, Operazione non riuscita o Bloccato). Sotto sono indicati il momento dell'evento (UTC), l'autore, la destinazione (tipo e ID), l'origine e, per alcuni eventi, dettagli come il provider o il numero di elementi. Scegli Identificatori dell’evento per vedere l'azione, il tipo di destinazione e l'origine in formato grezzo. Un evento non riconosciuto dalla finestra viene mostrato come Evento sconosciuto. Usa Pagina precedente e Pagina successiva per spostarti.

Le pagine provengono da un'istantanea fissa, mostrata come Istantanea (UTC). Se l'istantanea o il cursore scade, applica di nuovo i filtri per avviare una nuova query.

Esportare il registro di controllo

1. Applica i filtri desiderati.

2. Scegli Scarica pagina CSV o Scarica pagina JSON.

3. Se sono disponibili altre registrazioni, scegli Esporta pagina successiva per la pagina seguente. Un'esportazione non scarica mai da sola l'intera cronologia.

Ogni pagina contiene fino a 1,000 righe e 2 MiB di contenuto UTF-8. Se una pagina è troppo grande, restringi l'intervallo di date o i filtri. Ogni pagina richiede un accesso effettuato negli ultimi 10 minuti. Ogni download registra una ricevuta. L'applicazione del limite di capacità è attualmente disattivata; l'esportazione non libera capacità del registro di controllo. Nel file CSV ogni cella è racchiusa tra virgolette e una cella che inizia con =, +, - o @ riceve un apostrofo iniziale. Le colonne sono id, organizationId, occurredAt, actorUserId, action, targetType, targetId, outcome e details.

La conservazione e la capacità sono descritte in Conservazione e capacità del registro di controllo. L'esportazione non libera spazio.

Messaggi comuni

Guide correlate

Sicurezza dell'account · Account, licenze e fatturazione · Autenticazione MCP · Agent · Piani e prezzi

I prezzi e i posti dei piani team seguono il tuo contratto. Questa guida non indica prezzi.