Access Tags

Oversikt

Ikke alt innhold er for alle: dokumenter kun for medlemmer, regionsspesifikt materiale, ressurser for betalte nivåer. Med Access Tags betjener én chatbot ulike målgrupper trygt. Du setter en tagg på et kunnskapselement, og fra det øyeblikket er elementet usynlig for enhver besøkende — unntatt dem hvis side legger frem den taggen, signert av din egen server. Begrensningen håndheves i vår hentespørring, før KI-modellen i det hele tatt er involvert. En besøkende uten taggen kan ikke trekke ut innholdet med lure spørsmål, for for dem ble det aldri hentet.

Slik fungerer det

1. Du tagger kunnskapselementer - på Access Tags-siden eller direkte via API-et; elementer uten tagger fungerer fortsatt for alle
2. Serveren din signerer hver besøkendes tagger - når et innlogget medlem laster siden din, avgjør backenden din rettighetene deres og signerer dem med en hemmelig nøkkel bare du har
3. Widgeten sender det signerte beviset - det følger med hver chatmelding; nettleseren frakter det bare og kan ikke endre det uten å bryte signaturen
4. Vi verifiserer og filtrerer - en gyldig signatur låser opp elementer med samsvarende tagger; et manglende, manipulert eller utløpt bevis betyr at den besøkende bare får offentlig innhold

Slik setter du det opp

Slå på funksjonen på Access Tags-siden i dashbordet — en signeringsnøkkel genereres automatisk. Oppbevar den kun på serveren din; alle som har den, kan lage gyldige bevis.

Tagg innholdet enten på samme side eller når du sender elementer via API-et:

POST /api/v1/knowledge/text/
{
  "title": "Members-only price list",
  "content": "...",
  "website_id": "123",
  "access_tags": ["premium"]
}

La deretter serveren din skrive ut det signerte beviset ved siden av widget-snippeten. Meldingen som signeres er den kommaseparerte tagglisten, koblet med en loddrett strek til utløpstiden når du bruker en:

<?php
$tags    = "members,premium";          // this visitor's entitlements
$expires = time() + 3600;              // unix seconds, optional but recommended
$sig     = hash_hmac("sha256", $tags . "|" . $expires, $SECRET);
?>
<script>
window.Asyntai = window.Asyntai || {};
window.Asyntai.accessTags = "<?php echo $tags; ?>";
window.Asyntai.accessTagsExpires = "<?php echo $expires; ?>";
window.Asyntai.accessTagsSignature = "<?php echo $sig; ?>";
</script>

Samme signatur i Node.js og Python:

// Node.js
const crypto = require("crypto");
const sig = crypto.createHmac("sha256", SECRET)
                  .update(tags + "|" + expires).digest("hex");

# Python
import hmac, hashlib
sig = hmac.new(SECRET.encode(), f"{tags}|{expires}".encode(),
               hashlib.sha256).hexdigest()

Uten utløp signerer du bare taggstrengen alene. Med utløp slutter et bevis å virke i det øyeblikket det passeres — nyttig når rettigheter kan trekkes tilbake, siden den besøkende må laste inn en side du kontrollerer på nytt for å få et ferskt bevis.

Hva som garanteres

• Håndheving på serversiden - filteret kjører inne i databasespørringen vår ved henting; for uautoriserte besøkende er taggede elementer fraværende fra KI-ens kontekst, så det finnes ingenting å lekke
• Fail-closed overalt - ingen signatur, feil signatur, utløpt bevis, avslått funksjon, nedgradert plan: i hvert av disse tilfellene får den besøkende bare offentlig innhold, aldri mer
• Nettleseren kan ikke forfalske tilgang - å redigere taggene i utviklerverktøyene bryter signaturen; bare serveren din har nøkkelen
• Rettighetslogikken din forblir din - vi får aldri vite hvordan du avgjør hvem som får hvilken tagg; vi verifiserer bare at serveren din har bekreftet det

Godt å vite

• Access Tags er autorisasjon, User Context er personalisering - bruk User Context til å fortelle KI-en om medlemmet; bruk Access Tags til å styre hvilken kunnskap KI-en får bruke
• Crawlet nettstedsinnhold er alltid offentlig - det kommer fra ditt offentlige nettsted, så det er ingenting å begrense; tagger gjelder tekst-, fil- og API-elementer
• En besøkende trenger bare én samsvarende tagg - et element med to tagger er tilgjengelig for en besøkende som bærer en av dem
• Regenerering av nøkkelen ugyldiggjør alle gamle bevis - gjør det hvis nøkkelen kan ha lekket, og oppdater deretter sidene dine til å signere med den nye
• Taggnavnene bestemmer du selv - opptil 20 per element, 50 tegn hver, uten komma eller loddrette streker; de vises aldri i chatten besøkende ser