Guida

La guida di Symbiont, un'attività alla volta.

La software house e i suoi sviluppatori lavorano nell'applicazione; il sostituto di fiducia utilizza la stessa applicazione, soltanto per i sistemi che gli vengono affidati; i clienti utilizzano il web, senza installare alcun programma. Per ogni attività sono disponibili i passaggi numerati e un breve filmato. La guida è organizzata per ruolo.

Tutti i dati mostrati sono di fantasia: la software house Ferri Digital, il cliente Acme Logistics, le persone e ogni indirizzo.

Per chi dirige la software house

I sistemi, i collaboratori, i clienti e i sostituti: tutto si gestisce dall'applicazione.

1

Primi passi: installazione dell'applicazione e accesso

  1. Dalla pagina Download si scarica l'applicazione: disponibile per Mac; in beta per Windows e Linux.
  2. Si apre l'applicazione e si accede con il proprio account. Una software house che inizia da zero preme Nuova software house? Crea l'account… nella finestra di accesso.
  3. Al primo accesso si assegna un nome al dispositivo e si preme Mostra codice QR; il codice si inquadra con un'applicazione di autenticazione (Google Authenticator, 1Password, Bitwarden o altre).
  4. Si inserisce il codice di 6 cifre e si preme Verifica e attiva. La chiave segreta va conservata, perché compare una sola volta. Da quel momento ogni accesso richiede il codice dell'applicazione di autenticazione.

Subito dopo, la funzione Prepara questo computer configura il computer.

2

Il primo sistema: creazione e collegamento della cartella

  1. Con File → Nuovo sistema… si sceglie il cliente, si assegna un nome e, se disponibile, si indica l'indirizzo del repository, cioè dell'archivio del codice.
  2. Nella sezione Questo computer si preme Collega sulla cartella del progetto (oppure la si trascina sulla finestra). Symbiont salva nella cartella una chiave di invio esclusa da git, le istruzioni per l'assistente di programmazione e, se manca, una prima descrizione del sistema.
  3. Da quel momento si lavora come di consueto: l'assistente di programmazione descrive il sistema in continuity.yaml mentre lo sviluppa e invia la descrizione con dbc manifest push. (dbc, il programma di Symbiont per il terminale, viene installato dall'applicazione.)
  4. Per la CI (integrazione continua), il comando Chiave di invio per la CI… nel menu del sistema crea una chiave da salvare come secret di GitHub, con il comando già pronto.
3

La squadra: ingressi e uscite

  1. Con Squadra → Invita nella squadra si invita un collega, come membro o come titolare. Il link va copiato e inviato: compare una sola volta ed è valido 14 giorni.
  2. Un membro lavora su tutti i sistemi e ne vede la descrizione e la mappa; le chiavi gli vengono concesse dalla finestra Condividi.
  3. Per ogni persona sono elencati i computer collegati, ciascuno con la propria chiave di invio: Revoca ne chiude uno.
  4. Quando un collaboratore lascia la software house, si preme Rimuovi: l'applicazione elenca le operazioni eseguite dalla piattaforma, ciò che resta nel vault e le chiavi da sostituire, da contrassegnare una per una.

Invitare, cambiare ruolo e rimuovere sono operazioni riservate ai titolari. Gli inviti restano in elenco finché non vengono accettati e si possono ritirare.

4

Condividere un sistema con un clic

  1. Si apre il sistema e si preme Condividi… (anche dalla ricerca ⌘K: «Condividi Acme TMS»).
  2. Colleghi: ogni membro vede la descrizione e la mappa. Le chiavi di sviluppo si concedono con un clic e la conferma dell'impronta digitale (Touch ID); le chiavi di produzione si autorizzano sistema per sistema, con un interruttore.
  3. Cliente: le persone che consultano il sistema dal web e le chiavi d'emergenza, consegnate su richiesta.
  4. Controllo: ogni condivisione genera una notifica ai titolari e alla persona interessata, e ogni operazione resta nel registro. Un accesso si può revocare in qualsiasi momento.
5

Il cliente: invito, chiavi d'emergenza, registro

  1. Nella sezione Clienti si apre la scheda del cliente e si preme Invita una persona del cliente, indicando nome e ruolo (il titolare o il referente informatico); poi si preme Crea l'invito. Il link compare una sola volta ed è valido 14 giorni; il cliente crea il proprio account sul web e consulta tutta la documentazione. I consulenti del cliente vengono invitati dal cliente stesso.
  2. Chiavi: una richiesta delle chiavi da parte del cliente si completa automaticamente al termine del periodo di attesa (30 giorni, salvo diverso accordo nel contratto).
  3. Blocca…: si indicano un motivo, che il cliente può leggere, e un numero di giorni, al massimo 30. Per rinnovare il blocco occorre un motivo nuovo.
  4. Sostituto d'emergenza: le ore di attesa senza risposta della software house (48 come impostazione predefinita) e la persona che subentrerebbe. Registro degli accessi: chi ha avuto accesso a che cosa, e quando.

