Denne oversættelse er maskinoversat og afventer gennemgang.Skift til engelsk
Mørk
Log indAnmod om en gennemgang

// UDVIKLEREVALUERING

Få overblik over, hvad der kører hvor, før du integrerer.

Browseren indsamler tilgængelig evidens. Din server udfører det autentificerede opslag. Din applikation ejer kundepolitikken og al reservehåndtering.

// TILLIDSGRÆNSER

En overdragelse fra browser til server med tydeligt ejerskab.

  1. Kundens klient

    Indlæser den offentlige indsamler og sender et returneret enheds-id til kundens backend.

    Reservehåndtering: Blokeret JavaScript, begrænset browserkapabilitet eller fejl i indsamlingen giver ingen ny evidens.

  2. Noxtica-behandling

    Behandler evidens, som browserkapabilitet, tenantpolitik og samtykkestatus tillader.

    Reservehåndtering: Et manglende eller utilgængeligt resultat er ikke et resultat med lav risiko.

  3. Kundens server

    Holder API-legitimationsoplysninger hemmelige og udfører det autentificerede enhedsopslag.

    Reservehåndtering: Manglende, ugyldige, ratebegrænsede og utilgængelige svar forbliver adskilte.

  4. Kundens politik

    Kombinerer opslaget med kundeejet konto-, handlings- og misbrugskontekst.

    Reservehåndtering: Noxtica træffer ikke den endelige beslutning om at tillade, optrappe, gennemgå eller afvise.

  5. Undersøgelse og måling

    Operatører sammenligner foreslåede handlinger med bekræftede resultater før håndhævelse.

    Reservehåndtering: En vellykket installation alene udgør ikke en produktionsklar politik.

// VEDLIGEHOLDT FORLØB

Den mindste aktuelle integrationsvej.

Disse eksempler gengives fra fixtures, som kontrolleres af testen for udviklerudsnit. Erstat alle syntetiske værdier med legitimationsoplysninger og identifikatorer, der er udstedt til din evaluering.

1. Indsaml i browseren

Den offentlige loader er den eneste browserudgivelse, der aktuelt er verificeret. Den leverer et enheds-id eller en fejltilstand; den modtager aldrig serverlegitimationsoplysninger.

<script src="https://collect.noxtica.com/collector/noxtica-collector-core.js" data-site-key="pk_example_replace_me" data-extensions="auto" data-auto-init data-auto-check-once async></script>
<script>
  document.addEventListener('noxtica:collected', (event) => {
    const deviceId = event.detail?.fingerprintId;
    document.dispatchEvent(new CustomEvent('app:noxtica-evidence', {
      detail: deviceId ? { state: 'received', deviceId } : { state: 'invalid' },
    }));
  });

  document.addEventListener('noxtica:error', () => {
    document.dispatchEvent(new CustomEvent('app:noxtica-evidence', {
      detail: { state: 'unavailable' },
    }));
  });
</script>

2. Foretag opslaget på din server

Send enheds-id'et til din backend, og kald derefter den autentificerede v1-rute med en nøgle, der opbevares på serveren.

export async function lookupDevice({ deviceId, apiKey, fetchImpl = fetch }) {
  const response = await fetchImpl(
    `https://collect.noxtica.com/v1/device/${encodeURIComponent(deviceId)}`,
    { headers: { Authorization: `Bearer ${apiKey}` } },
  );

  if (response.status === 404) return { state: 'missing' };
  if (response.status === 429) return { state: 'rate_limited' };
  if (!response.ok) return { state: 'unavailable' };

  return { state: 'received', record: await response.json() };
}

3. Hold resultattilstande adskilt

Kun en komplet modtaget post indgår i den numeriske politik. Manglende, ugyldige, ratebegrænsede og utilgængelige tilstande følger eksplicitte reservehåndteringer defineret af kunden.

export function classifyLookup(result) {
  if (!result || result.state === 'unavailable') return { state: 'unavailable' };
  if (result.state === 'rate_limited') return { state: 'rate_limited' };
  if (result.state === 'missing') return { state: 'missing' };

  const record = result.record;
  if (!record || typeof record.score !== 'number' || typeof record.confidence !== 'number') {
    return { state: 'invalid' };
  }

  return {
    state: 'received',
    score: record.score,
    riskLevel: record.riskLevel,
    confidence: record.confidence,
  };
}

// VERIFICERET 2026-09-20

Aktuel matrix for offentlig support.

Kun flader, der understøttes af en offentlig udgivelse eller en tilgængelig API-grænse, er angivet. En privat kildefortegnelse er ikke et supportløfte.

FladeTilgængelighedAktuel udgivelseAnsvar og begrænsningerVejledning
Loader til browserindsamlerOffentligt tilgængelig3.2.0Verificeret 2026-09-20

Indlæser browserindsamleren fra Noxticas collector-origin. Rapporterer et indsamlingsresultat eller en utilgængelig tilstand til applikationskoden.

Evidens, der er tilgængelig for den aktuelle browser, tenantpolitik og samtykkestatus. Kræver JavaScript. Browserkapabilitet eller politik kan reducere den tilgængelige evidens.

Se eksempelLæs vejledningen
HTTP API til autentificeret enhedsopslagKræver evalueringsadgangv1Verificeret 2026-09-20

Modtager kun et enheds-id fra kundens server. Returnerer posten med tenantafgrænsning, når legitimationsoplysninger og omfang tillader det.

Den autentificerede post, der er tilgængelig for den klargjorte tenant. Kræver evalueringsadgang og legitimationsoplysninger, der opbevares på serveren; en uautentificeret anmodning afvises.

Se eksempelLæs vejledningen

// EVALUERINGSPUNKTER

Dokumentér overdragelsen, før politikken ændres.

  1. Klargør den nøjagtige origin og den offentlige Site Key til evalueringen.
  2. Observer både fuldført indsamling og adfærd ved utilgængelighed.
  3. Overfør kun det returnerede enheds-id til kundens backend.
  4. Udfør det autentificerede opslag med legitimationsoplysninger, der opbevares på serveren.
  5. Afprøv tilstandene modtaget, manglende, ugyldig, ratebegrænset og utilgængelig.
  6. Evaluer den foreslåede politik i observationstilstand før håndhævelse.