เข้าสู่ระบบนัดหมายรับฟังข้อมูลสรุป (or นัดหมายพูดคุยกับทีมงาน)

บทที่ 2.12

การเรียกใช้งานครั้งแรก

จากระบบที่ยังไม่มีการอ้างสิทธิ์ไปสู่การที่ผู้คนเริ่มทำงาน สร้างรหัสอ้างสิทธิ์ อ้างสิทธิ์ระบบที่ติดตั้งในเบราว์เซอร์ สร้างผู้ดูแลระบบคนแรกด้วยพาสคีย์ จากนั้นเชื่อมต่อระบบลงชื่อเข้าใช้ของบริษัทและเชิญคนอื่นๆ ทั้งหมด

หน้านี้แปลโดย AI จากต้นฉบับภาษาอังกฤษ หากมีส่วนใดไม่ชัดเจน โปรดอ้างอิงจากหน้าภาษาอังกฤษ อ่านหน้านี้เป็นภาษาอังกฤษ

ใช้เวลาอ่าน 18 นาที

เมื่อการติดตั้งเสร็จสิ้น การติดตั้งนั้นยังไม่มีใครเป็นเจ้าของ โดยยังไม่มีองค์กร ไม่มีบุคคล และไม่มีเซสชัน และไม่มีใครสามารถลงชื่อเข้าใช้ได้ ระบบจะรอให้บุคคลคนหนึ่งพิสูจน์ในเบราว์เซอร์ว่าพวกเขากำลังสื่อสารกับการติดตั้งที่เพิ่งสร้างขึ้น ที่ Harrow Port Authority บุคคลนั้นคือ Aoife Brennan หัวหน้าฝ่ายไอที โดยมี Tomás Reilly อยู่ข้างๆ เธอที่เทอร์มินัล บทนี้จะติดตามช่วงยี่สิบนาทีแรกของพวกเขา

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

ลำดับกล่องจากซ้ายไปขวา: "nexusctl claim-code (เทอร์มินัล)", "ยืนยันสิทธิ์การติดตั้งนี้ (เบราว์เซอร์: รหัส + ลายนิ้วมือดิจิทัล)", "ผู้ดูแลระบบคนแรกและองค์กร", "พาสคีย์ (การตรวจสอบขั้นที่สอง)", "วันนี้ เมื่อทุกอย่างยังใหม่", "หกสิ่งก่อนที่ใครจะลงชื่อเข้าใช้", "เชิญผู้คน" ใต้กล่องการยืนยันสิทธิ์ มีกิ่งสีแดงสองกิ่งแยกลงมา: "รหัสเก่าเกินไป: CLAIM_CODE_EXPIRED, สร้างรหัสใหม่" และ "ลายนิ้วมือดิจิทัลไม่ตรงกัน: CLAIM_FINGERPRINT_MISMATCH, หยุด" เส้นบางๆ ใต้สามกล่องแรกมีป้ายกำกับว่า "แต่ละขั้นตอนจะปิดขั้นตอนก่อนหน้าอย่างถาวร"
การใช้งานครั้งแรก ตั้งแต่เทอร์มินัลไปจนถึงหน้า Today หน้าแรก และสองจุดที่อาจทำให้การทำงานหยุดลง

สร้างรหัสอ้างสิทธิ์

รหัสอ้างสิทธิ์ช่วยพิสูจน์ว่าบุคคลที่อยู่หน้าเบราว์เซอร์สามารถมองเห็นเทอร์มินัลของผู้ที่มีสิทธิ์เข้าถึงคลัสเตอร์ได้ด้วย เฉพาะบุคคลดังกล่าวเท่านั้นที่สามารถสร้างรหัสนี้ได้ ให้รันคำสั่งนี้ในที่ที่ kubeconfig ของคุณเข้าถึงคลัสเตอร์ได้:

nexusctl claim-code --administrator aoife.brennan@harrow.example

nexusctl claim-code จะขอให้เซอร์วิสจัดการคีย์ของการติดตั้ง ซึ่งก็คือ nexus-keys สร้างรหัสขึ้นมา หากไม่มี nexusctl คำสั่งเดียวกันนี้จะรันในพ็อดของเซอร์วิสจัดการคีย์เอง:

kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
  --administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"

