Android (en)

Supported versions

Add the Ironchip location-based fraud SDK

Add our library to other projects

First, in the settings.gradle file, you will need to reference the remote repository where the library is located.

dependencyResolutionManagement {
    ...

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

Next, in the gradle.build file, you must add the SDK dependency.

dependencies {
    ...
    implementation "com.github.Ironchip-Security:LBFraud-SDK-Android:1.2.13"
    ...
}

 Permisions

Add the following permissions to your manifest:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

<uses-permission android:name="android.permission.INTERNET" />

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Use

Using in an application

To take full advantage of the SDK, you need to grant the ACCESS_FINE_LOCATION permission.

How to request permissions

import com.ironchip.ironchiplbfraudandroidsdk.LBFraudSDK;
...

// Reemplace APIKEY con la clave API generada deseada.
LBFraudSDK fraud = new LBFraudSDK(this, "APIKEY");
// Por defecto nuestro SDK apunta al entorno de producción.
// En caso de que desee apuntar a un entorno diferente:
// LBFraudSDK fraud = new LBFraudSDK(this, "APIKEY", LBFraudSDK.Environment.Testing);

//public enum Environment {
//    Production,
//    Testing,
//    Development
//}

Map<String, Object> extraData = new HashMap<>();
extraData.put("concept", "Book august");
extraData.put("amount", new Integer(30));
extraData.put("operation", "booking");

// TransactionID (required,unique): transaction identifier request for fraud results
// UserID (required): User identifier
// ExtraData (optional): extra information for analysis
// The sendTransaction can be provided with 2 callbacks, one is executed when the transaction is finished
// and the other one is called in case an error did occure during the transaction process.
ironchipLBFraud.sendTransaction("random_identifier_generated", "john.doe@gmail.com", extraData, () -> {
        // Add here any code you want to be executed after the transaction
        // has finished.
    }, exception -> {
        // Add here any code you want to perform in case of an error
        // during the transaction.
        // exception.printStackTrace()
});

Example

import com.ironchip.ironchiplbfraudandroidsdk.LBFraudSDK;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.CompletableFuture;

...

// Reemplace APIKEY con la clave API generada deseada.
LBFraudSDK fraud = new LBFraudSDK(this, "APIKEY");

// Método asincrónico para realizar el inicio de sesión del usuario
private void login(String username, String password) {
    performLogin(username, password).thenAccept(loginSuccessful -> {
        if (loginSuccessful) {
            // Si el inicio de sesión es exitoso, llama a sendTransaction con los parámetros necesarios
            String transactionID = generateRandomTransactionID(10); // Generate or fetch your transaction ID
            String userID = "john.doe@gmail.com"; // Identificador de usuario
            String anonymizedUserID = anonymizeUserID(userID); // ID de usuario anonimizado

            Map<String, Object> extraData = new HashMap<>(); // Información adicional para análisis
            extraData.put("amount", 30); // Usa Integer.valueOf(30) si fuera necesario
            extraData.put("operation", "login");

            sendTransactionAfterLogin(transactionID, anonymizedUserID, extraData);
        } else {
            // Manejar el fallo en el inicio de sesión
        }
    });
}

// Función de inicio de sesión asincrónica que devuelve un Future<Boolean>
private CompletableFuture<Boolean> performLogin(String username, String password) {
    return CompletableFuture.supplyAsync(() -> {
        try {
            Thread.sleep(2000); 
            
            // Reemplaza con tu lógica de inicio de sesión real
            // Por ejemplo, autentica al usuario y devuelve true si es exitoso      
            return true;
        } catch (InterruptedException e) {
            return false; // En caso de un error, devuelve false
        }
    });
}

// Función para enviar la transacción después de un inicio de sesión exitoso
private void sendTransactionAfterLogin(String transactionID, String anonymizedUserID, Map<String, Object> extraData) {
    // Enviando la transacción
    fraud.sendTransaction(transactionID, anonymizedUserID, extraData, () -> {
    // Agrega aquí cualquier código que quieras ejecutar después de que la transacción haya finalizado.
    }, exception -> {
    // Agrega aquí cualquier código que quieras ejecutar en caso de un error durante la transacción.
    });
}

// Función para recortar, convertir a minúsculas y hashear el userID
public static String anonymizeUserID(String userID) {
    String trimmedLowercaseUserID = userID.trim().toLowerCase();
    return hashString(trimmedLowercaseUserID);
}

// Función para realizar el hashing utilizando SHA-256
public static String hashString(String input) {
    try {
        MessageDigest digest = MessageDigest.getInstance("SHA-256");
        byte[] hashBytes = digest.digest(input.getBytes(StandardCharsets.UTF_8));

        StringBuilder hexString = new StringBuilder();
        for (byte b : hashBytes) {
            String hex = Integer.toHexString(0xff & b);
            if (hex.length() == 1) {
                hexString.append('0');
            }
            hexString.append(hex);
        }
        return hexString.toString();
    } catch (NoSuchAlgorithmException e) {
        throw new RuntimeException("Error while calculating hash", e);
    }
}

private String generateRandomTransactionID(int length) {
    // Implementa tu método para generar un ID de transacción único.
    const String chars = "AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz1234567890";
    Random rnd = new Random();
    return IntStream.range(0, length)
        .mapToObj(i -> String.valueOf(chars.charAt(rnd.nextInt(chars.length()))))
        .collect(Collectors.joining());
}