S3-export | cside docs

De Device Intelligence S3-export schrijft elke voltooide evaluatie naar een S3-bucket die je zelf bezit, zodat je vingerafdruk- en risicogegevens in je eigen datawarehouse, fraudetools of analysepijplijn kunt laden. Elk record bevat de volledige apparaatvingerafdruk plus de netwerk-, IP-, geo-, VPN- en botsignalen die cside voor dat bezoek heeft berekend.

Betaalde Device Intelligence-functie

De S3-export is beschikbaar in de betaalde Device Intelligence-abonnementen. Schakel hem in en configureer hem onder Settings > Device Intelligence in het dashboard. Bij een abonnementswijziging pauzeert of hervat de export automatisch, zonder herconfiguratie.

Hoe de levering werkt

Formaat: JSONL (JSON Lines). Elke regel is één volledig evaluatierecord, gecodeerd als application/x-ndjson.
Frequentie: cside uploadt één batch per uur.
Objectnaam: fingerprints-team-<team_id>-<from>-<to>.jsonl, waarbij <from> en <to> de uurgrenzen van de batch zijn.
Bestemming: jouw bucket. cside schrijft objecten, maar leest of toont ze nooit.

Aanbevolen lifecycle-regel

Uploads gebruiken S3-multipart. Een onderbroken upload laat zijn onderdelen in je bucket achter. Voeg een AbortIncompleteMultipartUpload lifecycle-regel toe zodat ze zich niet opstapelen.

Recordstructuur

Elke regel is een JSON-object met een set identiteitsvelden op het hoogste niveau plus geneste objecten voor elke signaalgroep:

Object	Beschrijving
`fingerprint`	De apparaatvingerafdruk (browser, hardware, rendering en omgevingssignalen).
`network_client_metrics`	TCP- en TLS-kenmerken van de verbinding.
`ip_enrichment`	ASN-, geo- en privacygegevens afgeleid van het bezoeker-IP.
`geo_lite_city_data`	Geolocatie op stadsniveau voor het bezoeker-IP.
`vpn_evaluation`	VPN-waarschijnlijkheid en ondersteunende signalen.
`bot_evaluation`	Botwaarschijnlijkheid, oordeel en ondersteunende signalen.
`fingerprint_enrichment`	Signalen afgeleid van de vingerafdruk, zoals detectie van wegwerp-e-mail.
`rule_evaluations`	Uitkomsten van de regels die voor dit bezoek zijn geëvalueerd.

Ontbrekende sleutels betekenen standaardwaarden

Een veld verschijnt alleen als het een niet-standaardwaarde heeft. Een ontbrekende sleutel betekent dat de waarde leeg was, false, 0, of niet is verzameld. Behandel bij het parsen van het bestand een ontbrekende sleutel als een standaardwaarde, niet als een fout.

Velden op het hoogste niveau

Veld	Type	Beschrijving
`evaluation_id`	string	Unieke ID van deze evaluatie. Ook aanwezig als `id`.
`customer_id`	string	De cside-ID van je domein. Ook aanwezig als `domain_id`.
`customer_domain`	string	Het geëvalueerde domein.
`team_id`	string	De ID van je cside-team.
`timestamp`	string	Tijd van de evaluatie, ISO 8601. Ook aanwezig als `created_at`.
`page_url`	string	De pagina waar de evaluatie is geactiveerd.
`session_id`	string	Browsersessie-ID.
`request_id`	string	Correlatie-ID van het oorspronkelijke verzoek.
`client_ip`	string	IP-adres van de bezoeker.
`user_agent`	string	User agent van de browser van de bezoeker.
`evaluation_status`	string	Status van de evaluatie. Alleen voltooide records.
`error_message`	string	Foutdetails van een mislukte evaluatie. Leeg voor voltooide records, dus normaal gesproken afwezig.
`device_fingerprint`	string	Compacte apparaatvingerafdruk-token (base64).
`threat_fingerprint`	string	Compacte dreigingsvingerafdruk-token (base64).

