Documentação / Colaboração e integrações
Live Share
Programe em dupla no mesmo projeto, com criptografia de ponta a ponta, convites de uso único e permissões por convidado. Seus segredos nunca são compartilhados.
O Live Share permite que outra pessoa edite com você o projeto que está aberto: os dois escrevem ao mesmo tempo, veem o cursor um do outro, conversam e podem acompanhar juntos uma sessão de depuração. Não são necessários servidores na nuvem: a conexão é direta entre os dois computadores.
Abra-o com o comando Live Share: programar em dupla (grupo Ferramentas, em Buscar ação, Ctrl+Shift+A). Ele abre em uma aba.
Iniciar uma sessão
- Clique em Compartilhar este projeto.
- Escreva Seu nome.
- Em Compartilhar em, escolha onde escutar: Rede local (com o seu endereço), Outro endereço (VPN)… ou Somente este computador (túnel SSH). O Yuli escuta apenas nessa interface, nunca em todas.
- Escolha as opções: Aprovar cada convidado antes de entrar, Os convidados podem editar e Compartilhar minha sessão de depuração.
- Clique em Começar a compartilhar e envie o convite ao seu colega por um canal de confiança.
- Clique em Entrar em uma sessão.
- Cole o convite que o anfitrião enviou.
- Confirme com o anfitrião que a impressão digital mostrada pelo Yuli coincide com a dele.
- Clique em Entrar. Se o anfitrião aprovar cada convidado, aguarde a resposta (até 120 segundos).
O convite tem este formato:
yuli-live://host:puerto/token#sha256Ele contém o endereço, um token secreto e a impressão digital SHA-256 do certificado da sessão.
Segurança
| Proteção | Detalhe |
|---|---|
| Criptografia | TLS 1.3 com um certificado criado para cada sessão. A sua impressão digital SHA-256 viaja no convite e fica fixada: não é necessária uma autoridade de certificação. |
| Token | 128 bits do gerador aleatório do sistema, de uso único, comparado em tempo constante. |
| Validade | O convite expira em 30 minutos por padrão. |
| Tentativas falhas | Até 5 por endereço e por minuto. |
| Participantes | No máximo 12 por sessão. |
| Tamanho de documento | No máximo 4 MB por arquivo compartilhado. |
Aprovar um convidado
Se você ativou a aprovação, o Yuli avisa: «{nome} quer entrar». Você escolhe:
| Opção | O que acontece |
|---|---|
| Aceitar (somente leitura) | Entra e vê o projeto, sem editar. |
| Aceitar com edição | Entra e pode editar. |
| Recusar | Não entra. |
Permissões por convidado
Durante a sessão, na lista de participantes, você altera as permissões de cada convidado:
| Permissão | Padrão |
|---|---|
| Editar | Conforme você o aceitou. |
| Terminal | Desligado. |
| Expulsar | Remove o convidado da sessão. |
A permissão Terminal dá ao convidado um terminal real no seu computador, com a sua conta. Ative-a apenas com pessoas de total confiança e desligue-a quando não for mais necessária.
As entradas, as expulsões e as alterações de permissões ficam registradas no log de auditoria.
O que é compartilhado
- Edição simultânea dos arquivos do projeto.
- Os cursores de cada participante e Seguir outro participante.
- Um chat da sessão.
- A sua sessão de depuração, se você a compartilhar: a linha em que está parada, a pilha e as variáveis. Os convidados podem pedir passos.
O que nunca é compartilhado
Os segredos, o cofre de credenciais, a pasta .git/ e tudo o que está fora do projeto (inclusive por meio de links simbólicos). Os arquivos ignorados pelo .gitignore, só se o anfitrião os compartilhar. Um arquivo com uma credencial detectada chega aos convidados redigido e somente leitura.