← Voltar ao blog

CHIPS Serve para o Estado do Embed, Não para Identidade entre Sites

CHIPS cria um cookie jar separado para cada site de nível superior que incorpora um componente. Entenda quando isso ajuda — e por que não fornece uma identidade compartilhada entre terceiros.

Um cookie particionado pode manter um widget incorporado autenticado em um site; ele não pode dar a esse widget uma identidade compartilhada em todos os sites que o incorporam. Essa diferença muda como desenvolvedores devem projetar embeds de chat, pagamento, documentos e provedores de conta.

CHIPS Cria uma Sessão Própria para Cada Site Incorporador

CHIPS (Cookies Having Independent Partitioned State) permite que um embed entre sites opte por armazenamento particionado usando o atributo Partitioned. O navegador associa o cookie ao site que o definiu e ao site de nível superior. Quando o mesmo fornecedor é incorporado em dois sites sem relação entre si, ele recebe dois cookie jars separados — não um jar global do fornecedor.

Por exemplo, support.example incorporado em shop.example pode definir um cookie de sessão restrito àquele contexto:

Set-Cookie: __Host-widget_session=opaque-value; Secure; Path=/; SameSite=None; Partitioned

Essas garantias dependem do suporte do navegador. Um atributo Partitioned não suportado pode ser ignorado, deixando um cookie de terceiros não particionado se o navegador o permitir. Teste cada navegador de destino e não presuma que o atributo, sozinho, garante o isolamento.

O navegador envia esse cookie quando o widget é carregado em shop.example, mas não quando o mesmo widget é carregado em docs.example. O cookie particionado também não se torna universal quando a pessoa visita support.example diretamente. Cada site de nível superior é um contexto separado; portanto, uma primeira visita por outro incorporador começa sem a sessão de widget do site anterior.

Isso é útil quando o componente incorporado precisa de estado local a um único publicador: uma conversa de suporte vinculada àquele site, uma preferência específica do site ou um carrinho pertencente a uma única loja. O embed pode manter estado sem tratar sua presença em sites sem relação como um identificador compartilhado.

Escolha o Cookie de Acordo com o Estado Necessário

Use CHIPS quando a funcionalidade continuar funcionando mesmo que cada site incorporador tenha uma sessão independente. Seu servidor precisa estar preparado para não receber um cookie em um novo site de nível superior e deve criar uma sessão nova, limitada ao embed, em vez de concluir que a pessoa saiu globalmente — ou tentar silenciosamente combinar essa sessão com o estado de outro site.

Não use um cookie particionado como cookie de conta para um serviço que espera reconhecer a mesma pessoa em sites de terceiros sem relação. O navegador impõe o comportamento oposto: a mesma origem de terceiro recebe estados particionados diferentes em contextos distintos. Um widget que precisa de uma conta comum deve obter a identidade por um fluxo separado e explícito.

Essa separação é uma decisão de arquitetura, não um bug a contornar renomeando cookies ou alternando valores. Se a função central de um embed depende da mesma identidade estar disponível em todos os lugares, CHIPS por si só não atende ao requisito. Se apenas o estado local do embed precisa persistir, a partição é mais adequada do que depender de um cookie de terceiros compartilhado entre sites.

Storage Access É um Contrato Diferente

Quando um embed realmente precisa do estado não particionado que estaria disponível em contexto primário — por exemplo, para exibir uma conta em que a pessoa já entrou no próprio site do provedor — a Storage Access API (SAA) oferece outro caminho de solicitação. O documento incorporado pode verificar document.hasStorageAccess() e, quando necessário, chamar document.requestStorageAccess(). Uma concessão diz respeito ao acesso daquele contexto incorporado; ela não transforma cookies CHIPS em um cookie jar compartilhado.

Trate a solicitação como um ramo condicional do fluxo do produto. Navegadores podem exigir ativação do usuário, uma visita anterior ao site primário ou outros critérios de elegibilidade, e a solicitação pode ser negada. As orientações de implementação do WebKit, por exemplo, colocam a solicitação atrás de uma ação do usuário e exigem interação prévia no contexto primário. As políticas variam entre navegadores; um resultado bem-sucedido em um mecanismo não prova que todos os usuários do embed terão acesso.

loginButton.addEventListener("click", async () => {
  try {
    await document.requestStorageAccess();
    await loadAccount();
  } catch {
    showSignedOutExperience();
  }
});

O fallback faz parte da funcionalidade, não é uma tela de erro excepcional. Permita que a pessoa continue usando recursos públicos ou de estado local do embed quando o acesso não estiver disponível e ofereça uma ação clara de login quando forem necessários dados da conta. Lembre também que o acesso ao armazenamento do documento incorporado não anexa automaticamente essa identidade a requisições enviadas para uma API em outra origem.

Teste o Limite, Não Apenas o Caminho Feliz

Teste o mesmo embed em dois sites de nível superior diferentes e confirme que cada um começa com estado independente. Depois, teste o provedor como site primário, uma solicitação SAA negada e as chamadas a APIs de outras origens feitas pelo embed. Inspecione a chave de partição nas ferramentas de desenvolvimento do navegador e verifique quais cookies chegam de fato a cada endpoint.

Esses casos revelam a suposição que costuma quebrar aplicações incorporadas: um componente de terceiros pode estar presente em muitos lugares sem representar a mesma pessoa autenticada em todos eles. Use CHIPS para o estado que pertence a um único site incorporador; use um fluxo de identidade explícito e mediado pela pessoa quando o produto realmente precisar de uma conta compartilhada.

Fontes

Comments

Loading comments…