`fingerprint`-object

De apparaatvingerafdruk is het grootste object. De onderstaande tabellen groeperen de velden per categorie.

Identiteit

Veld	Type	Beschrijving
`device_id`	string	Stabiele apparaatidentificatie, afgeleid van de verzamelde signalen.

Browser en systeem

Veld	Type	Beschrijving
`product`	string	`navigator.product`-waarde van de browser.
`product_sub`	string	`navigator.productSub`-waarde van de browser.
`browser_name`	string	Naam van de browser.
`browser_version`	string	Versie van de browser.
`mobile`	boolean	Of de browser zich als mobiel meldt.
`apple_pay_version`	number	Versie van de Apple Pay-API, indien beschikbaar.
`user_agent`	string	User agent-tekenreeks van de browser.
`plugins`	string[]	Geïnstalleerde browserplug-ins.
`platform`	string	Platform van het besturingssysteem.
`cpu_architecture`	string	Gerapporteerde CPU-architectuur.
`hardware_architecture`	number	Indicator voor de hardware-architectuur.
`connection`	string	Type netwerkverbinding (bijvoorbeeld `4g`).

Rendering (Canvas, WebGL, WebGPU)

Veld	Type	Beschrijving
`canvas_signal`	string	Canvas-renderingsignaal.
`webgl_signal`	string	WebGL-renderingsignaal.
`webgl_vendor`	string	WebGL-leverancierstekenreeks.
`webgl_renderer`	string	WebGL-renderertekenreeks.
`video_card_vendor`	string	GPU-leverancier.
`video_card_renderer`	string	GPU-renderer.
`video_card_vendor_unmasked`	string	Niet-gemaskeerde GPU-leverancier, indien beschikbaar.
`video_card_renderer_unmasked`	string	Niet-gemaskeerde GPU-renderer, indien beschikbaar.
`video_card_version`	string	Versietekenreeks van het GPU-stuurprogramma.
`video_card_shading_language_version`	string	Versie van de shading-taal.
`webgpu_supported`	boolean	Of WebGPU wordt ondersteund.
`webgpu_adapter`	string	Beschrijving van de WebGPU-adapter.
`webgpu_signal`	string	WebGPU-renderingsignaal.

Taal en tijd

Veld	Type	Beschrijving
`timezone`	string	Gerapporteerde tijdzone.
`locale`	string	Gerapporteerde landinstelling.
`languages`	string[]	Geaccepteerde talen.

Audio

Veld	Type	Beschrijving
`audio_signal`	string	Audiovingerafdruksignaal.
`audio_max_channels`	number	Maximaal aantal audio-uitvoerkanalen.
`audio_channel_count_mode`	string	Modus voor het tellen van audiokanalen.

Hardware

Veld	Type	Beschrijving
`device_memory`	number	Gerapporteerd apparaatgeheugen, in GB.
`hardware_concurrency`	number	Aantal logische CPU-kernen.
`js_heap_size_limit`	number	JavaScript-heaplimiet, in bytes.
`math_values`	object	Resultaten van wiskundige precisieproeven, per bewerking.

Scherm

Veld	Type	Beschrijving
`screen_width`	number	Schermbreedte in pixels.
`screen_height`	number	Schermhoogte in pixels.
`screen_resolution`	string	Schermresolutietekenreeks.
`color_depth`	number	Kleurdiepte van het scherm.
`device_pixel_ratio`	number	Pixelverhouding van het apparaat.
`touch_support`	boolean	Of aanraakinvoer wordt ondersteund.
`max_touch_points`	number	Maximaal aantal gelijktijdige aanraakpunten.
`media_matches`	string[]	Overeenkomende CSS-mediaquery’s.

Browser-API’s

