การกู้คืนบัญชี
หากคุณถูกล็อกออกจาก SnapOtter (ส่วนใหญ่มักเกิดจากนโยบาย MFA ที่คุณไม่สามารถ ทำตามได้อีกต่อไป) คุณสามารถกู้คืนได้จากภายในคอนเทนเนอร์โดยไม่ต้องใช้ไคลเอนต์ ฐานข้อมูล คำสั่งกู้คืนทำงานแบบออฟไลน์และต้องมีสิทธิ์เข้าถึงเชลล์ของคอนเทนเนอร์ ซึ่งนั่นหมายถึงการมีสิทธิ์ควบคุมอินสแตนซ์อย่างเต็มที่อยู่แล้ว
ฉันติดกำแพงด่านไหน?
การเข้าสู่ระบบของ SnapOtter ใช้ด่าน MFA อิสระสองด่าน ให้วินิจฉัยก่อน:
bash
docker exec -it snapotter snapotter-admin statusคำสั่งนี้จะพิมพ์นโยบาย MFA ปัจจุบันและผู้ใช้รายใดที่ลงทะเบียน TOTP ไว้
- "MFA enrollment is required before login" (และคุณไม่เคยตั้งค่าแอปเลย): นโยบายกำหนดให้ต้องใช้ MFA แต่คุณยังไม่ได้ลงทะเบียน ให้ผ่อนคลายนโยบาย
- คุณถูกขอรหัสที่คุณสร้างไม่ได้ (ทำโทรศัพท์หายและรหัสกู้คืน หายด้วย): บัญชีของคุณได้ลงทะเบียนไว้แล้ว ให้ล้างการลงทะเบียนนั้น
ผ่อนคลายนโยบาย MFA
bash
docker exec -it snapotter snapotter-admin reset-mfa-policyคำสั่งนี้จะตั้งนโยบายกลับไปเป็น optional โดยจะมีผลในการเข้าสู่ระบบครั้งถัดไปโดยไม่ต้อง รีสตาร์ท คำสั่งนี้จะตั้งค่าเป็น optional เท่านั้น จึงไม่สามารถเปิดการบังคับใช้กลับมาได้
ล้างการลงทะเบียน TOTP ของผู้ใช้รายหนึ่ง
bash
docker exec -it snapotter snapotter-admin disable-mfa <username>หากนโยบายยังคงกำหนดให้ผู้ใช้รายนั้นต้องใช้ MFA พวกเขาจะไปติดกำแพงการลงทะเบียน ในครั้งถัดไป ดังนั้นให้รัน reset-mfa-policy ด้วย จากนั้นเข้าสู่ระบบและลงทะเบียนใหม่จากการตั้งค่า
รีเซ็ตรหัสผ่านที่ลืม
bash
docker exec -it snapotter snapotter-admin reset-password <username> [password]หากละ [password] ไว้ CLI จะพิมพ์รหัสผ่านชั่วคราวที่สร้างขึ้น ไม่ว่าจะระบุหรือไม่ เซสชันที่ใช้งานอยู่ คีย์ API และช่วงเวลาจำกัดการเข้าสู่ระบบที่ล้มเหลวของผู้ใช้จะถูกล้าง และ SnapOtter จะบังคับให้เปลี่ยนรหัสผ่านในการเข้าสู่ระบบครั้งถัดไป
สร้างบัญชีผู้ดูแลระบบเริ่มต้น
bash
docker exec -it snapotter snapotter-admin create-admin [username] [password]ใช้คำสั่งนี้เมื่อไม่มีบัญชีผู้ดูแลระบบที่มีอยู่สามารถเข้าสู่ระบบได้ [username] มีค่าเริ่มต้นเป็น DEFAULT_USERNAME (admin) และการละ [password] จะพิมพ์รหัสผ่านชั่วคราวที่ต้องเปลี่ยนเมื่อเข้าสู่ระบบครั้งแรก
ปลดล็อกผู้ใช้ที่ถูกจำกัดหรือถูกปิดใช้งาน
bash
docker exec -it snapotter snapotter-admin unlock-user <username>คำสั่งนี้จะล้างช่วงเวลา LOGIN_THROTTLED ใน Redis และคืนค่าบทบาทของบัญชีหากผู้ใช้ถูกปิดใช้งาน
อิมเมจรุ่นเก่าและทางเลือกสำรอง
บนอิมเมจที่สร้างขึ้นก่อนที่ตัวห่อ snapotter-admin จะมีอยู่ ให้เรียกสคริปต์ โดยตรง:
bash
docker exec -w /app/apps/api snapotter ./node_modules/.bin/tsx \
src/scripts/admin-recovery.ts reset-mfa-policyในทางเลือกสุดท้ายบนทุกเวอร์ชัน ให้ตั้งค่านโยบายในฐานข้อมูล บนอิมเมจ แบบออลอินวัน Postgres จะทำงานอยู่ภายในคอนเทนเนอร์:
bash
echo "UPDATE settings SET value = 'optional' WHERE key = 'mfaPolicy';" |
docker exec -i snapotter sh -c 'psql -p "${EMBEDDED_PG_PORT:-5432}" -U snapotter -d snapotter'บนการตั้งค่าแบบหลายคอนเทนเนอร์ ให้ชี้ psql ไปยัง DATABASE_URL ของคุณเองแทน
ถูกล็อกออกจาก SSO ไม่ใช่ MFA?
หากการเข้าสู่ระบบ SSO ที่ถูกบังคับใช้ล้มเหลว ให้ใช้บัญชีท้องถิ่นสำหรับกรณีฉุกเฉินแทน: ตั้งค่า ssoBreakGlassUsername ให้เป็นผู้ดูแลระบบท้องถิ่นภายใต้การตั้งค่า > ความปลอดภัยก่อนที่คุณจะ บังคับใช้ SSO แล้วเข้าสู่ระบบด้วยรหัสผ่านของบัญชีนั้น