Soltanto un titolare può bloccare o consegnare le chiavi.

6

Il sostituto di fiducia: nominato dalla software house, confermato dal cliente

  1. Con Sostituti → Nuovo sostituto di fiducia… si indicano nome ed email di una persona esterna alla software house (facoltativamente azienda e telefono) e i sistemi affidati. La persona accetta con il link che riceve per email, valido 14 giorni.
  2. Ogni cliente di quei sistemi vede il nominativo nella propria pagina e lo conferma, oppure si oppone indicando un motivo: l'opposizione compare tra le attività da svolgere della software house.
  3. Ogni sei mesi Symbiont chiede al sostituto se è ancora disponibile; in assenza di risposta, lo segnala alla software house.
  4. Quando è necessario si preme Avvia sostituzione…: il sostituto accede alla stessa applicazione, soltanto con i sistemi affidati. Le chiavi di sviluppo gli vengono concesse dal vault; quelle di produzione soltanto se autorizzate per quel sistema.
  5. Con Termina ora… (o alla data di fine) il piano diventa l'elenco delle revoche e dei segreti da sostituire. Il report si esporta in PDF.

Il sostituto non è un membro della software house e non paga alcun costo.

7

Il collegamento di un sistema al suo vault

  1. Nella scheda del cliente, nella sezione Clienti, ogni sistema indica se la piattaforma può consegnare e ritirare automaticamente gli accessi al vault, l'archivio cifrato delle chiavi.
  2. Si propongono l'organizzazione e le raccolte del vault (precompilate da vault.ids in continuity.yaml).
  3. Un amministratore della piattaforma approva il collegamento; da quel momento il vault-gate concede al cliente la raccolta Emergenza alla consegna, e al sostituto la raccolta Sostituto per la durata della sostituzione.
  4. Una sola volta, manualmente nel vault web, si invitano gli account del cliente e del sostituto come User senza raccolte e li si conferma.
8

Sicurezza in pratica

  1. Il secondo fattore. È obbligatorio per i titolari, per i membri e per il sostituto di fiducia; per i clienti è facoltativo, ma consigliato. L'accesso in due passaggi va attivato anche nell'account del vault.
  2. Il vault. Ogni sistema va collegato al suo vault e, nella sezione Squadra, ogni collaboratore indica il proprio account del vault: in questo modo la finestra Condividi conosce gli accessi di ciascuno.
  3. Chi riceve quali chiavi. Ai colleghi si concedono le chiavi di sviluppo dalla finestra Condividi, con l'impronta digitale. Le chiavi di produzione soltanto a chi ne ha bisogno, sistema per sistema. Al sostituto soltanto durante la sostituzione. Al cliente le chiavi d'emergenza, su sua richiesta.
  4. Quando un collaboratore lascia la software house. Con Squadra → Rimuovi le chiavi di invio dei suoi computer vengono revocate, le chiavi di sviluppo vengono ritirate tramite il vault-gate e quelle di produzione vengono contrassegnate «da togliere» dai suoi computer. Si sostituiscono poi le chiavi dell'elenco, una per una, e si rimuove la persona dall'organizzazione nel vault web.

Le ragioni di ogni passaggio, e i limiti, sono descritti nella pagina Sicurezza.

Per chi sviluppa

Si lavora come di consueto con l'assistente di programmazione; Symbiont mantiene in ordine il resto. Questa sezione vale anche per il titolare.

1

Prepara questo computer

  1. Dalla sezione Questo computer (o dal menu File) si apre Prepara questo computer: prima di eseguire qualsiasi operazione, l'applicazione mostra la cartella di base, i passaggi e i sistemi accessibili.
  2. I passaggi vengono poi eseguiti uno dopo l'altro: installazione di dbc, il programma di Symbiont per il terminale; download e collegamento dei sistemi; ripristino delle chiavi di sviluppo dal vault; collegamento dell'assistente di programmazione; installazione dell'agente locale. Ogni passaggio si può ripetere o saltare, e nessun elemento già presente viene sovrascritto.
  3. Da quel momento la sezione Questo computer mantiene in ordine le cartelle dei sistemi (Collega, Scarica dal repository…, Indica la cartella…), dbc e l'assistente di programmazione.

