Registro de cambios
[0.1.4] - 2024-02-19 - hoy en día
Agregado
- Se ha implementado un nuevo método, para determinar si el navegador se está ejecutando en modo incógnito o no.
Cambiado
Eliminado
[0.1.3] - 2023-12-18 - 2024-02-19
Agregado
- Añadidas cookies para una mejor identificación del dispositivo
Cambiado
- Detección de navegador mejorada (Opera y Brave)
Eliminado
[0.1.2] - 2023-10-26 - 2023-12-18
Agregado
Cambiado
- Mejora gestión de errores
- Mejora detección versiones de windows
Eliminado
[0.1.1] - 2023-07-21 - 2023-10-26
Agregado
Cambiado
- SDK ofuscada.
Eliminado
[0.1.0] - 2023-02-22 - 2023-07-21
Agregado
- Primera versión del WEB SDK
Cambiado
Eliminado
Configuración
¿Que es el SDK Web?
LBFraud web SDK es la pieza que permite integrar Ironchip LBFraud en tu pagina web. Usandolo, Ironchip es capaz de evaluar si el dispositivo y el entorno son seguros para operar en la web. Para añadir el SDK en tu web solo hay que seguir los siguientes pasos:.
Integración JavaScript
Esta integracion se puede realizar en un archivo JavaScript o directamente en el HTML entre los tags script. Recomendamos utilizarnos en JavaScript y ofuscarlo siempre.
Añade el paquete de Node.js:
npm i https://github.com/Ironchip-Security/Ironchip-Fraud-Detection-Web-SDK/releases/download/0.1.4/ironchip-fraud-detection-web-sdk-0.1.4.tgz
Importa el paquete:
//Importa la libreria de lbfraud
import { LBFraudSDK,LBFraudSDKEnvironment } from 'ironchip-fraud-detection-web-sdk';
Después, con el SDK importado tienes que inicializar el cliente. Por favor, asegurate de tener tu API-Key y el entorno en el que vas a trabajar a mano. Por defecto el entorno seleccionado es el de Producción.
Vamos a inicializar el SDK (Solo acepta un único entorno como parámetro de entrada):
const client = new LBFraudSDK({
apiKey: 'api-key',
environment: LBFraudSDKEnvironment.Development,
LBFraudSDKEnvironment.Testing,
LBFraudSDKEnvironment.Production,
});
Recomendamos que esta parte del código vaya ofuscada, ya que contiene el API-Key.
Con el cliente inicializado para hacer transacciones solo tienes que llamar al metodo.
Al metodo sendTransaction tienes que pasarle como parametros de entrada la ID de transcción y la ID de usuario.
client
.sendTransaction(transactionID, userID)
Eso es todo. Cada vez que se llame al metodo enviará una transacción.
Ejemplo
El código que aparece a continuación en un ejemplo completo del SDK
test.js
import { LBFraudSDK, LBFraudSDKEnvironment } from 'ironchip-fraud-detection-web-sdk';
const client = new LBFraudSDK({
apiKey: 'api-key',
environment: LBFraudSDKEnvironment.Testing
});
const myButton = document.getElementById('myButton');
function setListener() {
myButton.onclick = function(){
const transactionID = document.getElementById('transactionId').value;
const userID = document.getElementById('userId').value;
client
.sendTransaction(transactionID, userID)
.then((success) => {console.log(success)})
.catch((errorMsg) => {
console.log(errorMsg)
});
}
}
window.onload=function(){
setListener()
}
index.html
<!DOCTYPE html>
<html>
<head>
<title>Web SDK test</title>
</head>
<body>
<label for="transactionId">Transaction ID:</label>
<input type="text" id="transactionId" name="transactionId">
<label for="userId">User ID:</label>
<input type="text" id="userId" name="userId">
<button id="myButton">Enviar Transacción</button>
<script type="module" src="test.js"></script>
</body>
</html>
Documentación adicional
Para utilizar correctamente el SDK, es necesario activar el permiso de ubicación.
En Safari si tu navegador no muestra el modal para permitirlo, es necesario activarlo, para ello sigue los siguientes pasos:
- En su Mac, elija el menú Apple > Ajustes del sistema, haga clic en Privacidad y seguridad en la barra lateral y haga clic en Localización a la derecha.
- Active los Servicios de ubicación para Safari en la lista de la derecha.