Access Tags

Genel Bakış

Her içerik herkes için değildir: yalnızca üyelere özel belgeler, bölgeye özgü materyaller, ücretli seviyelerin kaynakları. Access Tags ile tek bir chatbot farklı kitlelere güvenle hizmet eder. Bir bilgi öğesine etiket koyarsınız ve o andan itibaren öğe her ziyaretçi için görünmezdir — sayfası bu etiketi, kendi sunucunuz tarafından imzalanmış olarak sunanlar hariç. Kısıtlama, yapay zekâ modeli daha devreye girmeden, bizim getirme sorgumuzda uygulanır. Etiketi olmayan bir ziyaretçi içeriği kurnaz sorularla çekemez, çünkü onun için hiç getirilmemiştir.

Nasıl Çalışır

1. Bilgi öğelerini siz etiketlersiniz - Access Tags sayfasında veya doğrudan API ile; etiketsiz öğeler herkes için çalışmaya devam eder
2. Sunucunuz her ziyaretçinin etiketlerini imzalar - oturum açmış bir üye sayfanızı yüklediğinde, arka ucunuz haklarını belirler ve yalnızca sizde olan gizli bir anahtarla imzalar
3. Widget imzalı kanıtı gönderir - her sohbet mesajıyla birlikte gider; tarayıcı onu yalnızca taşır ve imzayı bozmadan değiştiremez
4. Biz doğrular ve filtreleriz - geçerli bir imza, eşleşen etiketli öğelerin kilidini açar; eksik, kurcalanmış veya süresi dolmuş bir kanıt, ziyaretçinin yalnızca herkese açık içerik alması demektir

Nasıl ayarlanır

Özelliği panelinizdeki Access Tags sayfasından açın — imzalama anahtarı otomatik oluşturulur. Yalnızca sunucunuzda saklayın; elinde olan herkes geçerli kanıtlar üretebilir.

İçeriğinizi aynı sayfada veya öğeleri API ile gönderirken etiketleyin:

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

Ardından sunucunuz imzalı kanıtı widget snippet'inin yanına yazdırsın. İmzalanacak mesaj, virgülle ayrılmış etiket listesidir; bir tane kullanıyorsanız dikey çizgiyle sona erme zamanına bağlanır:

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

Aynı imza Node.js ve Python'da:

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

Süre olmadan yalnızca etiket dizesini imzalayın. Süreyle, kanıt süresi geçtiği anda çalışmayı durdurur — haklar geri alınabildiğinde faydalıdır, çünkü ziyaretçi taze bir kanıt almak için sizin kontrolünüzdeki bir sayfayı yeniden yüklemek zorundadır.

Neler garanti edilir

• Sunucu tarafında uygulama - filtre, getirme sırasında veritabanı sorgumuzun içinde çalışır; yetkisiz ziyaretçiler için etiketli öğeler yapay zekânın bağlamında hiç yer almaz, dolayısıyla sızacak bir şey yoktur
• Her yerde fail-closed - imza yok, yanlış imza, süresi dolmuş kanıt, kapalı özellik, düşürülmüş plan: bu durumların her birinde ziyaretçi yalnızca herkese açık içerik alır, asla fazlasını değil
• Tarayıcı erişimi taklit edemez - geliştirici araçlarında etiketleri düzenlemek imzayı bozar; anahtar yalnızca sizin sunucunuzdadır
• Hak mantığınız sizde kalır - kimin hangi etiketi aldığına nasıl karar verdiğinizi asla öğrenmeyiz; yalnızca sunucunuzun bunu onayladığını doğrularız

Bilmekte fayda var

• Access Tags yetkilendirmedir, User Context kişiselleştirmedir - üyeyi yapay zekâya anlatmak için User Context kullanın; yapay zekânın hangi bilgiden yararlanabileceğini Access Tags ile yönetin
• Taranan site içeriği her zaman herkese açıktır - herkese açık sitenizden gelir, dolayısıyla kısıtlanacak bir şey yoktur; etiketler metin, dosya ve API öğeleri için geçerlidir
• Ziyaretçiye tek bir eşleşen etiket yeter - iki etiketli bir öğe, ikisinden herhangi birini taşıyan ziyaretçiye açıktır
• Anahtarı yeniden oluşturmak tüm eski kanıtları geçersiz kılar - anahtar sızmış olabilirse bunu yapın, sonra sayfalarınızı yenisiyle imzalayacak şekilde güncelleyin
• Etiket adları size kalmış - öğe başına en fazla 20, her biri 50 karakter, virgül ve dikey çizgi olmadan; ziyaretçilerin gördüğü sohbette asla görünmezler