Dal terminale, per un server o per la CI: Download → Per il terminale.

2

La mappa del sistema

  1. Si apre il sistema dalla sezione Sistemi; un doppio clic apre la mappa a tutto schermo. Con Segui le modifiche ogni elemento compare mentre l'assistente di programmazione lavora; ciò che non è ancora stato inviato appare tratteggiato.
  2. Gli elementi aggiunti o modificati sono contrassegnati da confermare: vanno controllati e confermati.
  3. Gli elementi si spostano e si collegano trascinandoli; allo stesso modo si disegnano quelli che il codice non rileva. ⌘Z annulla l'ultima operazione.
  4. Con File → Esporta la mappa si ottiene un file PNG o PDF da mostrare al cliente.
3

Le attività da svolgere

  1. La sezione Da fare elenca ciò che manca ancora (codici di recupero, chiavi d'emergenza, copie di sicurezza), ciascuna voce con i relativi passaggi.
  2. Le attività che richiedono questo computer vengono eseguite dall'agente locale: si esamina il piano, si conferma e si avvia l'esecuzione, che si può seguire e annullare.
  3. Una verifica non riuscita diventa un'attività da svolgere, con il relativo motivo.
  4. L'indicatore di stato accanto a ogni sistema, nella sezione Sistemi, riassume quanto resta da fare.
4

Le verifiche: da ciò che è dichiarato a ciò che è verificato

  1. Il comando Verifica tutto il possibile… controlla, dal computer di chi lavora, certificati, domini, accesso ai repository, connessione ai database e copie di sicurezza.
  2. Ogni verifica indica prima che cosa farà e con quali riferimenti; i valori restano nel vault.
  3. L'indicatore di stato si aggiorna e ogni esito riporta la data e il computer da cui è stata eseguita la verifica.
  4. Un esito è valido 90 giorni; trascorso questo periodo torna tra le attività da svolgere come «da riverificare». Il cliente legge «verificato il … da …» nella propria pagina.
5

Codice e descrizione sempre allineati

  1. Se la cartella del sistema si trova su questo computer, l'applicazione confronta continuamente il codice con continuity.yaml. Il codice non lascia mai il computer.
  2. Ciò che il codice utilizza, ma che nessuno ha descritto, compare nel gruppo Da allineare, con il file e la riga, e sulla mappa in trasparenza, con l'etichetta «trovato nel codice, non descritto».
  3. Per ogni differenza sono disponibili i comandi Apri nel tuo editor, Chiedi all'agente di allinearla, Aggiungi alla descrizione e Ignora.
  4. Gli elementi aggiunti compaiono sulla mappa come «non ancora inviato», finché la descrizione non viene inviata.
6

Le chiavi sul computer, senza copiarle a mano

  1. La scheda Chiavi di un sistema elenca, per nome, ogni chiave descritta in continuity.yaml, e indica, ambiente per ambiente, se è presente su questo computer e nel vault.
  2. Rimetti le chiavi mancanti… le scrive dal vault nel file .env del progetto, escluso da git; Salva nel vault… esegue l'operazione inversa. Certificati e keystore si trascinano sul sistema.
  3. Esegui con le chiavi… apre un terminale che avvia un comando con un valore prelevato dal vault, senza mostrarlo.
  4. Le chiavi di produzione vengono concesse soltanto alle persone autorizzate dal titolare, sistema per sistema, e vengono eliminate automaticamente quando l'autorizzazione termina.

I valori non entrano mai nell'applicazione né nella conversazione con l'assistente di programmazione.

7

Emergenza e lavoro senza connessione

  1. Ogni sistema ha la propria pagina Emergenza: dove è installato, chi contattare, come si ripristina, con le procedure della sua cartella. La pagina si stampa con Stampa… o si salva con Esporta PDF….
  2. File → Esporta il kit d'emergenza… salva un PDF per ogni sistema in una cartella a scelta.
  3. Senza connessione l'applicazione si apre comunque, con la copia cifrata conservata su questo computer; una barra indica a quando risalgono i dati. Le operazioni locali e la ricerca ⌘K continuano a funzionare.
  4. Il comando Scarica tutto per l'uso senza rete (nelle Impostazioni, nel menu File o dalla ricerca ⌘K) prepara la copia prima di una trasferta.
8

App mobile: account degli store, firma e scadenze

  1. Per un'app iOS o Android, la prima descrizione rileva dal progetto il bundle id o il nome del pacchetto.
  2. Si aggiungono il titolare dell'account Apple Developer o Google Play (il cliente o la software house), l'eventuale attivazione di Play App Signing e le date di scadenza di certificati, profili e iscrizione ad Apple.
  3. Certificati, keystore e file di chiavi vengono custoditi nel vault e ripristinati su un computer nuovo insieme alle altre chiavi.
  4. Una scadenza entro 30 giorni genera un avviso; una scadenza superata porta il sistema allo stato rosso. Un'app Android senza Play App Signing è segnalata come problema: lo smarrimento del keystore impedirebbe di aggiornarla.

Per i clienti

Il cliente consulta tutte le informazioni sui propri sistemi dal web, senza installare alcun programma; le chiavi vengono consegnate secondo una procedura stabilita.

1

L'invito e la consultazione della documentazione

  1. Si apre il link inviato dalla software house, si crea il proprio account (o si accede) e si preme Accetta.
  2. La pagina del cliente mostra le chiavi, il sostituto e i sistemi, ciascuno con il proprio indicatore di stato.
  3. Aprendo un sistema si consultano gli intestatari di ciascun servizio, gli accessi d'emergenza, i secondi fattori, i componenti e le verifiche eseguite, con la data. Il file continuity.yaml si può scaricare.
  4. Report apre il report di continuità: sintesi, rischi principali e piano per risolverli.
2

La richiesta delle chiavi

  1. Nella pagina del cliente, nella sezione Le chiavi, si scrive il motivo e si preme Chiedi le chiavi.
  2. La richiesta si completa automaticamente al termine del periodo di attesa previsto dal contratto.
  3. Se la software house ha disposto un blocco motivato, il cliente ne legge il motivo e la scadenza: la richiesta resta in attesa, e un blocco dura al massimo 30 giorni.
  4. Ogni operazione viene annotata nel registro degli accessi, consultabile anche dalla software house.
3

Il sostituto di fiducia e la sua richiesta

  1. Sostituto di fiducia: la pagina del cliente mostra la persona che la software house ha nominato per sostituirla sui suoi sistemi. Il cliente la conferma, oppure si oppone indicando un motivo: finché l'opposizione resta valida, quella persona non può subentrare.
  2. Se un sistema non funziona e nessuno risponde, si selezionano i sistemi interessati, si descrive il problema e si preme Chiedi un sostituto.
  3. La software house riceve un avviso e vede quante ore restano per rispondere.
  4. In assenza di risposta entro le ore di attesa (48 come impostazione predefinita), la piattaforma avvia la sostituzione con il sostituto designato. La richiesta si può ritirare.

Per il sostituto di fiducia

Il sostituto di fiducia è la persona che una software house ha scelto per sostituirla quando necessario. Utilizza la stessa applicazione, soltanto per i sistemi che gli vengono affidati, e non sostiene alcun costo.

1

L'accettazione della nomina

  1. Si apre il link ricevuto per email, valido 14 giorni e soltanto per l'indirizzo indicato, e si crea il proprio account con una password.
  2. Si attiva l'accesso in due passaggi, obbligatorio anche per il sostituto.
  3. Si scarica l'applicazione dalla pagina Download e si accede: si apre la sezione Sostituzione.
  4. Ogni cliente dei sistemi affidati vede il nominativo del sostituto e lo conferma. Ogni sei mesi l'applicazione chiede al sostituto se è ancora disponibile; in assenza di risposta, la software house riceve un avviso.
2

La sostituzione

  1. Quando la software house avvia una sostituzione, il sostituto vede i sistemi interessati; prima della data di inizio, in sola lettura.
  2. Prepara questo computer scarica e collega, con le credenziali git del sostituto, soltanto i sistemi della sostituzione in corso.
  3. Per ogni accesso ricevuto, una volta verificato che funziona, si preme Ho accesso. Da ogni sistema sono disponibili Apri nel terminale e Apri nell'editor.
  4. Le chiavi di sviluppo arrivano soltanto se un titolare le ha concesse nel vault; quelle di produzione soltanto se autorizzate per quel sistema, e soltanto finché la sostituzione è in corso.
3

Al termine, la restituzione degli accessi

  1. Alla data di fine, o quando la software house termina la sostituzione, l'elenco Cosa restituisci riporta gli accessi ricevuti.
  2. Ciascun accesso si conferma con Non ho più accesso.
  3. Il collegamento del computer viene revocato automaticamente; le chiavi di produzione ancora presenti vanno eliminate, e l'applicazione lo ricorda.
  4. La software house vede le conferme nel proprio piano e chiude la sostituzione.
L'icona dell'applicazione Symbiont

Una prova su un sistema reale, gratuita per 30 giorni.

Disponibile per Mac; in beta per Windows e Linux · 30 giorni di prova gratuita, senza carta di credito.