--source คือข้อความสั้นๆ ที่ระบุว่าใครเป็นผู้สร้างรหัส หน้าการอ้างสิทธิ์จะแสดงข้อความเหล่านี้ใต้หัวข้อ "Made by" เพื่อให้ผู้ที่ทำการอ้างสิทธิ์ทราบว่ารหัสนั้นมาจากที่ใด

 Code  7KQM-4TXD-PL9R  works once, for 30 minutes, until 09:55 · 5 tries
 Fingerprint of this installation, to compare in the browser:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

สามสิ่งสำคัญเกี่ยวกับรหัสนี้

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

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

อ้างสิทธิ์ระบบที่ติดตั้ง

  1. บนคอมพิวเตอร์ที่คุณจะใช้ในฐานะผู้ดูแลระบบคนแรก ให้เปิดที่อยู่สำหรับการติดตั้งของคอนโซล ซึ่งในที่นี้คือ https://console.harrow.example/install ระบบจะส่งคุณไปยังหน้าที่ถูกต้องตามสถานะของการติดตั้ง ได้แก่ หน้าการอ้างสิทธิ์ในขณะที่ยังเปิดอยู่ หน้าของผู้ดูแลระบบคนแรกเมื่อมีการอ้างสิทธิ์แล้ว และหน้าคอนโซลหากคุณลงชื่อเข้าใช้เรียบร้อยแล้ว
  2. ในหน้า Claim this installation ให้พิมพ์รหัสลงใน Group one, Group two และ Group three โดยใส่กลุ่มละสี่ตัวอักษรในแต่ละช่อง
  3. เปรียบเทียบ Fingerprint of this installation ของหน้าเว็บกับที่แสดงบนเทอร์มินัล ทั้งแปดกลุ่ม ทีละกลุ่ม
  4. หากตรงกันทุกกลุ่ม ให้ทำเครื่องหมายที่ All eight groups match what my terminal shows
  5. กด Claim this installation จากนั้นหน้าเว็บจะยืนยันการอ้างสิทธิ์และส่งคุณต่อไปยังส่วนของผู้ดูแลระบบคนแรก
อ้างสิทธิ์การติดตั้งนี้
อ้างสิทธิ์การติดตั้งนี้
หน้าการอ้างสิทธิ์ รหัสจะถูกแบ่งใส่เป็นสามกลุ่ม ลายนิ้วมือฉบับเต็มจะแสดงเป็นแปดกลุ่ม กลุ่มละสี่ตัวอักษรเพื่อใช้เปรียบเทียบกับเทอร์มินัล และการ์ดทางด้านขวาจะระบุว่ารหัสมาจากที่ใดและเหลือจำนวนครั้งให้ลองได้อีกกี่ครั้ง

การอ้างสิทธิ์จะทำสามสิ่ง ประการแรกคือทำให้เบราว์เซอร์นี้เป็นเพียงที่เดียวที่สามารถสร้างผู้ดูแลระบบคนแรกได้ ประการที่สองคือบันทึกว่าใครเป็นผู้อ้างสิทธิ์ในการติดตั้งและเมื่อใดลงในบันทึกการตรวจสอบ (audit log) และประการสุดท้ายคือปิดหน้าการอ้างสิทธิ์อย่างถาวร ตั้งแต่นั้นเป็นต้นไป ที่อยู่สำหรับการอ้างสิทธิ์จะตอบกลับว่าการติดตั้งนี้ถูกอ้างสิทธิ์ไปแล้ว

หากลายนิ้วมือไม่ตรงกัน ให้หยุดทันที

ลายนิ้วมือที่ต่างออกไปหมายความว่ามีการติดตั้งอื่นกำลังตอบกลับอยู่ที่ที่อยู่นี้ ซึ่งอาจเกิดจากการพิมพ์ที่อยู่ผิด ระเบียน DNS (Domain Name System) ที่ล้าสมัย หรือเครื่องที่ถูกตั้งค่าไว้เพื่อดักจับผู้ดูแลระบบคนแรก หากคุณอ้างสิทธิ์ไป เครื่องนั้นจะครอบครององค์กรของคุณ

