Você não implementa esta criptografia por conta própria. O Chat XDK cuida disso. Esta página é para entendimento, não uma lista de verificação de API.
O panorama geral
O X Chat usa um sistema de criptografia em camadas onde:- As mensagens são criptografadas com uma chave da conversa (criptografia simétrica rápida)
- As chaves da conversa são criptografadas para cada participante usando sua chave pública de identidade (troca de chaves assimétrica)
- As 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 com segurança chaves de conversa entre usuários
Quando alguém adiciona você a uma conversa, essa pessoa criptografa a chave da conversa usando sua chave pública de identidade. Apenas sua chave privada de identidade pode descriptografá-la.
As metades públicas são registradas e descobertas por meio das APIs de chave pública da plataforma (veja Chaves de criptografia na referência de API). As metades privadas ficam no Chat XDK (por exemplo, via backup seguro de chave 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 chave pública). 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 da 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ê guarda a chave da conversa em bruto e a usa para criptografia rápida de mensagens (e mídia). A configuração dessas cópias para uma conversa é feita por meio do Chat XDK juntamente com os endpoints de chave de conversa — abordados em Primeiros passos.
Como a criptografia funciona (conceitualmente)
Enviando uma mensagem
1
Comece com texto simples
Você digita: “Olá, tudo bem?”
2
Obtenha a chave da conversa
Seu app usa a chave da conversa em bruto para este chat (obtida na configuração ou em um evento anterior de distribuição de chaves), para a versão de chave correta.
3
Criptografe a mensagem
O Chat XDK criptografa sua mensagem com a chave da 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 deste conteúdo exato.
5
Envie para o X
Seu app envia o payload criptografado e a assinatura para o X por meio do endpoint send message da Chat API. O X armazena e entrega bytes que ele 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 activity stream, ou lendo os eventos da conversa para obter o histórico.
2
Obtenha a chave da conversa
Use sua chave em bruto em cache, ou obtenha-a descriptografando sua cópia a partir de um evento de distribuição de chave (mudança de chave), caso seja nova ou tenha sido rotacionada.
3
Verifique a assinatura
O Chat XDK verifica a assinatura usando a chave pública de assinatura do remetente (e a vinculação de identidade relacionada), para que você saiba quem a enviou e que ela não foi modificada.
4
Descriptografe a mensagem
O Chat XDK descriptografa com a chave da conversa. Agora você pode ler: “Olá, tudo bem?”
Distribuição de chaves explicada
Um desafio central em criptografia de ponta a ponta é a distribuição de chaves: como os participantes obtêm a chave da conversa sem que o X (ou um observador) veja essa chave em texto claro.Configuração inicial da chave
Quando uma conversa é preparada para envio de mensagens:- O Chat XDK gera uma chave de conversa aleatória
- O Chat XDK criptografa essa chave para a chave pública de identidade de cada participante
- Seu app publica essas cópias criptografadas 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 da conversa é rotacionada (por exemplo, quando a composição do grupo 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 da conversa (e a versão)
- Usar a versão mais recente para envios subsequentes
Backup seguro de chave: armazenamento distribuído de chaves
Suas chaves privadas de identidade e assinatura devem ser armazenadas com cuidado. O X Chat inclui um sistema de backup seguro de chave para que as chaves possam ser recuperadas com um código de acesso entre dispositivos, sem que nenhum servidor detenha o segredo completo.O problema com o armazenamento tradicional de chaves
Como o backup seguro de chave resolve isso
O backup seguro de chave combina compartilhamento de segredo com proteção por código de acesso:- As chaves privadas são divididas em partes (shares)
- As partes são mantidas por realms independentes (servidores separados)
- Nenhum realm sozinho tem informação suficiente para reconstruir as chaves
- A recuperação exige seu código de acesso e a cooperação de realms suficientes
- Códigos incorretos têm limitação de taxa para retardar tentativas
Você não configura os servidores de backup de chave manualmente no caminho normal. O Chat XDK inclui o cliente de backup; a configuração dos realms vem da API do X pelo campo
juicebox_config do seu registro de chave pública. 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 em Primeiros passos. Alguns apps (especialmente servidores e bots) usam um blob de chave exportado em vez do backup seguro de chave; proteja esse material como uma senha.Assinaturas explicadas
Toda mensagem do X Chat inclui uma assinatura digital que apoia:- 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 qualquer coisa no material assinado mudar, a verificação falha. Apenas 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 descriptografa as de entrada, comparando com o material de chave pública do remetente (das APIs de chave pública). A verificação é obrigatória por padrão: o SDK rejeita eventos assinados não verificados, a menos que você desabilite explicitamente a checagem (não recomendado). Detalhes estão na referência do Chat XDK. As assinaturas também cobrem conteúdo citado. Uma resposta incorpora a mensagem original assinada em bruto que ela cita; quando o Chat XDK descriptografa a resposta, ele verifica essa original incorporada e compara a citação com ela, reportando o resultado comoreply_preview_validation (Valid / Invalid). Um resultado Invalid significa que a citação não corresponde ao original assinado — trate o material citado como não confiável, mesmo que a resposta em si seja verificada separadamente — para que nenhum participante possa atribuir palavras falsas a outro.
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 própria nova chave da conversa), e a API rejeita a solicitação se as assinaturas estiverem ausentes ou malformadas. Como o servidor nunca detém a chave da conversa em texto claro, 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 à solicitaçã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ção de grupo e adição de membros retornam duas (a mudança de chave mais a ação de grupo), e ambas devem ser enviadas.
As 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 lidar com esses casos.
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
Primeiros passos
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 os eventos criptografados são entregues