Condividere conversazioni e varianti
L’API sharing concede accesso view o edit a una conversazione/variante. I
target possono essere un utente singolo, gruppo, organizzazione, unit o team.
Solo l’owner della conversazione può creare, cambiare, elencare o rimuovere le sue share.
Confine permessi
| Permesso | Comportamento conversazione corrente |
|---|---|
view | Leggere conversazione/variante condivisa e metadati build visibili associati. |
edit | Include modifiche conversazione condivisa e accesso rebuild implementato dalle route conversazione. |
Queste etichette non concedono automaticamente ogni azione downstream. Download artefatto, avvio VM, deploy, billing, segreti e amministrazione organizzazione possono avere controlli owner e entitlement separati. Testa ogni azione richiesta con la sessione del destinatario.
Se la stessa conversazione raggiunge un utente tramite più share, la risposta
accessible-list sceglie il massimo tra view e edit.
Regole target
- Le share utente dirette sono risolte contro membership organizzazione.
- Gruppi, unit e team devono appartenere all’organizzazione rilevante.
- Le share organizzazione raggiungono i membri organizzazione correnti.
- Cambi membership possono cambiare accesso effettivo senza modificare la share.
Non usare una share organizzazione ampia quando basta share utente o team.
Flusso sharing sicuro
- Conferma ID conversazione e suo owner.
- Conferma target destinatario e membership corrente.
- Inizia con
viewsalvo che serva editing. - Crea una share e ispeziona target e permesso restituiti.
- Accedi come destinatario e testa operazioni consentite e negate.
- Rimuovi o riduci accesso quando il task finisce.
- Aggiorna sessione destinatario e ripeti test denied-path.
Non assumere che sia stata inviata email o notifica in-app. Comunica tramite il canale approvato senza includere token o URL artefatto privati.
Comportamento collaborazione
edit è autorizzazione, non risoluzione conflitti. Prima che due persone
modifichino la stessa conversazione, concorda chi possiede la prossima revisione
ricetta e confronta l’output normalizzato con l’intera chat. Un rebuild dovrebbe
essere legato a una ricetta revisionata specifica piuttosto che all’ultima modifica
arrivata.
Revisione e offboarding
Inventaria periodicamente:
- share dirette;
- share ampie gruppo, unit, team e organizzazione;
- membership stale che conferiscono ancora accesso;
- risorse il cui owner originale è uscito; e
- accesso destinatario a build, download e VM vecchi.
Rimuovere una share non elimina necessariamente una copia già scaricata da un destinatario. Gestisci artefatti esportati tramite policy classificazione dati e conservazione.