อย่าอ้างสิทธิ์ และอย่าพิมพ์รหัสลงในหน้านั้น ให้ปิดหน้านั้นลง แล้วตรวจสอบสองสิ่ง: ตรวจสอบว่า console.harrow.example ชี้ไปยัง ingress ของคุณ และตรวจสอบว่าใบรับรองที่เบราว์เซอร์แสดงนั้นออกโดย CA (certificate authority) ที่คุณคาดไว้ การติดตั้งของคุณเองจะยังคงไม่เปลี่ยนแปลงและยังไม่มีการอ้างสิทธิ์

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

ลายนิ้วมือไม่ตรงกัน
ลายนิ้วมือไม่ตรงกัน
หน้าที่ระบบนำมาเมื่อลายนิ้วมือไม่ตรงกัน กลุ่มที่แตกต่างกันจะถูกทำเครื่องหมายไว้ และมีขั้นตอนให้ตรวจสอบที่อยู่และใบรับรองก่อนที่จะพิมพ์ข้อมูลอื่นใดลงไป

สร้างผู้ดูแลระบบคนแรกและองค์กร

หน้าถัดไปจะมีหัวข้อว่า "Two short forms, then you are in" ผู้ดูแลระบบคนแรกสามารถเพิ่มคนอื่นๆ ทั้งหมดได้ และเกือบทุกอย่างในหน้านี้สามารถเปลี่ยนแปลงในภายหลังได้ มีสองสิ่งที่ไม่สามารถเปลี่ยนได้ ซึ่งหน้าเว็บจะทำเครื่องหมายระบุไว้

ฟิลด์ ข้อมูลที่ต้องกรอก เปลี่ยนในภายหลังได้หรือไม่
ชื่อ-นามสกุล ชื่อของคุณ ได้
อีเมลที่ทำงาน ที่อยู่อีเมลที่ใช้สร้างรหัสอ้างสิทธิ์ จะแสดงขึ้นมาโดยไม่ต้องพิมพ์ซ้ำ เป็นที่อยู่อีเมลของผู้ดูแลระบบ
บทบาทใน Nexus ผู้ดูแลระบบขององค์กร บุคคลแรกจะเป็นผู้ดูแลระบบเสมอ ไม่ได้เลือกที่นี่
การตรวจสอบครั้งที่สอง พาสคีย์บนแล็ปท็อปเครื่องนี้ ได้ สามารถเพิ่มได้อีก
Name (ขององค์กร) Harrow Port Authority ได้
ประเทศ สถานที่ตั้งขององค์กร ได้
ชื่อย่อในที่อยู่ สร้างจากชื่อ เช่น harrow-port-authority ไม่ได้ ลิงก์และการส่งออกข้อมูลจะใช้ชื่อนี้
ตำแหน่งที่จัดเก็บข้อมูล การติดตั้งนี้ ไม่ได้ การเปลี่ยนในภายหลังหมายถึงต้องทำการติดตั้งใหม่
ภาษาและรูปแบบวันที่ อังกฤษ (สหราชอาณาจักร) พร้อมวันที่ของวันนี้ ได้
เขตเวลา เขตเวลาของเซิร์ฟเวอร์ แต่ละคนจะเห็นเวลาในเขตเวลาของตนเอง

ชื่อย่อประกอบด้วยตัวอักษรพิมพ์เล็ก ตัวเลข และเครื่องหมายยัติภังค์ ความยาวสูงสุด 100 ตัวอักษร ซึ่งสร้างขึ้นจากชื่อขององค์กรโดยตัดเครื่องหมายกำกับเสียงออก โปรดตรวจสอบให้ดีก่อนกดปุ่มใดๆ ชื่อนี้จะปรากฏในทุกลิงก์ที่ผู้คนแชร์และทุกการส่งออกข้อมูลที่พวกเขาทำ ตลอดระยะเวลาที่องค์กรยังคงอยู่

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

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

นอกจากนี้ หน้าเว็บยังระบุด้วยว่า Adverant จะไม่ทราบว่าคุณเป็นใคร รายละเอียดเหล่านี้จะอยู่ในการติดตั้งเท่านั้น ใบอนุญาตใช้งานจะระบุเพียงชื่อบริษัท แต่จะไม่ระบุชื่อบุคคลภายในบริษัท

กด Create and sign in การสร้างผู้ดูแลระบบและองค์กรจะใช้เวลาไม่กี่วินาที หน้าเว็บจะตอบกลับว่า "Made for aoife.brennan@harrow.example. Now set up your passkey: it is how you sign in."

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

