ข้ามไปยังเนื้อหา

คีย์

FortressFlag มีคีย์สองชนิด และทั้งสองตั้งใจให้เป็นขั้วตรงข้ามกัน การรู้ว่าตัวไหนเป็นตัวไหน — และปฏิบัติกับแต่ละตัวให้เหมาะสม — คือเกือบทั้งหมดที่ต้องรู้

คีย์ไคลเอนต์ยืนยันตัวตนกับ client plane แอป iOS Android และเว็บของคุณ มันฝังไปในทุกสำเนาของแอปของคุณ และใครก็ตามที่มีไบนารีหรือซอร์สของหน้าเว็บคุณอ่านมันออกมาได้ การออกแบบตั้งอยู่บนสมมติฐานนั้น คีย์ไคลเอนต์

  • อ่านได้อย่างเดียว จำกัดขอบเขตที่ หนึ่งโปรเจกต์และหนึ่งสภาพแวดล้อม
  • ดึงได้เฉพาะค่าที่ประเมินแล้วของอุปกรณ์เครื่องเดียว — ไม่มีวันได้กฎของคุณ ไม่มีวันได้ข้อมูลของอุปกรณ์เครื่องอื่น ไม่มีวันได้อะไรจาก management API
  • ถูกจำกัดอัตราต่อคีย์และต่ออุปกรณ์

ดังนั้นใส่มันลงในคอนฟิกแอปของคุณได้อย่างสบายใจ สิ่งที่ใครสักคนเรียนรู้จากการถือคีย์ไคลเอนต์ของคุณคือคีย์ของ flag สำหรับสภาพแวดล้อมเดียว — ซึ่งเขาอ่านออกจากไบนารีที่คีย์นั้นมาด้วยได้อยู่แล้ว คำนำหน้า ffc_ มีอยู่เพื่อให้ secret scanner จำได้ว่านี่คือคีย์ไคลเอนต์ และ ไม่ต้อง ปลุกใคร

คีย์เซิร์ฟเวอร์ยืนยันตัวตนกับ server plane แบ็กเอนด์ของคุณเองที่ดาวน์โหลด ruleset ทั้งชุด — รวมกฎการเจาะกลุ่ม — เพื่อประเมินในเครื่อง ปฏิบัติกับมันเหมือนรหัสผ่านฐานข้อมูลทุกประการ

  • เก็บไว้ใน secret manager หรือตัวแปรสภาพแวดล้อม
  • ไม่อยู่ในโค้ดฝั่งไคลเอนต์ ไม่อยู่ในรีโพซิทอรี ไม่อยู่ใน log เด็ดขาด
  • คำนำหน้า ffs_ มีอยู่เพื่อให้เครื่องมือตรวจการรั่วไหลจัดมันเป็นความลับจริง ที่ต้องปลุกใครสักคน — ตรงข้ามกับ ffc_ โดยสิ้นเชิง และนั่นคือเหตุผลที่ทั้งสองไม่ใช้คำนำหน้าร่วมกัน

คีย์เซิร์ฟเวอร์ก็ถูกจำกัดขอบเขตที่หนึ่งโปรเจกต์และหนึ่งสภาพแวดล้อมเช่นกัน อ่านได้อย่างเดียว และเข้าถึง management API ไม่ได้ แต่รัศมีความเสียหายเมื่อรั่วคือกฎการเจาะกลุ่มของคุณ ไม่ใช่แค่คีย์ของ flag — จึงต้องดูแลต่างกัน

คีย์จัดการจากหน้าจอคีย์ SDK ของแต่ละโปรเจกต์ (Admin และ Owner สร้างและเพิกถอนได้ Developer ดูรายการได้)

  • การสร้าง ทำให้เกิดคีย์ที่ผูกกับหนึ่งโปรเจกต์ + หนึ่งสภาพแวดล้อม คีย์เต็มจะ เปิดเผยเพียงครั้งเดียว ตอนสร้าง — คัดลอกไว้ตอนนั้น เพราะหลังจากนั้นรายการจะแสดงแค่พอให้ระบุได้ ไม่มี “แสดงคีย์อีกครั้ง” คีย์ที่แสดงซ้ำได้คือคีย์ที่ถูกเก็บในรูปแบบที่ขโมยได้
  • การเพิกถอน มีผลตั้งแต่การใช้คีย์ครั้งถัดไป — ไม่ต้องปล่อยแอปเวอร์ชันใหม่ ไม่ต้องดีพลอย และปลอดภัยที่จะทำภายใต้แรงกดดัน SDK ที่ถือคีย์ที่ถูกเพิกถอนจะถอยกลับไปใช้แคชของตัวเองแทนที่จะพัง

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