SDK de dispositivo móvel do Dynamics 365 Fraud Protection para Android

Artigo
04/10/2024

Este recurso foi criado e recomendado para uso com o serviço Microsoft Dynamics 365 Fraud Protection. O Dynamics 365 Fraud Protection fornece impressão digital de dispositivo baseada em inteligência artificial (IA), é executado no Azure, é escalonável em nuvem e confiável, e tem segurança de nível corporativo. O recurso de impressão digital de dispositivo do Fraud Protection permite a identificação de dispositivos (como computadores, consoles Xbox, tablets e telefones celulares) em várias sessões ou interações que interagem com sua empresa e outras empresas na rede de fraudes do Fraud Protection. Além disso, ele permite ao Fraud Protection vincular eventos aparentemente não relacionados entre si na rede de fraudes para identificar padrões de fraude.

Ao implementar a análise de impressões digitais para dispositivos do Fraud Protection, instrumentando o aplicativo Android com SDK (kit de desenvolvimento do software) do Dynamics 365 Fraud Protection para Android, você concorda com os termos de uso de APIs (interfaces de programação de aplicativos) da Microsoft. Você também orienta a Microsoft a processar os tipos de dados a seguir dos dispositivos que interagem com os serviços do Fraud Protection. (Esses dados são chamados coletivamente de dados de impressão digital de dispositivo.)

Os atributos do dispositivo, como a ID do dispositivo, as informações de tela, o processador e a classe
Atributos do sistema operacional (SO), como informações do SO, a versão do SO e detalhes do fabricante original do equipamento (OEM)
Atributos relacionados ao navegador aplicável, como o idioma do navegador e os aplicativos padrão instalados

Você tem as seguintes responsabilidades:

Receba o consentimento de usuários para coletar e permitir que a Microsoft processe os dados de impressão digital do dispositivo.
Informe os clientes sobre a coleta de dados e as práticas de processamento. Por exemplo, divulgue os dados que você coleta e como eles são usados.
Revele o uso de terceiros que trabalham em seu nome para processar os dados que você coleta. Esses terceiros incluem prestadores de serviços do Fraud Protection.
Cumpra todas as leis e regulamentos aplicáveis ao uso do Fraud Protection. Essas leis e regulamentos incluem leis de proteção de dados.

Referência técnica do Android

minSdkVersion: 21

Adicione o repositório JitPack ao build.gradle raiz.

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Adicione a dependência.

dependencies {
    implementation ('com.github.microsoft:fraudprotection-sdk-android:$version@aar'){
        transitive = true
    }
}

Selecione Sincronizar Projeto com Arquivos Gradle.
Você pode iniciar o SDK na classe de aplicativo base para começar a coletar atributos de dispositivo.
```
import com.microsoft.fraudprotection.androidsdk.FraudProtection;
FraudProtection.start(getApplicationContext(), tenantId);
```
Nesse código, tenantId é o identificador global exclusivo (GUID) ou o identificador universalmente exclusivo (UUID) fornecido pela Microsoft.
Envie atributos de dispositivo coletados para a Microsoft chamando send(). Você pode chamar send() em qualquer fragmento/atividade antes ou na página que tem a operação para a qual você precisa de uma avaliação de risco. Para um cenário de entrada/inscrição, você pode chamar send() logo após start() na classe de aplicativo base.
```
import com.microsoft.fraudprotection.androidsdk.FraudProtection;
FraudProtection.send(pageId);
```
Neste código, pageId é opcional e pode ser definido da seguinte maneira, dependendo do cenário:
- SI – Entrar
- SU – Inscrever-se
- P – Comprar
- tst – Testar
Chame getSessionId() para obter o valor sessionId que é necessário quando as APIs de avaliação de risco são chamadas.
```
import com.microsoft.fraudprotection.androidsdk.FraudProtection;
String sessionId = FraudProtection.getSessionId();
```

Permissões em tempo de execução do Android

O SDK do Android conta com as permissões de tempo de execução a seguir para coletar vários dados de dispositivo. O SDK do Android não solicita permissões em tempo de execução. O aplicativo deve obter essas permissões em tempo de execução do usuário.