พาสคีย์: การตรวจสอบขั้นที่สอง

  1. กด Set up the passkey and sign in
  2. เบราว์เซอร์ของคุณจะขอให้คุณสร้างพาสคีย์ บนแล็ปท็อปที่มี Touch ID หรือ Windows Hello ให้ยืนยันด้วยลายนิ้วมือ ใบหน้า หรือ PIN หากคอมพิวเตอร์ไม่สามารถสร้างพาสคีย์ได้ด้วยตนเอง เบราว์เซอร์จะแสดงรหัส QR (quick response): ให้หันกล้องโทรศัพท์ของคุณไปที่รหัสนั้นและทำตามขั้นตอนบนโทรศัพท์
  3. หน้าเว็บจะตอบกลับว่า "Your passkey is set up and you are signed in as aoife.brennan@harrow.example." และเปิดคอนโซลขึ้นมา

คุณมีเวลาสิบนาทีนับจากที่กด Create and sign in เพื่อสร้างพาสคีย์ในเบราว์เซอร์เดิม หลังจากนั้นการตั้งค่าจะถูกปิดลง และผู้ดูแลระบบจะถูกสร้างขึ้นโดยไม่มีพาสคีย์ ซึ่งจะต้องให้ผู้ปฏิบัติงานระบบ (operator) เข้ามาช่วยตามที่อธิบายไว้ในหัวข้อการลองใหม่ด้านล่าง

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

ในภายหลัง ผู้คนจะลงชื่อเข้าใช้การติดตั้งด้วยพาสคีย์, ด้วย Google, ด้วย GitHub หรือด้วยระบบการลงชื่อเข้าใช้ของบริษัท ขึ้นอยู่กับว่าองค์กรอนุญาตให้ใช้วิธีใด

รหัส ความหมาย สิ่งที่ต้องทำ
PASSKEY_UNSUPPORTED เบราว์เซอร์นี้ไม่สามารถสร้างพาสคีย์ได้ ยังไม่มีการตั้งค่าใดๆ เปิดหน้านี้ในเบราว์เซอร์ที่รองรับพาสคีย์ บนคอมพิวเตอร์เครื่องเดิม
PASSKEY_CANCELLED หน้าต่างแจ้งเตือนถูกปิดไป หรือไม่ได้เลือกสิ่งใดภายในเวลาที่กำหนด ไม่มีข้อมูลใดถูกส่งออกไป กดปุ่มอีกครั้ง

หน้า Today ครั้งแรก

คอนโซลจะเปิดขึ้นมาที่หน้า Today และในวันแรกเกือบทุกอย่างบนหน้านั้นจะว่างเปล่า แต่ละพื้นที่ที่ว่างเปล่าจะระบุว่ามีสิ่งใดที่จะปรากฏขึ้นที่นั่นและมีปุ่มสำหรับเริ่มต้นใช้งาน เช่น "Needs an administrator" จะบอกว่าคำขอต่างๆ จะรออยู่ที่นั่นเมื่อมีผู้คนเข้าร่วม พร้อมปุ่ม Invite people ที่อยู่ข้างๆ รายการตรวจสอบการตั้งค่าจะบอกว่ามีกี่ขั้นตอนที่ทำเสร็จแล้วโดยไม่เรียงลำดับ ประวัติการใช้งานจริงเพียงอย่างเดียวที่มีอยู่ ซึ่งก็คือการตั้งค่านั่นเอง จะแสดงอยู่ใต้หัวข้อ "What changed" เรียบร้อยแล้ว ได้แก่ การตั้งค่าการติดตั้ง และการสร้างพาสคีย์ของผู้ดูแลระบบคนแรก

หน้า Today เมื่อทุกอย่างยังใหม่
หน้า Today เมื่อทุกอย่างยังใหม่
หน้า Today ในวันแรก ทุกพื้นที่ที่ว่างเปล่าจะระบุว่ามีสิ่งใดที่จะปรากฏขึ้นที่นั่นและจะเริ่มต้นใช้งานได้อย่างไร และหัวข้อ "What changed" ก็ได้บันทึกข้อมูลการตั้งค่าไว้เรียบร้อยแล้ว

หกสิ่งที่ต้องทำก่อนที่ใครจะลงชื่อเข้าใช้

