Compartilhando conversas e variants

A API de sharing concede acesso view ou edit a uma conversa/variant. Alvos podem ser usuário individual, group, organization, unit ou team.

Só o owner da conversa pode criar, alterar, listar ou remover seus shares.

Limite de permissão

Esses rótulos não concedem automaticamente toda ação downstream. Download de artefato, launch de VM, deployment, billing, segredos e administração de organização podem ter checagens separadas de owner e entitlement. Teste cada ação necessária com a sessão do próprio destinatário.

Se a mesma conversa chega a um usuário por vários shares, a resposta accessible-list escolhe o maior entre view e edit.

Regras de alvo

• Shares diretos a usuário são resolvidos contra membership na organização.
• Groups, units e teams devem pertencer à organização relevante.
• Shares de organization alcançam membros atuais da organização.
• Mudanças de membership podem alterar acesso efetivo sem editar o share em si.

Não use share amplo de organization quando share de usuário ou team basta.

Fluxo de sharing seguro

1. Confirme o ID da conversa e seu owner.
2. Confirme alvo destinatário e membership atual.
3. Comece com view salvo se edição for necessária.
4. Crie um share e inspecione alvo e permissão retornados.
5. Faça sign-in como destinatário e teste operações permitidas e negadas.
6. Remova ou reduza acesso quando a tarefa terminar.
7. Atualize a sessão do destinatário e repita o teste de caminho negado.

Não assuma que email ou notificação in-app foi enviada. Comunique pelo canal aprovado sem incluir tokens ou URLs de artefato privado.

Comportamento de colaboração

edit é autorização, não resolução de conflito. Antes de duas pessoas alterarem a mesma conversa, combinem quem possui a próxima revisão da receita e comparem a saída normalizada com o chat completo. Rebuild deve estar ligado a receita revisada específica, não ao edit que chegou por último.

Revisão e offboarding

Periodicamente inventarie:

• shares diretos;
• shares amplos de group, unit, team e organization;
• memberships stale que ainda conferem acesso;
• recursos cujo owner original saiu; e
• acesso do destinatário a builds, downloads e VMs antigos.

Remover share não necessariamente deleta cópia já baixada pelo destinatário. Trate artefatos exportados pela política de classificação e retenção de dados.