Este é o guia de integração da nossa ferramenta de monitoramento de Device Comportamental. Este documento é destinado aos desenolvedores responsáveis pela implementação desta funcionalidade.
Nossa tecnologia de device comportamental permite identificar padrões de uso suspeitos, detectar bots e outras atividades anômalas. Isso garante uma camada adicional de proteção para seus usuários. Coletamos informações públicas do dispositivo, como IP e sistema operacional, para criar perfis comportamentais detalhados e identificar dispositivos já conhecidos pelo sistema.
Comprometemo-nos a respeitar as políticas de privacidade e o nível de permissão concedido pelo usuário, em conformidade com a LGPD. Nosso objetivo é fornecer serviços de prevenção a fraudes de maneira ética e transparente.
É importante ressaltar que a biometria comportamental está disponível apenas para identificações via browser (Web).
Para utilizar a funcionalidade de monitoramento de comportamento de dispositivos, o script correspondente deve ser implementado em todas as páginas onde a validação do dispositivo será realizada.
O código deverá ser incluso na página antes da tag </body> conforme exemplo abaixo:
<script>
(function (a, b, c, d, e, f, g) {
a['CsbpObject'] = e; a[e] = a[e] || function () {
(a[e].q = a[e].q || []).push(arguments)
}, a[e].l = 1 * Date.now(); f = b.createElement(c),
g = b.getElementsByTagName(c)[0]; f.async = 1; f.src = d; g.parentNode.insertBefore(f, g)
})(window, document, 'script', '//device.clearsale.com.br/b/bio.js', 'csbp');
csbp('app', 'seu_app');
csbp('navigationid', 'seu_id_de_navegacao');
</script>
A ClearSale deverá informar qual valor deve ser utilizado na palavra sinalizada em verde (seu_app). Este valor serve para identificar o seu website em nosso sistema.
O valor de navigationID deve ser um ID único por usuário. Este ID pode ser um identificador específico ou um número aleatório de até 128 caracteres e deve ser mantido durante toda a sessão de navegação do usuário.
IMPORTANTE Para que o script saiba o momento ideal de realizar o envio das variáveis de comportamento, é necessário indicar qual formulário é o responsável por sinalizar que o usuário terminou de interagir com a página. Para isso, utilize o atributo data-csbp.
<form id="example" data-csbp>
<input type="email" name="email" required><br>
<input type="password" name="password" required><br>
</form>
Após a implementação, caso queira validar a execução do script, realize um fluxo teste garantindo que o Javascript foi executado corretamente. Em seguida, envie o navigationID e o nome de cadastro para suporte.behavior@clear.sale
A funcionalidade de monitoramento de comportamento de dispositivos deve ser contratada juntamente com o Device Check. Dessa forma, a resposta sobre a análise comportamental do dispositivo será retornada na mesma resposta da API.
{
"behavior":
{
"bot": true
"typingBehavior":"Suspicious",
"typingSpeed":"VeryFast",
"typingFluctuation":"Medium",
"capitalizationMethod":"None",
"deleteMethod":"None",
"focusBehavior":"Unknown",
"focusFluctuation":"Unknown",
"focusMethod":"None",
"submitMethod":"Unknown",
"autocompleteMethod":"None",
"mouseSpeed":"Unknown",
"mouseFluctuation":"Unknown",
"mouseHandedness":"Unknown",
"mouseBehavior":"Unknown",
"scrollSpeed":"Unknown",
"touchPressure":"Unknown",
"touchArea":"Unknown",
"touchHandedness":"Unknown"
}
}
IMPORTANTE: Em alguns casos de uso, o modelo pode não identificar algumas variáveis. Recomendamos utilizar a variável “bot” como referência, pois ela representa a interpretação positiva da identificação de dispositivos maliciosos em relação a todas as outras variáveis.
Campo | Resposta | Suporte touch? | Descrição |
---|---|---|---|
bot | True, False | Sim | Indica se o usuário é identificado como um bot. |
typingBehavior | Unknown = 0, Suspicious = 1, Human = 2, Bot = 3 | Sim | Veredito sobre o comportamento de digitação |
typingSpeed | Unknown = 0, VerySlow = 1, Slow = 2, Regular = 3, Fast = 4, VeryFast = 5 | Sim | Velocidade média de digitação |
typingFLuctuation | Unknown = 0, Linear = 1, Low = 2, Medium = 3, High = 4 | Sim | Variação na velocidade de digitação |
capitalizationMethod | None = 0, Shift = 1, CapsLock = 2, Undetectable = 4 | - | Método usado para digitar letras maisculas |
deleteMethod | None = 0, BackSpace = 1, Delete = 2, Undetectable = 4 | - | Método utilizado para apagar caracteres |
focusBehavior | None = 0, Mouse = 1, Keyboard = 2, Touch = 3 | Sim | Método usado para focar nos campos |
focusFluctuation | Unknown = 0, Linear = 1, Low = 2, Medium = 3, High = 4 | Sim | Variação na velocidade do foco |
focusMethod | Unknown = 0, Suspicious = 1, Human = 2, Bot = 3 | Sim | Veredito sobre o comportamento do foco |
submitMethod | Unknown = 0, Mouse = 1, Keyboard = 2, Touch = 3 | Sim | Método usado para enviar formulário |
autocompleteMethod | None = 0, Keyboard = 1, ContextMenu = 2, BrowserAutoFill = 4, PasswordManager = 8 | Sim | Método usado para autocompletar o formulário |
mouseSpeed | Unknown = 0, VerySlow = 1, Slow = 2, Regular = 3, Fast = 4, VeryFast = 5 | Não | Velocidade de movimento do mouse |
mouseFluctuation | Unknown = 0, Linear = 1, Low = 2, Medium = 3, High = 4 | Não | Variação no movimento do mouse |
mouseHandedness | Unknown = 0, Left = 1, Right = 2 | - | Lateralidade do uso do mouse |
mouseBehavior | Unknown = 0, Suspicious = 1, Human = 2, Bot = 3 | - | Veredito sobre o comportamento do mouse |
scrollSpeed | Unknown = 0, VerySlow = 1, Slow = 2, Regular = 3, Fast = 4, VeryFast = 5 | Sim | Velocidade média de rolagem |
touchPressure | Unknown = 0, Light = 1, Medium = 2, Heavy = 3, Unsupported = 4 | Sim | Pressão média do toque |
touchArea | Unknown = 0, VerySmall = 1, Small = 2, Medium = 3, Large = 4, VeryLarge = 5, Unsupported = 6 | Sim | Área média de contato do toque |
touchHandedness | Unknown = 0, Left = 1, Right = 2, Unsupported = 3 | Sim | Lateralidade do toque |
Todas as informações coletadas pelo SDK da ClearSale são com exclusiva finalidade de prevenção à fraude e proteção ao próprio usuário, aderente à política de segurança e privacidade das plataformas Google e Apple e à LGPD. Por isso, estas informações devem constar na política de privacidade do aplicativo.
O SDK da ClearSale coleta as seguintes informações do dispositivo :
Ao realizar o download e utilizar nosso SDK você estará concordando com a seguinte licença.
Copyright © 2025 ClearSale
Todos os direitos são reservados, sendo concedida a permissão para usar o software da maneira como está, não sendo permitido qualquer modificação ou cópia para qualquer fim. O Software é licenciado com suas atuais configurações “tal como está” e sem garantia de qualquer espécie, nem expressa e nem implícita, incluindo mas não se limitando, garantias de comercialização, adequação para fins particulares e não violação de direitos patenteados. Em nenhuma hipótese os titulares dos Direitos Autorais podem ser responsabilizados por danos, perdas, causas de ação, quer seja por contrato ou ato ilícito, ou outra ação tortuosa advinda do uso do Software ou outras ações relacionadas com este Software sem prévia autorização escrita do detentor dos direitos autorais.