Access Tags

ภาพรวม

เนื้อหาทั้งหมดไม่ได้มีไว้สำหรับทุกคน: เอกสารเฉพาะสมาชิก สื่อเฉพาะภูมิภาค ทรัพยากรของระดับแบบชำระเงิน ด้วย Access Tags แชตบอตเดียวให้บริการกลุ่มผู้ชมต่างๆ ได้อย่างปลอดภัย คุณติดแท็กที่รายการความรู้ และนับจากนั้นรายการจะมองไม่เห็นสำหรับผู้เยี่ยมชมทุกคน — ยกเว้นผู้ที่หน้าเว็บแสดงแท็กนั้น ซึ่งลงนามโดยเซิร์ฟเวอร์ของคุณเอง ข้อจำกัดถูกบังคับใช้ในคำสั่งค้นหาของเรา ก่อนที่โมเดล AI จะเข้ามาเกี่ยวข้องด้วยซ้ำ ผู้เยี่ยมชมที่ไม่มีแท็กไม่สามารถล้วงเนื้อหาด้วยคำถามแยบยล เพราะสำหรับเขา เนื้อหานั้นไม่เคยถูกดึงมาเลย

วิธีการทำงาน

1. คุณเป็นผู้ติดแท็กรายการความรู้ - ที่หน้า Access Tags หรือผ่าน API โดยตรง รายการที่ไม่มีแท็กยังคงใช้ได้กับทุกคน
2. เซิร์ฟเวอร์ของคุณลงนามแท็กของผู้เยี่ยมชมแต่ละคน - เมื่อสมาชิกที่ล็อกอินโหลดหน้าเว็บ แบ็กเอนด์ของคุณกำหนดสิทธิ์และลงนามด้วยคีย์ลับที่มีเพียงคุณเท่านั้น
3. วิดเจ็ตส่งหลักฐานที่ลงนาม - มันเดินทางไปกับทุกข้อความแชต เบราว์เซอร์เพียงแค่ส่งต่อและไม่สามารถแก้ไขโดยไม่ทำลายลายเซ็น
4. เราตรวจสอบและกรอง - ลายเซ็นที่ถูกต้องปลดล็อกรายการที่มีแท็กตรงกัน หลักฐานที่หายไป ถูกดัดแปลง หรือหมดอายุ หมายถึงผู้เยี่ยมชมได้เฉพาะเนื้อหาสาธารณะ

วิธีตั้งค่า

เปิดฟีเจอร์ที่หน้า Access Tags ในแดชบอร์ด — คีย์ลงนามจะถูกสร้างโดยอัตโนมัติ เก็บไว้บนเซิร์ฟเวอร์ของคุณเท่านั้น ใครก็ตามที่มีมันสามารถสร้างหลักฐานที่ถูกต้องได้

ติดแท็กเนื้อหาที่หน้าเดียวกัน หรือตอนส่งรายการผ่าน API:

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

จากนั้นให้เซิร์ฟเวอร์พิมพ์หลักฐานที่ลงนามไว้ข้างสนิปเพ็ตของวิดเจ็ต ข้อความที่ลงนามคือรายการแท็กคั่นด้วยจุลภาค เชื่อมด้วยขีดตั้งกับเวลาหมดอายุเมื่อคุณใช้:

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

ลายเซ็นเดียวกันใน Node.js และ 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()

หากไม่ใช้เวลาหมดอายุ ให้ลงนามเฉพาะสตริงแท็กเท่านั้น หากใช้ หลักฐานจะหยุดทำงานทันทีที่เลยกำหนด — มีประโยชน์เมื่อสิทธิ์อาจถูกเพิกถอน เพราะผู้เยี่ยมชมต้องโหลดหน้าที่คุณควบคุมใหม่เพื่อรับหลักฐานล่าสุด

ตรรกะของแท็ก

แท็กของรายการรวมกันแบบ AND: ระบบจะดึงรายการก็ต่อเมื่อทุกแท็กบนรายการนั้นปรากฏในหลักฐานของผู้เยี่ยมชม หลักฐานของผู้เยี่ยมชมจะมีสิทธิ์กี่รายการก็ได้ และการจับคู่จะทำกับทั้งหมดพร้อมกัน

AND เป็นการออกแบบโดยตั้งใจ หากจับคู่แบบ «อย่างน้อยหนึ่ง» การเพิ่มแท็กที่สองให้รายการจะขยายว่าใครเห็นได้ ดังนั้นการจำกัดเอกสารให้เหลือสองกลุ่มจะกลายเป็นการเผยแพร่เอกสารทั้งฉบับให้ทั้งสองกลุ่ม ส่วนการจับคู่แบบ «ทั้งหมด» ทุกแท็กที่เพิ่มจะยิ่งจำกัดมากขึ้นเท่านั้น ความผิดพลาดจึงตกไปทางฝั่งที่ปลอดภัย