หน้า Six things before anyone signs in จะแสดงรายการสิ่งที่ต้องเป็นจริงก่อนที่จะเชิญผู้คนเข้าร่วม หน้านี้ไม่ใช่ตัวช่วยสร้างแบบทีละขั้นตอน (wizard) คุณสามารถทำสิ่งเหล่านี้ในลำดับใดก็ได้ และหน้าเว็บจะนับจำนวนให้ ("Three of six true")

รายการ สิ่งที่ทำให้รายการนี้เป็นจริง
ใบอนุญาต นำเข้าใบอนุญาตใช้งานแบบ Enterprise แล้ว ดูที่ บทที่ 2.13 ใบอนุญาตใช้งาน ส่วนแบบ Community ไม่ต้องใช้ใบอนุญาตใช้งาน
ที่อยู่และใบรับรอง ที่อยู่สาธารณะตอบกลับด้วยใบรับรองที่มีเชน (chain) สมบูรณ์
การสำรองข้อมูล ตั้งค่ากำหนดการสำรองข้อมูลแล้ว พร้อมระบุปลายทางที่สามารถเขียนข้อมูลลงไปได้
การลงชื่อเข้าใช้ขององค์กร เชื่อมต่อและทดสอบแล้ว จนกว่าจะถึงตอนนั้น ผู้คนจะใช้พาสคีย์
อีเมล ตั้งค่าเมลเซิร์ฟเวอร์แล้ว จนกว่าจะถึงตอนนั้น จะไม่สามารถส่งคำเชิญได้
โมเดล AI โมเดล AI (artificial intelligence): คีย์โมเดลขององค์กร หรือโมเดลบนฮาร์ดแวร์ของคุณเอง จนกว่าจะถึงตอนนั้น ผู้ช่วยจะอยู่ในสถานะรอ ดูที่ บทที่ 2.14 ผู้ให้บริการและโมเดล AI

ปุ่ม Invite people จะเปิดให้ใช้งานเมื่อทั้งหกรายการเป็นจริง

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

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

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

การลงชื่อเข้าใช้ของบริษัท

องค์กรส่วนใหญ่ต้องการให้ผู้คนลงชื่อเข้าใช้ด้วยบัญชีที่พวกเขามีอยู่แล้ว เชื่อมต่อผู้ให้บริการข้อมูลประจำตัว (identity provider) ของคุณในหน้าการลงชื่อเข้าใช้ของบริษัท: ผ่าน OIDC (OpenID Connect) สำหรับแบบ Community หรือผ่าน OIDC หรือ SAML (Security Assertion Markup Language) สำหรับแบบ Enterprise

  1. เลือกผู้ให้บริการและมาตรฐานที่ผู้ให้บริการนั้นใช้
  2. ป้อนข้อมูลประจำตัวแอปพลิเคชัน (application identity) และข้อมูลลับแอปพลิเคชัน (application secret) ที่ผู้ให้บริการข้อมูลประจำตัวมอบให้คุณ ข้อมูลลับจะไม่แสดงขึ้นมาอีกเลยหลังจากที่คุณบันทึกไปแล้ว
  3. ระบุว่าใครสามารถลงชื่อเข้าใช้ได้บ้าง ตัวอย่างเช่น ใครก็ตามที่มีที่อยู่อีเมล @harrow.example
  4. กด Test sign-in และลงชื่อเข้าใช้ด้วยบัญชีของคุณเอง ผลลัพธ์จะระบุเป็นข้อความว่าใครที่ลงชื่อเข้าใช้และผู้ให้บริการส่งข้อมูลใดมาบ้าง
  5. บันทึก

แบบ Community จะได้รับการลงชื่อเข้าใช้ของบริษัทหนึ่งรายการสำหรับองค์กร ส่วนแบบ Enterprise จะเพิ่มการบังคับใช้และการซิงค์ไดเรกทอรี การบังคับใช้จะปิดการใช้รหัสผ่าน ดังนั้นทุกคนจึงต้องใช้การลงชื่อเข้าใช้ของบริษัท และความพยายามในการใช้รหัสผ่านจะถูกปฏิเสธด้วยรหัส SSO_REQUIRED พร้อมปุ่มที่นำไปยังช่องทางเข้าที่ถูกต้อง การซิงค์ไดเรกทอรีจะคัดลอกผู้คนและกลุ่มจากไดเรกทอรีของคุณทุกๆ 15 นาที และสามารถสร้างผู้ดูแลระบบจากกลุ่มที่ระบุชื่อไว้หนึ่งกลุ่มได้