Veld	Type	Beschrijving
`online_status`	boolean	Of de browser zich als online meldt.
`do_not_track`	string	Do Not Track-instelling.
`cookies_enabled`	boolean	Of cookies zijn ingeschakeld.
`media_devices`	string[]	Beschikbare soorten media-apparaten.
`indexeddb_support`	boolean	Ondersteuning voor IndexedDB.
`localstorage_support`	boolean	Ondersteuning voor localStorage.
`sessionstorage_support`	boolean	Ondersteuning voor sessionStorage.
`bluetooth_support`	boolean	Ondersteuning voor Web Bluetooth.
`geolocation_support`	boolean	Ondersteuning voor de geolocatie-API.
`device_motion_support`	boolean	Ondersteuning voor apparaatbeweging.
`device_orientation_support`	boolean	Ondersteuning voor apparaatoriëntatie.
`speech_recognition_support`	boolean	Ondersteuning voor spraakherkenning.
`vibration_support`	boolean	Ondersteuning voor de vibratie-API.
`gamepad_support`	boolean	Ondersteuning voor de gamepad-API.
`fullscreen_support`	boolean	Ondersteuning voor de volledig-scherm-API.
`clipboard_support`	boolean	Ondersteuning voor de klembord-API.
`service_worker_support`	boolean	Ondersteuning voor Service Workers.
`webassembly_support`	boolean	Ondersteuning voor WebAssembly.

Voorkeuren

Veld	Type	Beschrijving
`prefers_dark_mode`	boolean	Voorkeur voor donker kleurenschema.
`prefers_reduced_motion`	boolean	Voorkeur voor beperkte beweging.

Lettertypen

Veld	Type	Beschrijving
`detected_fonts`	string[]	Op het apparaat gedetecteerde lettertypen.
`font_metrics`	object	Renderingmetrieken van lettertypen, per meting.

Netwerksignalen

Veld	Type	Beschrijving
`stun_ips`	string[]	Lokale IP-adressen ontdekt via STUN.
`permission_states`	object	Toestemmingsstatussen, per toestemmingsnaam.

WebRTC, spraak en MathML

Veld	Type	Beschrijving
`webrtc_supported`	boolean	Ondersteuning voor WebRTC.
`webrtc_hash`	string	Hash van de WebRTC-functieset.
`webrtc_details`	object	Gedetailleerde WebRTC-mogelijkheden.
`webrtc_error`	string	WebRTC-proeffout, indien opgetreden.
`speech_synthesis_supported`	boolean	Ondersteuning voor spraaksynthese.
`speech_hash`	string	Hash van de set spraaksyntheses-stemmen.
`speech_details`	object	Gedetailleerde spraaksynthesegegevens.
`speech_error`	string	Spraakproeffout, indien opgetreden.
`mathml_supported`	boolean	Ondersteuning voor MathML.
`mathml_hash`	string	Hash van de MathML-rendering.
`mathml_details`	object	Gedetailleerde MathML-renderinggegevens.
`mathml_error`	string	MathML-proeffout, indien opgetreden.

Prestaties en batterij

Veld	Type	Beschrijving
`fps`	number	Gemeten beelden per seconde.
`battery_info`	object	Batterijstatus: `charging`, `level`, `charging_time`, `discharging_time`.

Detectie van incognitomodus

Veld	Type	Beschrijving
`incognito_detected`	boolean	Of een privémodus is gedetecteerd.
`incognito_support`	string	Ondersteuningsniveau van de detectiemethode.
`incognito_method`	string	Gebruikte detectiemethode.
`incognito_quota_bytes`	number	Opslagquotum waargenomen tijdens de detectie.

Detectie van ontwikkelaarstools

Veld	Type	Beschrijving
`developer_tools_detected`	boolean	Of ontwikkelaarstools open lijken te staan.
`developer_tools_support`	string	Ondersteuningsniveau van de detectie.
`developer_tools_method`	string	Gebruikte detectiemethode.
`developer_tools_gap_px`	number	Venstermarge in pixels die voor detectie is gebruikt.