การแสดง «อย่างใดอย่างหนึ่ง»

ให้ละมิตินั้นไว้ไม่ต้องใส่ในรายการ ถ้าหลักฐานของผู้เยี่ยมชมทุกคนมีภูมิภาคของตนอยู่แล้ว เอกสารที่ไม่มีแท็กภูมิภาคจะใช้ได้กับทุกภูมิภาค ขณะที่แท็กอื่นยังมีผลอยู่ ดังนั้นรายการที่ติดแท็กเพียง premium จึงหมายถึง «ภูมิภาคใดก็ได้ เฉพาะสมาชิกพรีเมียม»

หากต้องการทางเลือกข้ามมิติจริง ๆ — เช่น เหนือ-กับ-พื้นฐาน หรือ ใต้-กับ-พรีเมียม เท่านั้น — ให้เพิ่มรายการสองครั้ง ครั้งละหนึ่งชุดผสม หรือให้ทั้งสองกลุ่มมีแท็กร่วมที่เซิร์ฟเวอร์ของคุณใส่ไว้ในหลักฐานของพวกเขา

ข้อจำกัด

• สูงสุด 20 แท็กต่อหนึ่งรายการความรู้
• สูงสุด 50 แท็กในหลักฐานของผู้เยี่ยมชมหนึ่งคน
• แท็กละ 50 อักขระ ห้ามใช้จุลภาคและขีดตั้ง เนื่องจากหลักฐานเป็นสตริงที่คั่นด้วยจุลภาค

การเปลี่ยนแท็กภายหลัง

เปลี่ยนแท็กบนรายการที่มีอยู่ได้โดยไม่ต้องอัปโหลดใหม่ การเปลี่ยนแปลงมีผลตั้งแต่คำถามถัดไป โดยไม่มีการประมวลผลเนื้อหาซ้ำ

POST /api/v1/knowledge/<id>/tags/
{
  "access_tags": ["premium"]
}

ส่งรายการว่างเพื่อทำให้รายการกลับเป็นสาธารณะ คุณยังแก้ไขแท็กด้วยตนเองได้ที่หน้า Access Tags ในแดชบอร์ด

สิ่งที่รับประกัน

• บังคับใช้ฝั่งเซิร์ฟเวอร์ - ตัวกรองทำงานในคำสั่งค้นหาฐานข้อมูลของเราตอนดึงข้อมูล สำหรับผู้เยี่ยมชมที่ไม่ได้รับอนุญาต รายการติดแท็กไม่อยู่ในบริบทของ AI เลย จึงไม่มีอะไรจะรั่ว
• Fail-closed ทุกกรณี - ไม่มีลายเซ็น ลายเซ็นผิด หลักฐานหมดอายุ ฟีเจอร์ปิด แผนถูกลดระดับ: ทุกกรณีเหล่านี้ ผู้เยี่ยมชมได้เฉพาะเนื้อหาสาธารณะ ไม่มากไปกว่านั้น
• เบราว์เซอร์ปลอมสิทธิ์ไม่ได้ - การแก้แท็กในเครื่องมือนักพัฒนาทำให้ลายเซ็นพัง คีย์อยู่ที่เซิร์ฟเวอร์ของคุณเท่านั้น
• ตรรกะสิทธิ์ยังเป็นของคุณ - เราไม่มีทางรู้ว่าคุณตัดสินใจอย่างไรว่าใครได้แท็กไหน เราเพียงตรวจสอบว่าเซิร์ฟเวอร์ของคุณยืนยันแล้ว

ควรทราบ

• Access Tags คือการให้สิทธิ์ User Context คือการปรับเฉพาะบุคคล - ใช้ User Context บอก AI เกี่ยวกับสมาชิก ใช้ Access Tags ควบคุมว่า AI ดึงความรู้ใดได้
• เนื้อหาเว็บไซต์ที่รวบรวมมาเป็นสาธารณะเสมอ - มาจากเว็บไซต์สาธารณะของคุณ จึงไม่มีอะไรต้องจำกัด แท็กใช้กับรายการข้อความ ไฟล์ และ API
• แท็กของรายการรวมกันแบบ AND - ดูตรรกะของแท็กด้านบน ทุกแท็กของรายการต้องมีอยู่ในหลักฐานของผู้เยี่ยมชม
• การสร้างคีย์ใหม่ทำให้หลักฐานเก่าทั้งหมดใช้ไม่ได้ - ทำเมื่อคีย์อาจรั่วไหล แล้วอัปเดตหน้าเว็บให้ลงนามด้วยคีย์ใหม่
• ชื่อแท็กแล้วแต่คุณ - สูงสุด 20 ต่อรายการ แต่ละอัน 50 อักขระ ไม่มีจุลภาคหรือขีดตั้ง และไม่ปรากฏในแชตที่ผู้เยี่ยมชมเห็นเลย