Você não implementa essa criptografia por conta própria. O Chat XDK cuida disso. Esta página é para entendimento, não uma checklist de API.
O panorama geral
O X Chat usa um sistema de criptografia em camadas onde:- Mensagens são criptografadas com uma chave de conversa (criptografia simétrica rápida)
- Chaves de conversa são criptografadas para cada participante usando sua chave pública de identidade (troca de chaves assimétrica)
- Mensagens são assinadas com a chave de assinatura para que os destinatários possam verificar quem as enviou e que nada foi alterado
Tipos de chave explicados
O X Chat usa três tipos de material de chave, cada um com um propósito específico.1. Par de chaves de identidade
Propósito: Trocar chaves de conversa entre usuários com segurança
Quando alguém adiciona você a uma conversa, essa pessoa criptografa a chave de conversa usando sua chave pública de identidade. Somente sua chave privada de identidade pode descriptografá-la.
As metades públicas são registradas e descobertas por meio das APIs de chaves públicas da plataforma (veja Chaves de criptografia na Referência da API). As metades privadas ficam no Chat XDK (por exemplo via backup seguro de chaves ou um blob de chave cuidadosamente protegido).
2. Par de chaves de assinatura
Propósito: Provar que você é o autor de uma mensagem
Quando você envia uma mensagem, ela é assinada com sua chave privada de assinatura. Os destinatários verificam usando sua chave pública de assinatura (também publicada pelas APIs de chaves públicas). O Chat XDK assina como parte da criptografia de uma mensagem e pode verificar na descriptografia quando você fornece o material de chave pública do remetente.
3. Chave de conversa
Propósito: Criptografar e descriptografar mensagens (e mídia) dentro de uma conversa específica
As chaves de conversa são geradas quando uma conversa é configurada ou quando as chaves são rotacionadas. Cada participante recebe uma cópia criptografada da chave, produzida com sua chave pública de identidade. Depois de descriptografar sua cópia uma vez, você mantém a chave de conversa em bruto e a usa para criptografia rápida de mensagens (e mídia). Configurar essas cópias para uma conversa é feito por meio do Chat XDK junto com os endpoints de chaves de conversa — passo a passo em Guia de introdução.
Como a criptografia funciona (conceitualmente)
Enviando uma mensagem
1
Comece com texto simples
Você digita: “Olá, como você está?”
2
Obtenha a chave de conversa
Seu app usa a chave de conversa em bruto para este chat (da configuração ou de um evento anterior de distribuição de chave), na versão correta da chave.
3
Criptografe a mensagem
O Chat XDK criptografa sua mensagem com a chave de conversa. O resultado é texto cifrado que é inútil sem essa chave.
4
Assine a mensagem
O Chat XDK assina o payload criptografado com sua chave privada de assinatura, provando que você é o autor exato deste conteúdo.
5
Envie ao X
Seu app envia o payload criptografado e a assinatura ao X pelo endpoint send message da Chat API. O X armazena e entrega bytes que não consegue ler em texto simples.
Recebendo uma mensagem
1
Receba os dados criptografados
Seu app recebe texto cifrado do X — via webhooks ou um stream de atividades, ou lendo eventos de conversa para o histórico.
2
Obtenha a chave de conversa
Use sua chave em bruto em cache, ou obtenha-a descriptografando sua cópia de um evento de distribuição (mudança) de chave se esta for nova ou rotacionada.
3
Verifique a assinatura
O Chat XDK verifica a assinatura usando a chave pública de assinatura do remetente (e o vínculo de identidade relacionado), para que você saiba quem enviou e que não foi modificado.
4
Descriptografe a mensagem
O Chat XDK descriptografa com a chave de conversa. Agora você pode ler: “Olá, como você está?”
Distribuição de chaves explicada
Um desafio central na criptografia de ponta a ponta é a distribuição de chaves: como os participantes obtêm a chave de conversa sem que o X (ou um observador) veja essa chave em claro.Configuração inicial de chaves
Quando uma conversa é preparada para mensagens:- Uma chave de conversa aleatória é gerada (no Chat XDK)
- Para cada participante, essa chave é criptografada para sua chave pública de identidade
- Essas cópias criptografadas são armazenadas e entregues por meio das APIs de Chat do X
- Cada participante descriptografa sua cópia com sua chave privada de identidade (no Chat XDK)
Eventos de mudança de chave
Quando a chave de conversa é rotacionada (por exemplo, quando a composição muda), os participantes recebem um evento de mudança de chave com novas cópias criptografadas para cada membro. Seu app deve:- Notar material de mudança de chave em eventos ao vivo ou no histórico da conversa
- Descriptografar e armazenar a nova chave de conversa (e versão)
- Usar a versão mais recente para envios subsequentes
Backup seguro de chaves: armazenamento distribuído de chaves
Suas chaves privadas de identidade e de assinatura precisam ser armazenadas com cuidado. O X Chat inclui um sistema de backup seguro de chaves (implementado com Juicebox) para que as chaves possam ser recuperadas com um código de acesso entre dispositivos sem dar a nenhum servidor o segredo completo.O problema com o armazenamento tradicional de chaves
Como o backup seguro de chaves resolve isso
O backup seguro de chaves combina compartilhamento de segredos com proteção por código de acesso:- As chaves privadas são divididas em partes
- As partes são mantidas por realms independentes (servidores separados)
- Nenhum realm sozinho tem informações suficientes para reconstruir as chaves
- A recuperação requer seu código de acesso e cooperação de realms suficientes
- Códigos de acesso incorretos têm limite de taxa para retardar tentativas
Você não configura os servidores de backup de chaves à mão no fluxo normal. O Chat XDK inclui o cliente de backup; a configuração do realm vem da X API como
juicebox_config no seu registro de chave pública (o campo tem esse nome por causa do Juicebox, a implementação subjacente). O armazenamento inicial do código de acesso e o desbloqueio posterior são chamadas do Chat XDK — veja inicializar com chaves existentes e criar e registrar chaves no Guia de introdução. Alguns apps (especialmente servidores e bots) usam um blob de chave exportado em vez do backup seguro de chaves; proteja esse material como uma senha.Assinaturas explicadas
Toda mensagem do X Chat inclui uma assinatura digital que oferece:- Autenticidade — foi produzida com a chave privada de assinatura do remetente
- Integridade — o conteúdo criptografado não foi modificado após a assinatura
Como as assinaturas funcionam (conceitualmente)
Se algo no material assinado muda, a verificação falha. Somente alguém com a chave privada de assinatura pode produzir uma assinatura válida para essa chave.
No seu app
O Chat XDK assina quando você criptografa mensagens de saída e verifica quando você descriptografa as de entrada, contra o material de chave pública do remetente (das APIs de chaves públicas). A verificação é obrigatória por padrão: o SDK rejeita eventos assinados não verificados a menos que você desative explicitamente a checagem (não recomendado). Detalhes na referência do Chat XDK.Mudanças de estado assinadas (assinaturas de ação)
Mensagens não são o único material assinado. Toda chamada que muda o estado da conversa — adicionar ou rotacionar chaves de conversa, criar um grupo, adicionar membros — deve carregar uma ou mais assinaturas de ação: o remetente assina um payload descrevendo exatamente o que a mudança faz (para uma mudança de chave, esse payload inclui a nova chave de conversa em si), e a API rejeita a requisição se as assinaturas estiverem ausentes ou malformadas. Como o servidor nunca detém a chave de conversa em texto simples, ele não pode verificar criptograficamente a assinatura de uma mudança de chave; ele valida que a descrição assinada e codificada da mudança corresponde à requisição recebida. A verificação criptográfica acontece nas extremidades: o Chat XDK de cada destinatário verifica a assinatura contra a chave pública de assinatura do remetente ao descriptografar o evento de mudança de chave. Os métodosprepare do Chat XDK produzem essas assinaturas para você — criações de grupo e adições de membros retornam duas (a mudança de chave mais a ação de grupo), e ambas precisam ser enviadas.
Assinaturas são vinculadas ao conteúdo do evento e são imutáveis: um evento cuja assinatura não verifica nunca poderá se tornar válido depois. Veja Solução de problemas para saber como tratá-los.
Propriedades de segurança
Contra o que o X Chat protege
Contra o que o X Chat não protege
Glossário
Próximos passos
Guia de introdução
Implemente chaves, envio e recebimento passo a passo
Referência do Chat XDK
Métodos e tipos do SDK de criptografia
Introdução
Visão geral do produto e arquitetura
Eventos em tempo real
Como eventos criptografados são entregues