Shared Signals com o Google Workspace Beta
Receber shared signals no Google Workspace é uma beta fechada na Google, disponível para os clientes Google Workspace Enterprise Plus que são admitidos nela. Do lado do XFA, o Shared Signals está em beta e é ativado por organização, a pedido (ver a visão geral).
Nota: este guia parte do princípio de que tem uma conta XFA configurada para a sua organização e de que é administrador dessa organização no XFA e super administrador na Google Admin console. Se não tiver conta, pode criar uma em https://dashboard.xfa.tech/signup.
O que a Google faz
O recetor da Google só suporta o evento CAEP session-revoked. Quando um dispositivo da sua organização fica não conforme (ver o que significa "não conforme"), o XFA envia à Google um evento session-revoked para o utilizador, e a Google termina a sessão do utilizador no Google Workspace. Quando o dispositivo volta a estar em conformidade, nada é enviado: o utilizador simplesmente inicia sessão de novo.
Uma sessão revogada só mantém o dispositivo de fora se o próximo início de sessão for verificado pelo XFA. Configure o XFA como identity provider do Google Workspace para os utilizadores que abrange; caso contrário, o utilizador volta a iniciar sessão no mesmo dispositivo não conforme.
1. Pedir acesso à Google
Peça à sua equipa de conta da Google que admita o seu tenant do Workspace na beta do recetor Shared Signals, indicando o XFA como transmissor. Assim que for admitido, a Google indica-lhe onde, na Admin console, se configura o transmissor.
2. Adicionar a ligação Google Workspace no XFA
- No painel XFA, abra Segurança de dispositivos > Shared Signals.
- Clique em Adicionar ligação.
- Introduza um Nome, por exemplo
Google Workspace, e escolha Google Workspace como Recetor. - Clique em Adicionar ligação.
- Copie o token da caixa de diálogo. É mostrado uma única vez; se o perder, use Rodar token na ligação e introduza o novo token na Google.
Na secção Transmissor, no topo da página, copie o URL do transmissor (https://ssf.xfa.tech) e o URL de configuração well-known (https://ssf.xfa.tech/.well-known/ssf-configuration).
3. Adicionar o XFA como transmissor na Google
Na Google Admin console, registe o XFA como transmissor Shared Signals com o URL well-known e o token do passo anterior. A Google cria o stream com o XFA e envia ao XFA o seu endpoint de entrega.
Os eventos que o XFA envia à Google são dirigidos à audiência que a Google exige:
https://sharedsignals.googleapis.com
Não tem de definir isto você mesmo; é a predefinição de uma ligação Google Workspace. O utilizador em cada evento é identificado pelo e-mail, por isso o e-mail do utilizador no XFA tem de corresponder à conta Google Workspace.
Assim que a Google tiver criado o stream, este aparece na ligação, na página Shared Signals, com o seu estado e a hora e o resultado da última entrega.
4. Verificar com um evento de teste
Na página Shared Signals, encontre o stream na sua ligação Google Workspace e clique em Enviar evento de teste. O XFA envia um evento de verificação SSF pelo stream e mostra o resultado da entrega no stream.
Para ver uma revogação real, deixe um dispositivo de um utilizador de teste falhar uma verificação que bloqueia numa política associada a uma das suas aplicações: em minutos, a sessão do utilizador no Google Workspace é terminada, e iniciar sessão de novo através do XFA fica bloqueado até o dispositivo ser corrigido.
Resolução de problemas
- O stream mostra uma entrega falhada: o stream mostra o erro devolvido pela Google. As entregas são repetidas em erros temporários.
- A Google não consegue ligar-se ao XFA: confirme o URL well-known e o token. Um token rodado substitui o anterior de imediato, por isso introduza o novo token na Google.
- A sessão do utilizador não é terminada: confirme que o e-mail do utilizador no XFA corresponde à conta Google e que a verificação que falha está definida para bloquear numa política associada a uma aplicação. A Google só recebe
session-revoked, por isso um dispositivo que apenas avisa não envia nada. - O utilizador volta a iniciar sessão no mesmo dispositivo: o início de sessão no Google Workspace desse utilizador não passa pelo XFA. Veja o aviso acima.