Access Tags

Yleiskatsaus

Kaikki sisältö ei ole kaikille: vain jäsenille tarkoitetut asiakirjat, aluekohtainen materiaali, maksullisten tasojen resurssit. Access Tagsin avulla yksi chatbot palvelee eri yleisöjä turvallisesti. Lisäät tunnisteen tietämyskohteeseen, ja siitä hetkestä kohde on näkymätön jokaiselle kävijälle — paitsi niille, joiden sivu esittää kyseisen tunnisteen, oman palvelimesi allekirjoittamana. Rajoitus valvotaan hakukyselyssämme, ennen kuin tekoälymalli on edes mukana. Kävijä ilman tunnistetta ei voi kaivaa sisältöä esiin ovelilla kysymyksillä, koska sitä ei koskaan haettu hänelle.

Miten se toimii

1. Sinä merkitset tietämyskohteet - Access Tags -sivulla tai suoraan API:n kautta; merkitsemättömät kohteet toimivat edelleen kaikille
2. Palvelimesi allekirjoittaa jokaisen kävijän tunnisteet - kun kirjautunut jäsen lataa sivusi, taustajärjestelmäsi päättää hänen oikeutensa ja allekirjoittaa ne salaisella avaimella, joka on vain sinulla
3. Widget lähettää allekirjoitetun todisteen - se kulkee jokaisen chat-viestin mukana; selain vain kuljettaa sitä eikä voi muuttaa sitä rikkomatta allekirjoitusta
4. Me tarkistamme ja suodatamme - kelvollinen allekirjoitus avaa kohteet, joiden tunnisteet täsmäävät; puuttuva, peukaloitu tai vanhentunut todiste tarkoittaa, että kävijä saa vain julkista sisältöä

Käyttöönotto

Kytke toiminto päälle hallintapaneelin Access Tags -sivulla — allekirjoitusavain luodaan automaattisesti. Säilytä se vain palvelimellasi; kuka tahansa sen haltija voi luoda kelvollisia todisteita.

Merkitse sisältösi joko samalla sivulla tai lähettäessäsi kohteita API:n kautta:

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

Anna sitten palvelimesi tulostaa allekirjoitettu todiste widget-koodinpätkän viereen. Allekirjoitettava viesti on pilkuin eroteltu tunnisteluettelo, yhdistettynä pystyviivalla vanhenemisaikaan, jos käytät sellaista:

<?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>

Sama allekirjoitus Node.js:llä ja Pythonilla:

// 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()

Ilman vanhenemisaikaa allekirjoita pelkkä tunnistemerkkijono. Sen kanssa todiste lakkaa toimimasta vanhenemishetkellä — hyödyllistä, kun oikeuksia voidaan perua, sillä kävijän on ladattava hallitsemasi sivu uudelleen saadakseen tuoreen todisteen.

Mitä taataan

• Palvelinpuolen valvonta - suodatin toimii tietokantakyselymme sisällä haun aikana; valtuuttamattomien kävijöiden kohdalla merkityt kohteet puuttuvat tekoälyn kontekstista, joten mitään ei voi vuotaa
• Fail-closed kaikkialla - ei allekirjoitusta, väärä allekirjoitus, vanhentunut todiste, toiminto pois päältä, tilaus alennettu: jokaisessa näistä tapauksista kävijä saa vain julkista sisältöä, ei koskaan enempää
• Selain ei voi väärentää pääsyä - tunnisteiden muokkaaminen kehittäjätyökaluissa rikkoo allekirjoituksen; avain on vain sinun palvelimellasi
• Oikeuslogiikkasi pysyy sinun - emme koskaan saa tietää, miten päätät kuka saa minkä tunnisteen; tarkistamme vain, että palvelimesi on sen vahvistanut

Hyvä tietää

• Access Tags on valtuutusta, User Context personointia - kerro User Contextilla tekoälylle jäsenestä; ohjaa Access Tagsilla, mistä tietämyksestä tekoäly saa ammentaa
• Indeksoitu sivustosisältö on aina julkista - se tulee julkiselta sivustoltasi, joten rajattavaa ei ole; tunnisteet koskevat teksti-, tiedosto- ja API-kohteita
• Kävijälle riittää yksi täsmäävä tunniste - kohde, jolla on kaksi tunnistetta, on saatavilla kävijälle, jolla on jompikumpi niistä
• Avaimen uudelleenluonti mitätöi kaikki vanhat todisteet - tee se, jos avain on voinut vuotaa, ja päivitä sitten sivusi allekirjoittamaan uudella
• Tunnisteiden nimet päätät itse - enintään 20 kohdetta kohden, kukin 50 merkkiä, ei pilkkuja eikä pystyviivoja; ne eivät koskaan näy kävijöiden näkemässä chatissa