Detectie van virtuele machines

Veld	Type	Beschrijving
`virtual_machine_detected`	boolean	Of het apparaat een virtuele machine lijkt te zijn.
`virtual_machine_support`	string	Ondersteuningsniveau van de detectie.
`virtual_machine_reason`	string	Reden waarom het apparaat is gemarkeerd.

Automatisering en manipulatie

Veld	Type	Beschrijving
`web_driver`	boolean	Of `navigator.webdriver` is ingesteld.
`web_driver_tampered`	boolean	Of de webdriver-vlag gemanipuleerd lijkt.
`cdp`	boolean	Gebruik van het Chrome DevTools Protocol gedetecteerd.
`cdp_tampered`	boolean	Of CDP-signalen gemanipuleerd lijken.
`tamper_injected_globals`	string[]	Verdachte geïnjecteerde globale variabelen.
`tamper_expose_binding_leak`	boolean	Binding-lek dat wijst op automatisering.
`tamper_desc_instance_own`	string[]	Afwijkende eigen property-descriptors.
`tamper_desc_proto_nonnative`	string[]	Niet-native prototype-descriptors.
`tamper_xrealm_webdriver_mismatch`	boolean	Webdriver-verschil tussen realms.
`tamper_xrealm_renderer_delta`	boolean	Renderer-verschil tussen realms.
`tamper_probe_blocked`	boolean	Of manipulatieproeven zijn geblokkeerd.

Apparaatattestatie

Veld	Type	Beschrijving
`device_uvpaa`	boolean	Platformauthenticator met gebruikersverificatie beschikbaar.
`device_client_caps_count`	number	Aantal gerapporteerde clientmogelijkheden.
`device_caps_uvpa`	boolean	Mogelijkheid van de platformauthenticator.
`device_apple_pay_active_card`	boolean	Apple Pay heeft een actieve kaart.
`device_payment_enrolled`	boolean	Het apparaat is aangemeld voor een betaalmethode.
`device_serial_present`	boolean	Seriële mogelijkheid aanwezig.
`device_hid_present`	boolean	HID-mogelijkheid aanwezig.
`device_notif_static`	string	Statisch signaal van meldingsmogelijkheid.
`device_notif_queried`	string	Opgevraagd signaal van meldingsmogelijkheid.
`device_realness_probe_error`	boolean	Of een echtheidsproef is mislukt.

DRM

Veld	Type	Beschrijving
`drm_probed`	boolean	Of DRM-ondersteuning is getest.
`drm_clearkey`	boolean	Ondersteuning voor Clear Key.
`drm_widevine`	boolean	Ondersteuning voor Widevine.
`drm_widevine_robustness`	string	Robuustheidsniveau van Widevine.
`drm_externalclearkey`	boolean	Ondersteuning voor External Clear Key.
`drm_fairplay`	boolean	Ondersteuning voor FairPlay.
`drm_playready`	boolean	Ondersteuning voor PlayReady.
`drm_hw_secure_all`	boolean	Ondersteuning voor hardwarematig beveiligd decoderen.
`drm_ua_brand_is_google_chrome`	boolean	Het UA-merk claimt Google Chrome.
`drm_error`	string	DRM-proeffout, indien opgetreden.
`drm_elapsed_ms`	number	Duur van de DRM-proef, in milliseconden.

Door de klant verstrekte tags

Veld	Type	Beschrijving
`external_ids`	object	Identificatoren die je aan de vingerafdruk hebt gekoppeld, zoals `accountId`, `orderId` of `email`.
`extension_presence_results`	object	Gedetecteerde browserextensies, per extensie.

`network_client_metrics`-object

TCP- en TLS-kenmerken op verbindingsniveau.

