Getting Started with Secureify

Installation

1. Include the SDK

Add the Secureify SDK to your HTML file:

<script src="https://api.secureify.xyz/static/fingerprint-sdk.js"></script>

2. Initialize the SDK

const fp = new FingerprintSDK('your-api-key', {
    endpoint: 'https://api.secureify.xyz',  // Optional: defaults to https://api.secureify.xyz
    autoRefresh: true,                      // Optional: automatically refresh device ID
    refreshInterval: 300000,                // Optional: refresh every 5 minutes
    debug: false                            // Optional: enable debug logging
});

Basic Usage

Generate Device ID

try {
    const deviceId = await fp.generateDeviceId();
    console.log('Device ID:', deviceId);
} catch (error) {
    console.error('Error generating device ID:', error);
}

Get Device Parameters

try {
    const parameters = await fp.getParameters();
    console.log('Device Parameters:', parameters);
} catch (error) {
    console.error('Error getting parameters:', error);
}

Listen for Device ID Changes

const unsubscribe = fp.onDeviceIdChange((newDeviceId) => {
    console.log('Device ID changed:', newDeviceId);
});

// Later, when you want to stop listening:
unsubscribe();

Advanced Configuration

Update Configuration

fp.configure({
    autoRefresh: false,
    refreshInterval: 600000, // 10 minutes
    debug: true
});

Cleanup

// Call this when you're done using the SDK
fp.destroy();

Available Methods

generateDeviceId()

Generates a unique device identifier based on device characteristics. - Returns: Promise - Example Response:

{
   "deviceId": "SEC1_223fce73b659e214"
}

getParameters()

Collects comprehensive device information including: - Screen properties (width, height, color depth) - Browser information (user agent, language) - Hardware details (platform, memory) - Canvas fingerprint - WebGL information - Audio capabilities - Font detection - Browser features - Returns: Promise