เมื่อระบบการลงชื่อเข้าใช้ของบริษัทหยุดการตอบสนอง ผู้คนที่ลงชื่อเข้าใช้อยู่แล้วจะยังคงอยู่ในระบบต่อไป และความพยายามในการลงชื่อเข้าใช้ใหม่จะถูกปฏิเสธด้วยรหัส IDP_UNREACHABLE (503) เมื่อถึงตอนนั้น ผู้ดูแลระบบจะสามารถใช้ข้อมูลการลงชื่อเข้าใช้ฉุกเฉินสำหรับผู้ดูแลระบบจากตู้นิรภัยร่วมกับพาสคีย์ของตนได้ ทุกการใช้งานจะถูกบันทึกลงในบันทึกการตรวจสอบ แจ้งให้ผู้ดูแลระบบทุกคนทราบ และจะสิ้นสุดลงหลังจากผ่านไปสี่ชั่วโมงหรือเมื่อระบบการลงชื่อเข้าใช้ของบริษัทกลับมาทำงานตามปกติ

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

เชิญผู้คน

เมื่อตั้งค่าระบบเมลเรียบร้อยแล้ว ให้เชิญผู้คนจากหน้า People สำหรับแต่ละคน ให้ระบุอีเมลและบทบาทของพวกเขา:

  • Member (สมาชิก) สามารถใช้ทุกอย่างที่องค์กรมีได้และไม่สามารถเปลี่ยนแปลงการตั้งค่าใดๆ ได้
  • Administrator (ผู้ดูแลระบบ) สามารถจัดการผู้คน โมเดล งบประมาณ และการตั้งค่าต่างๆ ได้ด้วย

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

สมาชิกที่ได้รับเชิญจะลงชื่อเข้าใช้คอนโซลและทำงานประจำวันของตนที่นั่น ได้แก่ Today, ผู้ช่วย, แชทของทีม, ไฟล์และการค้นหา, สมุดบันทึก, เอเจนต์ และเวิร์กโฟลว์ ตามที่บทบาทของตนอนุญาต ผู้ดูแลระบบจะเห็นหน้าการดูแลระบบด้วยเช่นกัน สมาชิกที่เปิดหน้าของผู้ดูแลระบบจะพบกับหน้า "Not an administrator" ซึ่งจะแสดงการตั้งค่าแบบอ่านอย่างเดียว อธิบายเหตุผล และมีตัวเลือกให้ส่งคำขอไปยังผู้ดูแลระบบ

เชิญเพื่อนร่วมงาน
เชิญเพื่อนร่วมงาน
คำเชิญจะเลือกบทบาทของบุคคลนั้นไว้ล่วงหน้าก่อนที่พวกเขาจะเข้ามา ไม่ว่าจะเป็น Member หรือ Administrator และสามารถแนบข้อความสั้นๆ ไปด้วยได้

การสมัครใช้งานต้องได้รับการอนุมัติ

ผู้คนยังสามารถขอเข้าร่วมด้วยการสมัครใช้งานด้วยตนเองได้อีกด้วย ในการติดตั้ง การสมัครใช้งานของคนแปลกหน้าจะไม่สร้างบัญชีที่ใช้งานได้ทันที โดย nexus-auth จะปฏิเสธด้วยรหัส SIGNUP_REQUIRES_APPROVAL (403) และระงับไว้เพื่อรอการอนุมัติจากผู้ดูแลระบบ

มีการควบคุมการสมัครใช้งานอีกสองรายการที่มีอยู่ในบริการแบบโฮสต์ของ Adverant แต่จะถูกปิดไว้ในทุกการติดตั้ง โดยไม่มีค่าให้เปิดใช้งาน รายการแรกคือ CAPTCHA ทางอินเทอร์เน็ตซึ่งจำเป็นต้องใช้อินเทอร์เน็ตในทุกการสมัครใช้งาน รายการที่สองคือการคัดกรองเครือข่ายที่สมัครใช้งานซึ่งจำเป็นต้องใช้ฐานข้อมูลระบุตำแหน่งทางภูมิศาสตร์ที่มีใบอนุญาตซึ่งการติดตั้งไม่ได้มีติดมาด้วย ดังนั้น การอนุมัติจึงเป็นด่านคัดกรองของการติดตั้ง