Veld	Type	Beschrijving
`client_ip`	string	IP-adres van de bezoeker.
`client_port`	number	Bronpoort van de bezoeker.
`user_agent`	string	User agent gezien op netwerkniveau.
`js_timezone`	string	Door JavaScript gerapporteerde tijdzone.
`timestamp`	string	Tijd waarop het netwerkmonster is genomen, ISO 8601.
`request_id`	string	Verzoek-ID op netwerkniveau.
`protocol`	string	Gebruikt HTTP-protocol.
`quic_version`	number	QUIC-versie, wanneer de verbinding QUIC gebruikte.
`syn_ip_ttl`	number	IP-TTL van het eerste SYN-pakket.
`syn_window_size`	number	TCP-venstergrootte van de eerste SYN.
`syn_window_scale`	number	TCP-vensterschaal van de eerste SYN.
`tcp_rtt_usec`	number	Geschatte TCP-retourtijd, in microseconden.
`tcp_rttvar_usec`	number	Variantie van de TCP-retourtijd.
`tcp_rtt_min_usec`	number	Minimale waargenomen TCP-retourtijd.
`tcp_timestamp`	number	Waarde van de TCP-timestamp-optie.
`tcp_mss_syn`	number	Aangekondigde TCP-MSS.
`tcp_mss_rcv`	number	Waargenomen TCP-MSS van de peer.
`tls_handshake_usec`	number	Duur van de TLS-handshake, in microseconden.
`tls_clienthello_size`	number	Grootte van de ClientHello, in bytes.
`tls_sni_format`	string	Formaat van de SNI-extensie.
`tls_alpn_protocols`	string[]	ALPN-protocollen aangeboden in de TLS-handshake.
`tls_clienthello_ciphers`	number[]	Aangeboden cipher suites.
`tls_clienthello_extensions`	number[]	Aangeboden TLS-extensies.
`tls_clienthello_signature_algs`	number[]	Aangeboden handtekeningalgoritmen.
`tls_clienthello_legacy_version`	number	Legacy-versie van de ClientHello.
`tls_clienthello_supported_versions`	number[]	Aangeboden TLS-versies.
`tls_ja4`	string	JA4 TLS-clientvingerafdruk.
`matched_against`	string	Domein waartegen de verbinding is gematcht.
`team_id`	string	De ID van je cside-team.

`ip_enrichment`-object

Gegevens afgeleid van het IP-adres van de bezoeker.

Veld	Type	Beschrijving
`asn`	number	Autonoom Systeemnummer.
`asn_name`	string	Naam van de ASN-organisatie.
`asn_network`	string	Netwerkbereik van de ASN.
`asn_type`	string	Type ASN, zoals `hosting` of `isp`.
`city_name`	string	Naam van de stad.
`country_code`	string	Landcode.
`country_name`	string	Naam van het land.
`latitude`	number	Breedtegraad.
`longitude`	number	Lengtegraad.
`postal_code`	string	Postcode.
`region_code`	string	Regiocode.
`region_name`	string	Naam van de regio.
`timezone`	string	Tijdzone.
`hosting`	boolean	Het IP hoort bij een hostingprovider.
`proxy`	boolean	Het IP is een bekende proxy.
`relay`	boolean	Het IP is een private relay.
`tor`	boolean	Het IP is een Tor-exitnode.
`vpn`	boolean	Het IP is een bekende VPN.
`service`	string	Genoemde privacydienst, indien geïdentificeerd.
`maxmind_asn`	number	ASN volgens MaxMind.
`is_datacenter_ip`	boolean	Het IP valt in een datacenterbereik.
`is_likely_datacenter`	number	Waarschijnlijkheidsscore voor datacenter.

`geo_lite_city_data`-object

Geolocatie op stadsniveau.

Veld	Type	Beschrijving
`city_name`	string	Naam van de stad.
`country_code`	string	Landcode.
`country_name`	string	Naam van het land.
`latitude`	number	Breedtegraad.
`longitude`	number	Lengtegraad.
`postal_code`	string	Postcode.
`region_code`	string	Regiocode.
`region_name`	string	Naam van de regio.
`timezone`	string	Tijdzone.

