A defesa de conta ajuda a detectar e evitar atividades fraudulentas em contas em sites. A defesa da conta monitora os padrões de atividade do usuário e cria um modelo comportamental específico do site para ajudar você a identificar o abuso de credenciais e proteger as contas de usuário contra ataques automatizados.
O Fraud Defense ajuda a proteger ações críticas, como login e finalização de compra. No entanto, existem muitas formas sutis de abuso de conta que podem ser detectadas ao observar o comportamento de um usuário específico em um site durante um período. A defesa da conta, um recurso do Fraud Defense, ajuda a identificar esses tipos de abuso sutil criando um modelo específico para seu site detectar uma tendência de comportamento suspeito ou uma mudança na atividade. Ao usar o modelo específico do site, a defesa da conta ajuda a detectar o seguinte:
- Atividades suspeitas
- Contas com comportamentos parecidos
- Solicitações de dispositivos marcados como confiáveis para usuários específicos
Com base na análise da defesa da conta e do modelo específico do site, é possível realizar as seguintes ações:
- Restringir ou desativar contas fraudulentas.
- Evite tentativas de sequestro de conta.
- Reduzir os sequestros de contas bem-sucedidos.
- Conceda acesso apenas às solicitações de contas de usuário legítimas.
- Reduza o atrito para os usuários que fazem login em um dos dispositivos de confiança.
Antes de começar
- Prepare seu ambiente para o Google Cloud Fraud Defense.
- Crie uma chave de site baseada em pontuação.
Configurar suas páginas da Web para a Defesa de Conta
A defesa da conta requer uma compreensão abrangente das atividades da conta para permitir uma detecção eficaz. Para começar a alimentar as atividades relacionadas à conta para a Defesa de Conta e criar e melhorar seu modelo específico do site, faça o seguinte:
- Ativar a coleta de dados de telemetria horizontal.
- Relatar ações críticas do usuário.
- Avalie os eventos críticos do usuário.
- Anote eventos do usuário para ajustar seu modelo específico do site.
Ativar a coleta de dados de telemetria horizontal
A defesa da conta requer uma visão completa das ações do usuário, como se ele está conectado ou prestes a fazer login. Para ativar a coleta passiva de dados de telemetria horizontal pela Defesa da conta, carregue o script JavaScript do reCAPTCHA com a chave do site baseada em pontuação que você criou em segundo plano em todas as páginas da Web que fazem parte do fluxo de trabalho do usuário.
O exemplo a seguir mostra como carregar o script JavaScript do reCAPTCHA em uma página da Web.
<head>
<script src="https://www.google.com/recaptcha/enterprise.js?render=KEY_ID"></script>
....
</head>Relatório sobre ações críticas do usuário
Para detectar padrões de atividade suspeitos e criar um modelo melhor de padrões de atividade típicos no seu site, o Account Defender precisa de informações sobre ações críticas do usuário. Portanto, informe as ações críticas do usuário nas páginas da Web chamando grecaptcha.enterprise.execute() nessas ações.
Recomendamos informar todas as ações críticas do usuário, porque isso ajuda na
coleta de outros indicadores. Para cada ação do usuário que você quer informar,
substitua o valor do parâmetro action de grecaptcha.enterprise.execute()
por um nome que descreva a ação do usuário.
A tabela a seguir lista os nomes de ações que podem ser usados ao informar as ações críticas do usuário.
| Nome da ação | Evento iniciado pelo usuário ou ação do usuário |
|---|---|
LOGIN |
Faça login no site. |
REGISTRATION |
Registro no site. |
SECURITY_QUESTION_CHANGE |
Solicite a mudança da pergunta de segurança. |
PASSWORD_RESET |
Solicite a redefinição da senha. |
PHONE_NUMBER_UPDATE |
Solicitação para atualizar o número de telefone. |
EMAIL_UPDATE |
Solicitação para atualizar o endereço de e-mail. |
ACCOUNT_UPDATE |
Solicitar a atualização de informações relacionadas à conta, como detalhes de contato. |
TRIGGER_MFA |
Uma ação que aciona um desafio de MFA. |
REDEEM_CODE |
Peça para resgatar o código. |
LIST_PAYMENT_METHODS |
Busque a lista de formas de pagamento. |
O exemplo a seguir mostra como chamar grecaptcha.enterprise.execute() em uma
atualização de número de telefone:
<script> function onClick(e) { e.preventDefault(); grecaptcha.enterprise.ready(async () => { const token = await grecaptcha.enterprise.execute('KEY_ID', {action: 'PHONE_NUMBER_UPDATE'}); }); } </script>
Avaliar eventos críticos do usuário
Quando você chama grecaptcha.enterprise.execute() em uma ação do usuário, um token é gerado. Para os eventos de usuário
críticos, como logins, registros e ações bem-sucedidos e com falha dos usuários
conectados, crie uma avaliação para avaliar os resultados da chamada grecaptcha.enterprise.execute(). A
avaliação fornece um veredito de risco, que pode ser usado para tomar uma decisão sobre como lidar
com atividades potencialmente fraudulentas. Algumas das ações que você pode realizar são bloquear solicitações suspeitas,
contestar logins de risco e investigar contas de interesse.
A defesa da conta exige que você forneça um identificador de conta estável para fazer a avaliação e atribuir a atividade do usuário, como solicitações de login, solicitações de login e solicitações de inscrição, a uma conta específica. Isso ajuda a Defesa da conta a processar padrões de atividade do usuário para criar um modelo de atividade para cada conta e detectar melhor o tráfego anômalo e abusivo.
Escolha um identificador de conta estável accountId que não seja alterado com frequência pelo usuário
e forneça-o à avaliação no método
projects.assessments.create. Esse identificador de conta estável precisa ter o
mesmo valor para todos os eventos relacionados ao mesmo usuário. Você pode fornecer o seguinte como identificador
da conta:
Identificadores de usuários
Se cada conta puder ser associada de forma exclusiva a um nome de usuário, endereço de e-mail ou número de telefone
estável, use-o como o accountId. Quando você fornece esses identificadores
entre sites (identificadores que podem ser reutilizados em vários sites), o Fraud Defense usa essas
informações para melhorar a proteção das suas contas de usuário com base em modelos entre sites,
sinalizando identificadores de contas abusivas e usando o conhecimento de padrões de abuso entre sites relacionados
a esses identificadores.
Como alternativa, se você tiver um ID do usuário interno associado exclusivamente a cada conta, poderá
fornecê-lo como accountId.
Criptografados ou transformados em hash
Se você não tiver um ID do usuário interno associado exclusivamente a cada conta, poderá transformar qualquer identificador estável em um identificador de conta opaco e específico do site. Esse identificador ainda é necessário para que o defensor da conta do Fraud Defense entenda os padrões de atividade do usuário e detecte comportamentos anômalos, mas ele não é compartilhado com outros sites.
Escolha qualquer identificador de conta estável e torne-o opaco antes de enviar para o Fraud Defense usando criptografia ou hash:
criptografia (recomendado): criptografe o identificador da conta usando um método de criptografia determinístico que produza um texto criptografado estável. Para instruções detalhadas, consulte criptografar dados de maneira determinística. Ao escolher a criptografia simétrica em vez do hash, não é necessário manter um mapeamento entre os identificadores de usuário e os identificadores de usuário opacos correspondentes. Descriptografar os identificadores opacos retornados pelo Fraud Defense para transformá-los no identificador de usuário.
hashing: recomendamos gerar hash do identificador da conta usando o método SHA256-HMAC com um salt personalizado de sua escolha. Como os hashes são unidirecionais, é necessário manter um mapeamento entre os hashes gerados e os identificadores de usuário para que seja possível mapear o identificador de conta com hash retornado para as contas originais.
Além de fornecer um identificador de conta estável para todas as solicitações relacionadas à conta, é possível
fornecer outros identificadores de conta, possivelmente não estáveis, para algumas solicitações específicas.
Os identificadores de conta específicos do contexto fornecidos além do accountId ajudam
a Defesa de Conta a analisar melhor a atividade do usuário e detectar tentativas de sequestro
de conta para manter as contas de usuário seguras. Quando você fornece identificadores adicionais,
o Google Cloud Fraud Defense usa essas informações para melhorar a proteção das contas de usuário com base em
modelos de vários sites, sinalizando identificadores de contas abusivas e usando o conhecimento de padrões de abuso
em vários sites relacionados a esses identificadores. Por exemplo, você pode fornecer o seguinte:
O nome de usuário, endereço de e-mail ou número de telefone usado como identificador de login para solicitações de login
O endereço de e-mail ou número de telefone que foi verificado para uma solicitação de autenticação multifator.
Um endereço de e-mail ou número de telefone (principal ou secundário) fornecido pelo usuário durante uma solicitação de atualização de conta
Os endereços de e-mail e números de telefone fornecidos pelo usuário durante uma solicitação de registro
Anexe o identificador de conta estável escolhido ao parâmetro accountId no método
projects.assessments.create para todas as solicitações relacionadas à conta. Se quiser,
forneça outros identificadores de conta para as solicitações relevantes usando o campo userIds
na avaliação.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto do Google Cloud .
- TOKEN: token retornado da chamada
grecaptcha.enterprise.execute() - KEY_ID: chave reCAPTCHA associada ao site
- ACCOUNT_ID: o identificador associado exclusivamente à conta de usuário do seu site.
- EMAIL_ADDRESS: opcional. Um endereço de e-mail associado a essa solicitação, se houver
- PHONE_NUMBER: opcional. Um número de telefone associado a essa solicitação, se houver
- USERNAME: opcional. Um nome de usuário associado a essa solicitação, se houver
Método HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments
Corpo JSON da solicitação:
{
"event": {
"token": "TOKEN",
"siteKey": "KEY_ID",
"userInfo": {
"accountId": "ACCOUNT_ID",
"userIds": [
{
"email": "EMAIL_ADDRESS"
},
{
"phoneNumber": "PHONE_NUMBER"
},
{
"username": "USERNAME"
}
]
}
}
}
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments"
PowerShell
Salve o corpo da solicitação em um arquivo com
o nome request.json e execute o comando abaixo:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{
"tokenProperties": {
"valid": true,
"hostname": "www.google.com",
"action": "login",
"createTime": "2019-03-28T12:24:17.894Z"
},
"riskAnalysis": {
"score": 0.6,
},
"event": {
"token": "TOKEN",
"siteKey": "KEY",
"userInfo": {
"accountId": "ACCOUNT_ID"
}
},
"name": "projects/PROJECT_NUMBER/assessments/b6ac310000000000",
"accountDefenderAssessment": {
"labels": ["SUSPICIOUS_LOGIN_ACTIVITY"]
}
}
Exemplo de código
Java
Para autenticar no Fraud Defense, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Interpretar o veredito de risco dos eventos críticos do usuário
Quando você cria uma avaliação com a Defesa da Conta ativada, ela
retorna accountDefenderAssessment como parte da resposta da avaliação.
O valor de accountDefenderAssessment ajuda
você a avaliar se a atividade do usuário é legítima ou fraudulenta. Ele também retorna
um ID de avaliação que você precisa usar ao anotar eventos do usuário.
O exemplo a seguir é uma resposta JSON de amostra:
{ "tokenProperties": { "valid": true, "hostname": "www.google.com", "action": "login", "createTime": "2019-03-28T12:24:17.894Z" }, "riskAnalysis": { "score": 0.6, }, "event": { "token": "TOKEN", "siteKey": "KEY_ID", "expectedAction": "USER_ACTION" }, "name": "projects/PROJECT_ID/assessments/b6ac310000000000X", "accountDefenderAssessment": { labels: ["SUSPICIOUS_LOGIN_ACTIVITY"] } }
O campo accountDefenderAssessment pode ter um dos seguintes valores:
| Valor | Descrição |
|---|---|
SUSPICIOUS_LOGIN_ACTIVITY |
Indica que a solicitação representa um alto risco de ataque de preenchimento de credenciais ou sequestro de conta. |
SUSPICIOUS_ACCOUNT_CREATION |
Indica que a solicitação representa um alto risco de criação de conta abusiva. |
PROFILE_MATCH |
Indica que os atributos do usuário correspondem aos atributos que foram vistos anteriormente para esse usuário específico. Esse valor indica que o usuário está em um dispositivo de confiança que foi usado antes para acessar seu site.
|
RELATED_ACCOUNTS_NUMBER_HIGH |
Indica que a solicitação tem um número alto de contas relacionadas. Isso não significa necessariamente que a conta é ruim, mas pode exigir mais investigação. |
Anotar eventos para ajustar o modelo específico do site
Para fornecer mais informações à Defesa da conta e melhorar o modelo de detecção específico do site, é preciso anotar os eventos que você avaliou criando avaliações.
Para anotar uma avaliação, envie uma solicitação ao método projects.assessments.annotate
com o ID da avaliação. No corpo dessa solicitação, inclua rótulos
que forneçam mais informações sobre um evento descrito na avaliação.
Para fazer anotações em uma avaliação, siga estas etapas:
-
Determine as informações e os rótulos a serem adicionados no corpo JSON da solicitação, dependendo do seu caso de uso.
A tabela a seguir lista os rótulos e valores que podem ser usados para anotar eventos:
Rótulo Descrição Exemplo de solicitação reasonsObrigatório. Um rótulo para apoiar suas avaliações. Forneça detalhes do evento em tempo real no rótulo
reasonsem alguns segundos ou minutos após o evento, porque eles influenciam a detecção em tempo real.Para ver a lista de valores possíveis, consulte valores de motivos.
Exemplo: para detectar sequestros de conta, anote se a senha inserida estava correta com os valores
CORRECT_PASSWORDouINCORRECT_PASSWORD. Se você implantou sua própria MFA, pode adicionar os seguintes valores:INITIATED_TWO_FACTORePASSED_TWO_FACTORouFAILED_TWO_FACTOR.{ "reasons": ["INCORRECT_PASSWORD"] }annotationOpcional. Um rótulo para indicar a legitimidade das avaliações. Forneça fatos sobre eventos de login e registro para validar ou corrigir suas avaliações de risco no rótulo
annotation.Valores possíveis:
LEGITIMATEouFRAUDULENT.É possível enviar essas informações a qualquer momento ou como parte de um job em lote. No entanto, recomendamos enviar essas informações em alguns segundos ou minutos após o evento, porque elas influenciam a detecção em tempo real.
{ "annotation": "LEGITIMATE" }accountIdOpcional. Um rótulo para associar um ID da conta a um evento.
Se você criou uma avaliação sem um ID de conta, use esse rótulo para fornecer o ID da conta de um evento sempre que ele estiver disponível.
{ "accountId": "ACCOUNT_ID" } Crie uma solicitação de anotação com os rótulos apropriados.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- ASSESSMENT_ID: valor do campo
nameretornado da chamadaprojects.assessments.create. - ANNOTATION: opcional. Um rótulo para indicar se a avaliação é legítima ou fraudulenta.
- REASONS: opcional. Motivos que embasam sua anotação. Para ver a lista de valores possíveis, consulte valores de motivos.
- ACCOUNT_ID: opcional. O identificador associado exclusivamente à conta de usuário no seu site.
Para mais informações, consulte rótulos para anotações.
Método HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate
Corpo JSON da solicitação:
{ "annotation": ANNOTATION, "reasons": REASONS, "accountId": ACCOUNT_ID }Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome
request.jsone execute o comando abaixo:curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate"PowerShell
Salve o corpo da solicitação em um arquivo com o nome
request.jsone execute o comando a seguir:$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate" | Select-Object -Expand ContentVocê receberá um código de status bem-sucedido (2xx) e uma resposta vazia.
- ASSESSMENT_ID: valor do campo
Exemplo de código
Java
Para autenticar no Fraud Defense, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Usar e interpretar a pontuação de risco de sequestro de conta
O recurso de pontuação de risco de sequestro de conta (ATO, na sigla em inglês) adiciona uma pontuação de risco numérica e explicações legíveis por humanos à avaliação de defesa da conta. Esses insights ajudam você a entender a avaliação e informar suas ações ou decisões subsequentes.
Receber a pontuação de risco
Para receber a pontuação de risco e os motivos da explicabilidade, envie uma solicitação CreateAssessment e inclua event.userInfo.accountId nela.
Ler a pontuação de risco e os detalhes
A pontuação de risco e os motivos de explicabilidade estão no objeto accountDefenderAssessment.accountTakeoverVerdict na resposta da avaliação.
- Pontuação de risco:
accountDefenderAssessment.accountTakeoverVerdict.risk - Motivos de risco:
accountDefenderAssessment.accountTakeoverVerdict.riskReasons - Motivos de confiança:
accountDefenderAssessment.accountTakeoverVerdict.trustReasons
O snippet a seguir mostra um exemplo dos campos em uma resposta de avaliação:
"accountDefenderAssessment": { "labels": ["PROFILE_MATCH"], "accountTakeoverVerdict": { "risk": 0.249, "riskReasons": [{"reason": "CLIENT_ACCESSED_MANY_ACCOUNTS"}], "trustReasons": [{"reason": "PROFILE_MATCH"}, {"reason": "ACCOUNT_HISTORY_REPUTABLE"}] } }
Interpretar a pontuação de risco de ATO
Ao usar a pontuação de risco, estabeleça um limite para determinar quando tomar medidas de proteção.
Use a pontuação de risco de ATO como alternativa ao rótulo SUSPICIOUS_LOGIN_ACTIVITY.
Não use a pontuação de risco e o rótulo para acionar a aplicação na mesma avaliação. É
possível configurar a lógica de aplicação com base na pontuação de risco que excede o limite ou
na presença do rótulo. Em geral, a pontuação de risco oferece uma avaliação mais granular.
Recomendamos que você avalie o desempenho da pontuação de riscos com um limite apropriado no tráfego da sua plataforma antes de usá-la para aplicação obrigatória.
Para agir com base na pontuação de risco, implemente uma verificação no back-end, conforme mostrado no snippet a seguir:
if (assessment.accountDefenderAssessment.accountTakeoverVerdict.risk > YOUR_CHOSEN_THRESHOLD) {
// Treat as suspicious
// Implement protective actions
}
Limites padrão de pontuação de risco
A tabela a seguir mostra os limites padrão de pontuação de riscos e as taxas de falso positivo (FPR, na sigla em inglês) esperadas. Escolha um limite com base na sua FPR aceitável. O desempenho pode variar, então talvez seja necessário ajustar o limite com base no desempenho observado.
| Tolerância de risco | Limite recomendado | Taxa máxima de falsos positivos |
|---|---|---|
| Baixo | 0,5 | 4% |
| Média | 0,7 | 1% |
| Alta | 0,9 | 0,25% |
Interpretar motivos de explicabilidade
Os motivos de explicabilidade fornecem insights sobre os fatores que influenciam a pontuação de risco. Use esses motivos para refinar sua tomada de decisão.
- Motivos de risco: indicam fatores associados a um risco maior de sequestro de conta.
- Motivos de confiança: indicam fatores que sugerem legitimidade.
Os motivos de risco e de confiança podem aparecer para qualquer pontuação de risco.
| Motivo | Tipo | Interpretação |
|---|---|---|
PROFILE_MATCH |
Confiável | A solicitação corresponde a um perfil confiável associado a essa
conta. Isso equivale ao rótulo AccountDefenderLabel.PROFILE_MATCH. |
ACCOUNT_HISTORY_REPUTABLE |
Confiável | A atividade histórica da conta é confiável. É improvável que a conta tenha sido comprometida no passado. |
CLIENT_HISTORICAL_BOT_ACTIVITY |
Risco | O cliente foi observado enviando tráfego semelhante ao de bot para este site no passado. Esse motivo incorpora a reputação histórica e indica que o cliente é conhecido por usar bots, mesmo que a solicitação atual esteja sendo feita por um humano. |
ACCOUNT_IN_LARGE_RELATED_GROUP |
Risco | A conta faz parte de um grande grupo de contas relacionadas, indicando que pode fazer parte de uma rede fraudulenta. As contas relacionadas são identificadas com base em padrões de tráfego e características de solicitação semelhantes. |
CLIENT_ACCESSED_MANY_ACCOUNTS |
Risco | O cliente foi observado acessando muitas contas neste site. |
DISPOSABLE_EMAIL_DOMAIN |
Risco | O endereço de e-mail fornecido pertence a um provedor conhecido ou suspeito de domínios de e-mail temporários e descartáveis (uso único). |
Ajustar o limite de risco de sequestro de conta
Depois de avaliar o desempenho da pontuação de risco de sequestro de conta no tráfego, talvez seja necessário ajustar o limite para atingir a taxa de falso positivo (FPR, na sigla em inglês) e o recall aceitáveis. É possível ajustar o limite com base no desempenho observado ou calcular valores intermediários para segmentar uma FPR específica.
Ajustar o limite
Se a FPR observada for muito alta, aumente o limite. Se o recall observado for muito baixo e você puder tolerar uma FPR mais alta, diminua o limite.
Calcular valores intermediários
Para estimar a FPR de um limite entre os valores padrão, use a interpolação linear. O exemplo a seguir mostra como calcular a FPR para um limite de 0,85:
FPR(T: 0.85) = (FPR(T: 0.8) + FPR(T: 0.9)) / 2 = (0.5% + 0.25%) / 2 = 0.375%
Para encontrar um limite para uma FPR específica, interpole entre os valores padrão. O exemplo a seguir mostra como encontrar o limite para uma FPR de 5%:
Threshold = 0.4 + (0.5 − 0.4) × (8% − 5%) / (8% − 4%) Threshold = 0.4 + 0.1 × (3 / 4) Threshold = 0.4 + 0.075 = 0.475
Estima-se que um limite de 0,475 gere uma FPR de 5%.