การลองใหม่ รหัสที่หมดอายุ และการปฏิเสธอื่นๆ

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

รหัส สถานะ เมื่อใด สิ่งที่ต้องทำ
CLAIM_CODE_EXPIRED 410 เวลาผ่านไปครบ 30 นาทีแล้ว ไม่มีการอ้างสิทธิ์ใดๆ และไม่มีสิ่งใดเปลี่ยนแปลง สร้างรหัสใหม่ด้วย nexusctl claim-code --administrator <email> จากนั้นกด I have a new code
CLAIM_FINGERPRINT_MISMATCH 403 ลายนิ้วมือที่ส่งไปไม่ใช่ของการติดตั้งนี้ หยุดทันที ตรวจสอบที่อยู่และใบรับรอง
TRANSITION_NOT_PERMITTED 409 มีการร้องขอขั้นตอนที่เกิดขึ้นไปแล้วซ้ำอีกครั้ง: การอ้างสิทธิ์ในการติดตั้งที่ถูกอ้างสิทธิ์ไปแล้ว หรือการสร้างผู้ดูแลระบบคนแรกเป็นครั้งที่สอง ลงชื่อเข้าใช้ที่คอนโซล ผู้ดูแลระบบคนแรกจะเป็นผู้เพิ่มคนอื่นๆ ทั้งหมด
TRANSITION_NOT_PERMITTED 409 ขั้นตอนพาสคีย์ ที่ทำจากเบราว์เซอร์ที่ไม่มีผู้ดูแลระบบคนแรกรออยู่ หรือทำหลังจากหมดเวลาสิบนาทีไปแล้ว ดูด้านล่าง
RATE_LIMITED 429 มีความพยายามมากเกินไปในหน้าการใช้งานครั้งแรกภายในหนึ่งนาที ไม่มีข้อมูลใดถูกส่งออกไป รอตามจำนวนวินาทีที่หน้าเว็บระบุ จากนั้นจึงลองอีกครั้ง

รหัสที่ไม่เหลือจำนวนครั้งให้ลองแล้วจะแสดงข้อความว่า "This code has no tries left" ให้สร้างรหัสใหม่เช่นเดียวกับกรณีที่รหัสหมดอายุ มีเพียงผู้ที่มีสิทธิ์เข้าถึงคลัสเตอร์เท่านั้นที่สามารถทำได้ ซึ่งนั่นคือจุดประสงค์ของระบบ

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

เมื่อพลาดขั้นตอนพาสคีย์

หากสร้างผู้ดูแลระบบคนแรกแล้วแต่ไม่ได้สร้างพาสคีย์ภายในเวลาสิบนาที หรือเบราว์เซอร์ถูกปิดไป ผู้ดูแลระบบจะถูกสร้างขึ้นโดยไม่มีช่องทางในการลงชื่อเข้าใช้ ขั้นตอนพาสคีย์จะตอบกลับเป็นรหัส TRANSITION_NOT_PERMITTED พร้อมข้อความว่า "If you made the first administrator in this browser over ten minutes ago, ask an operator: the administrator exists and has no passkey yet" ณ จุดนั้น การอ้างสิทธิ์ได้ถูกใช้ไปแล้ว ดังนั้นรหัสอ้างสิทธิ์ใหม่จึงไม่สามารถช่วยได้ โปรดติดต่อผู้ปฏิบัติงานระบบที่เป็นผู้รันการติดตั้งก่อนที่จะลองทำสิ่งอื่นใด

เมื่อเบราว์เซอร์ทำข้อมูลการอ้างสิทธิ์สูญหาย

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

เมื่อ Aoife มีพาสคีย์ของเธอแล้ว Tomás ก็ปิดเทอร์มินัลของเขา หน้าการอ้างสิทธิ์ถูกปิดลง ผู้ดูแลระบบคนแรกถูกสร้างขึ้นแล้ว และทุกช่องทางในการเข้าสู่ระบบหลังจากนี้จะดำเนินการผ่านเธอ