`vpn_evaluation`-object

VPN-waarschijnlijkheid en ondersteunende signalen.

Veld	Type	Beschrijving
`is_vpn`	boolean	Of de bezoeker wordt geclassificeerd als VPN-gebruiker.
`vpn_probability`	number	VPN-waarschijnlijkheid van 0 tot 1.
`vpn_confidence`	number	Vertrouwen in de classificatie van 0 tot 1.
`reasons`	string[]	Leesbare redenen voor de classificatie.
`features`	object	Numerieke signalen die voor de classificatie zijn gebruikt.
`context`	object	Verrijkingscontext, zoals reverse-DNS-hostnaam, ASN en geo.

`bot_evaluation`-object

Botwaarschijnlijkheid en oordeel.

Veld	Type	Beschrijving
`is_bot`	boolean	Of de bezoeker wordt geclassificeerd als bot.
`bot_probability`	number	Botwaarschijnlijkheid van 0 tot 1.
`bot_confidence`	number	Vertrouwen in de classificatie van 0 tot 1.
`bot_agent_id`	string	Geïdentificeerde bot, indien bekend (bijvoorbeeld `google-googleother`).
`reasons`	string[]	Leesbare redenen voor de classificatie.
`session_event_count`	number	Aantal gedragsgebeurtenissen dat voor de sessie is verwerkt.
`model_1_score`	number	Score van het eerste botmodel (vingerafdruk- en netwerksignalen).
`model_1_threshold`	number	Beslissingsdrempel toegepast op de score van het eerste model.
`model_2_score`	number	Score van het tweede botmodel (gedragssignalen).
`model_2_threshold`	number	Beslissingsdrempel toegepast op de score van het tweede model.
`features`	object	Numerieke signalen die voor de classificatie zijn gebruikt.

`fingerprint_enrichment`-object

Veld	Type	Beschrijving
`throwaway_email_detected`	boolean	Of een gekoppeld e-mailadres een wegwerpdomein gebruikt.

`rule_evaluations`-object

Veld	Type	Beschrijving
`rules`	object[]	Uitkomsten van benoemde regels. Elke vermelding bevat `slot`, `rule_id`, `result`, `metadata` en `computed_at`.

Voorbeeldrecord

Eén record, hier opgemaakt voor de leesbaarheid. In het bestand staat elk record op één regel.

{
  "evaluation_id": "289076244130249728",
  "customer_id": "7371466449724252160",
  "customer_domain": "shop.example.com",
  "team_id": "7196353823991660544",
  "timestamp": "2026-04-21T17:53:19.378Z",
  "page_url": "https://shop.example.com/checkout",
  "client_ip": "203.0.113.42",
  "user_agent": "Mozilla/5.0 ... Chrome/124.0 Safari/537.36",
  "evaluation_status": "EVALUATION_STATUS_COMPLETED",
  "fingerprint": {
    "device_id": "fp_dev_5c8e21",
    "browser_name": "Chrome",
    "browser_version": "124.0.0.0",
    "platform": "MacIntel",
    "timezone": "America/Los_Angeles",
    "languages": ["en-US", "en"],
    "screen_width": 1512,
    "screen_height": 982,
    "device_memory": 8,
    "external_ids": { "orderId": "txn_9931" }
  },
  "network_client_metrics": {
    "client_ip": "203.0.113.42",
    "tls_ja4": "t13d1516h2_8daaf6152771_b186095e22b6"
  },
  "geo_lite_city_data": {
    "country_code": "US",
    "city_name": "San Francisco",
    "latitude": 37.7749,
    "longitude": -122.4194
  },
  "ip_enrichment": { "asn": 13335, "asn_name": "CLOUDFLARENET", "hosting": false },
  "vpn_evaluation": { "is_vpn": false, "vpn_probability": 0.04 },
  "bot_evaluation": { "is_bot": false, "bot_probability": 0.07 }
}