use serde::{Deserialize, Serialize};
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum SurfaceCategory {
Navigator,
DevicePrompt,
WebGl,
Canvas,
Audio,
WebRtc,
Screen,
Timezone,
Lifecycle,
Storage,
CryptoAuth,
Sensor,
Notification,
Speech,
Font,
Timing,
Media,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum Criticality {
Critical,
High,
Medium,
Low,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct FingerprintSurface {
pub surface: &'static str,
pub category: SurfaceCategory,
pub criticality: Criticality,
}
const fn s(
surface: &'static str,
category: SurfaceCategory,
criticality: Criticality,
) -> FingerprintSurface {
FingerprintSurface {
surface,
category,
criticality,
}
}
use Criticality::{Critical, High, Low, Medium};
use SurfaceCategory::{
Audio, Canvas, CryptoAuth, DevicePrompt, Font, Lifecycle, Media, Navigator, Notification,
Screen, Sensor, Speech, Storage, Timezone, Timing, WebGl, WebRtc,
};
pub const SURFACES: &[FingerprintSurface] = &[
s("navigator.webdriver", Navigator, Critical),
s("navigator.userAgent", Navigator, High),
s("navigator.platform", Navigator, High),
s("navigator.language", Navigator, Medium),
s("navigator.languages", Navigator, High),
s("navigator.vendor", Navigator, Medium),
s("navigator.hardwareConcurrency", Navigator, High),
s("navigator.deviceMemory", Navigator, Medium),
s("navigator.connection.effectiveType", Navigator, Low),
s("navigator.plugins", Navigator, High),
s("navigator.plugins.length", Navigator, High),
s("navigator.cookieEnabled", Navigator, Low),
s("navigator.getBattery", Navigator, Medium),
s("navigator.vibrate", Navigator, Low),
s("navigator.wakeLock.request", Navigator, Medium),
s("navigator.permissions.query", Navigator, High),
s("navigator.share", Navigator, Medium),
s("navigator.canShare", Navigator, Medium),
s("navigator.storage.estimate", Navigator, Medium),
s("navigator.registerProtocolHandler", Navigator, Low),
s("navigator.setAppBadge", Navigator, Low),
s("navigator.clearAppBadge", Navigator, Low),
s("navigator.contacts.select", Navigator, Low),
s("navigator.getInstalledRelatedApps", Navigator, Low),
s("navigator.bluetooth.requestDevice", DevicePrompt, High),
s("navigator.usb.requestDevice", DevicePrompt, High),
s("navigator.serial.requestPort", DevicePrompt, High),
s("navigator.hid.requestDevice", DevicePrompt, High),
s("navigator.xr.isSessionSupported", DevicePrompt, Medium),
s("navigator.mediaDevices.getUserMedia", DevicePrompt, High),
s(
"navigator.mediaDevices.enumerateDevices",
DevicePrompt,
High,
),
s(
"navigator.mediaDevices.getDisplayMedia",
DevicePrompt,
Medium,
),
s("webgl.getParameter", WebGl, High),
s("webgl.getSupportedExtensions", WebGl, Medium),
s("webgl.readPixels", WebGl, Medium),
s("navigator.gpu.requestAdapter", WebGl, High),
s("canvas.getContext", Canvas, Medium),
s("canvas.getImageData", Canvas, High),
s("canvas.measureText", Canvas, Medium),
s("canvas.toDataURL", Canvas, High),
s("audio.createAnalyser", Audio, Medium),
s("audio.createOscillator", Audio, Medium),
s("audio.getFloatFrequencyData", Audio, High),
s("audio.getChannelData", Audio, High),
s("audio.oscillator.start", Audio, Low),
s("audio.resume", Audio, Low),
s("audio.startRendering", Audio, Medium),
s("RTCPeerConnection", WebRtc, High),
s("RTCPeerConnection.createOffer", WebRtc, High),
s("RTCPeerConnection.createAnswer", WebRtc, Medium),
s("RTCPeerConnection.createDataChannel", WebRtc, Medium),
s("screen.width", Screen, High),
s("screen.height", Screen, High),
s("screen.colorDepth", Screen, Low),
s("screen.orientation.angle", Screen, Low),
s("screen.orientation.type", Screen, Low),
s("window.orientation", Screen, Low),
s("matchMedia", Screen, Medium),
s("Intl.DateTimeFormat", Timezone, High),
s("Intl.DateTimeFormat.resolvedOptions", Timezone, High),
s("document.hidden", Lifecycle, Medium),
s("document.visibilityState", Lifecycle, Medium),
s("document.visibilitychange", Lifecycle, Medium),
s("window.beforeunload", Lifecycle, Low),
s("window.pagehide", Lifecycle, Low),
s("window.name.read", Lifecycle, Low),
s("element.requestFullscreen", Lifecycle, Low),
s("element.requestPointerLock", Lifecycle, Low),
s("navigator.userActivation", Lifecycle, Low),
s("caches.open", Storage, Medium),
s("cache.add", Storage, Low),
s("cache.addAll", Storage, Low),
s("cache.match", Storage, Low),
s("cache.put", Storage, Low),
s("clipboard.readText", Storage, Medium),
s("clipboard.writeText", Storage, Medium),
s("showDirectoryPicker", Storage, Medium),
s("showOpenFilePicker", Storage, Medium),
s("showSaveFilePicker", Storage, Medium),
s("URL.createObjectURL", Storage, Low),
s("ethereum.on", CryptoAuth, Low),
s("solana.on", CryptoAuth, Low),
s("PublicKeyCredential.create", CryptoAuth, Medium),
s("PublicKeyCredential.get", CryptoAuth, Medium),
s(
"PublicKeyCredential.isConditionalMediationAvailable",
CryptoAuth,
Low,
),
s(
"PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable",
CryptoAuth,
Low,
),
s("PaymentRequest", CryptoAuth, Medium),
s("PaymentRequest.show", CryptoAuth, Low),
s("geolocation.getCurrentPosition", Sensor, Medium),
s("geolocation.watchPosition", Sensor, Medium),
s("DeviceMotionEvent.requestPermission", Sensor, Medium),
s("DeviceOrientationEvent.requestPermission", Sensor, Medium),
s("IntersectionObserver.observe", Sensor, Low),
s("MutationObserver.observe", Sensor, Low),
s("ResizeObserver.observe", Sensor, Low),
s("Notification.requestPermission", Notification, Medium),
s("navigator.serviceWorker.register", Notification, Medium),
s("pushManager.subscribe", Notification, Low),
s("periodicSync.register", Notification, Low),
s("sync.register", Notification, Low),
s("launchQueue.setConsumer", Notification, Low),
s("speechSynthesis.speak", Speech, Medium),
s("speechSynthesis.cancel", Speech, Low),
s("speechSynthesis.getVoices", Speech, Medium),
s("document.fonts.forEach", Font, Medium),
s("performance.now", Timing, Medium),
s("scheduler.postTask", Timing, Low),
s("VideoDecoder.isConfigSupported", Media, Medium),
s("VideoEncoder.isConfigSupported", Media, Medium),
s("VideoFrame", Media, Medium),
s("MediaCapabilities.decodingInfo", Media, Medium),
];
#[must_use]
pub const fn surfaces() -> &'static [FingerprintSurface] {
SURFACES
}
#[must_use]
pub fn by_category(category: SurfaceCategory) -> Vec<FingerprintSurface> {
SURFACES
.iter()
.copied()
.filter(|s| s.category == category)
.collect()
}
#[must_use]
pub fn must_cover() -> Vec<FingerprintSurface> {
SURFACES
.iter()
.copied()
.filter(|s| matches!(s.criticality, Criticality::Critical | Criticality::High))
.collect()
}
#[cfg(test)]
mod tests {
use super::*;
use std::collections::HashSet;
#[test]
fn inventory_is_substantial_and_unique() {
assert!(SURFACES.len() >= 90, "inventory shrank: {}", SURFACES.len());
let mut seen = HashSet::new();
for s in SURFACES {
assert!(seen.insert(s.surface), "duplicate surface: {}", s.surface);
}
}
#[test]
fn every_category_is_represented() {
use SurfaceCategory::*;
for cat in [
Navigator,
DevicePrompt,
WebGl,
Canvas,
Audio,
WebRtc,
Screen,
Timezone,
Lifecycle,
Storage,
CryptoAuth,
Sensor,
Notification,
Speech,
Font,
Timing,
Media,
] {
assert!(!by_category(cat).is_empty(), "no surfaces for {cat:?}");
}
}
#[test]
fn webdriver_is_the_one_critical_tell() {
let critical: Vec<_> = SURFACES
.iter()
.filter(|s| s.criticality == Criticality::Critical)
.map(|s| s.surface)
.collect();
assert_eq!(critical, vec!["navigator.webdriver"]);
}
#[test]
fn must_cover_is_a_meaningful_subset() {
let n = must_cover().len();
assert!(n >= 20 && n < SURFACES.len(), "must_cover sized wrong: {n}");
}
}