Prepare-se para a descontinuação dos cookies de terceiros

Aviso: o Chrome anunciou que os cookies de terceiros (3P) não serão mais descontinuados. As orientações descritas aqui não são mais necessárias, e os complementos não serão afetados no início de 2025. No entanto, o Chrome pretende aumentar ainda mais a escolha do usuário em relação aos cookies de terceiros. Portanto, pode haver um futuro em que o acesso a esses cookies seja mais limitado do que é hoje. Portanto, este guia ainda pode ser útil para desenvolvedores interessados em entender como os cookies de terceiros são usados em complementos e se preparar para possíveis mudanças na disponibilidade desses cookies à medida que a experiência do usuário do Chrome evolui.

Este guia ajuda você a entender o impacto e as mudanças necessárias no seu complemento introduzidas pelo fim do suporte do Chrome para cookies de terceiros.

Visão geral

Em 4 de janeiro de 2024, o Chrome lançou a Proteção antirrastreamento, que restringe o acesso de sites a cookies de terceiros (3P) por padrão para 1% dos usuários. No início de 2025, o Chrome espera desativar completamente os cookies de terceiros.

Pelo menos duas jornadas do usuário são afetadas nos complementos do Google Sala de Aula:

1. O fluxo de logon único (SSO) do Google
2. Abrir usuários em novas guias

SSO do Google

Durante o fluxo do SSO do Google, os usuários são direcionados a uma caixa de diálogo para fazer login na Conta do Google e autorizar o compartilhamento de dados.

Figura 1. Visualização dos três contextos de cookies diferentes durante o SSO em um iframe: (1) o app Sala de Aula de nível superior, (2) o iframe incorporado de terceiros (DavidPuzzle no localhost neste caso) e (3) a caixa de diálogo OAuth de nível superior.

Em uma implementação típica de complemento, um cookie de sessão é definido na conclusão desse processo de login. O iframe do complemento, que está em um contexto incorporado, é recarregado, agora com o cookie de sessão, permitindo que o usuário acesse a sessão autenticada. No entanto, quando os cookies de terceiros são desativados, os sites em um contexto incorporado, como iframes de complementos, não podem acessar cookies dos respectivos contextos de nível superior. Para complementos do Google Sala de Aula, o usuário não consegue acessar a sessão autenticada e fica preso em um loop de login.

Para implementações que definem o cookie de sessão no contexto do iframe incorporado, esse problema pode ser atenuado pela API CHIPS, que permite que sites incorporados definam e acessem cookies particionados (cookies com chave no incorporador e no domínio incorporado). No entanto, as implementações que definem o cookie de sessão no contexto de nível superior da caixa de diálogo de login não conseguem acessar o cookie não particionado no iframe, impedindo o login.

Novas guias

Por motivos semelhantes, se um usuário tiver uma sessão autenticada baseada em cookies em um iframe de complemento e o iframe iniciar o usuário em uma nova guia de nível superior para uma atividade, a guia de nível superior não poderá acessar o cookie de sessão particionado do iframe. Isso impede que o estado da sessão do iframe persista na atividade da nova guia e pode forçar o usuário a fazer login novamente na nova guia, por exemplo. A API CHIPS não consegue resolver esse problema por design. Os cookies de iframe particionados são inacessíveis em um contexto de nível superior.

Ações do desenvolvedor

Há algumas ações que você precisa considerar para garantir que seu complemento continue funcionando conforme o esperado à medida que o Chrome desativa os cookies de terceiros.

1. Audite o uso de cookies de terceiros nas jornadas essenciais do usuário do seu complemento. Mais especificamente, teste com cookies de terceiros desativados para avaliar o impacto na sua implementação específica.

2. Conheça a API Storage Access. Para todas as implementações de complementos, recomendamos que você conheça a API Storage Access (SAA). Com a SAA, os iframes podem acessar os cookies fora do contexto do iframe. O SAA já está disponível no Chrome e é compatível com o app Google Sala de Aula.

   Observação: se o fluxo de SSO não definir cookies no contexto da caixa de diálogo e o complemento não iniciar os usuários em guias de nível superior, talvez você não precise do SAA. Conheça a API CHIPS mais simples para saber se ela atende às suas necessidades.

3. Ative o FedCM. Além disso, se você usa o GIS, a biblioteca "Fazer login com o Google", a orientação oficial da equipe de identidade é ativar o FedCM. Isso não substitui os recursos de cookies de terceiros, mas será necessário no GIS como parte da descontinuação dos cookies de terceiros. O FedCM já está disponível no Chrome e é compatível com o Google Sala de Aula, mas o comportamento e os recursos ainda estão em desenvolvimento e abertos a feedback.

4. Migrar para o GIS. Se você usa a biblioteca GSIv2 descontinuada, também conhecida como biblioteca Google Sign-In, recomendamos migrar para GIS, já que o suporte para GSIv2 no futuro não está claro.

5. Solicite um atraso no teste de suspensão. O Chrome está oferecendo um teste de descontinuação para permitir que casos de uso que não sejam de publicidade atrasem os efeitos da descontinuação do cookie de terceiros. Se aceito, você vai receber um token que pode usar no complemento para manter os cookies de terceiros ativados para sua origem até 2024, enquanto migra para uma solução de longo prazo, como o SAA. Depois de fazer a inscrição, você vai precisar fornecer um ID de bug ou um link para um relatório de falha. Nossa equipe já enviou isso para os complementos do Google Sala de Aula, e você pode fornecer este bug.

Aviso: os desenvolvedores aceitos no teste de descontinuação terão os cookies de terceiros ativados automaticamente durante um período de carência, mesmo sem o token no app. Esteja ciente dessa ressalva se quiser usar a descontinuação de 1% para testar como o complemento funciona sem cookies de terceiros.

Observação: o teste de descontinuação é destinado a aplicativos existentes. Se você estiver criando um complemento hoje, planeje usar o SAA ou outra implementação que permita que o complemento funcione sem cookies de terceiros. Talvez você não se qualifique para o teste de descontinuação se ainda não tiver um aplicativo afetado.

Observação: o Chrome anunciou uma mudança no cronograma da desativação gradual dos cookies de terceiros, que passou do segundo semestre de 2024 para o início de 2025. Essa mudança pode afetar a duração do teste de descontinuação, e esta página será atualizada para refletir as mudanças.