보안 & 인증

웹인증 v1

WEB

개요

웹인증 v1은 건물 입구에 세워둔 기본형 검문소입니다. Cloudflare Turnstile CAPTCHA("나는 로봇이 아닙니다" 체크 같은 녀석)와 IP 기록을 결합해, "일단 사람 손으로 클릭했는가"부터 확인합니다. 입장 멤버가 웹페이지에서 검문(인증)을 통과하면 출입증(지정 역할)이 자동으로 발급됩니다. 인증 데이터 보호를 위해 인증 서버 상호간 내부통신 암호화를 사용 중입니다 — 검문소끼리 주고받는 서류도 봉투에 봉인해서 옮기는 셈입니다.

대시보드에서 설정하기

웹인증 명령어(/인증 · /웹인증v2 · /웹인증 영구차단등록)는 2026년 11월 14일부터 없어졌습니다. 이제 모든 설정을 대시보드 → 웹인증 탭 한 곳에서 합니다 — 검문소 운영 대장을 한 권으로 합친 셈입니다. 채팅창에 /웹인증을 입력하면 이 탭으로 가는 버튼이 나옵니다.
웹인증 탭하는 일
01 인증 방식웹인증 v1 · v2 · v2.1 선택 · v2.1이면 입장 나이(한국 나이)
02 입장웹인증 켜기 · 인증 채널 · 인증 완료 역할(여러 개) · 웹인증 로그 채널
03 인증 유지재인증 주기(1~365일, 기본 90일) · 미인증 자동추방(1 · 3 · 7 · 14 · 30일)
04 인증 패널인증 버튼 패널 만들기 · 다시 만들기 · 삭제 — 인증 방식에 맞는 진행 순서(v1 3단계 · v2 4단계 · v2.1 5단계)가 표시되고, 방식을 바꾸면 올려 둔 패널도 자동으로 바뀝니다. 버튼을 누르면 누른 사람에게만 보이는 인증 링크가 뜹니다.
05 블랙서버블랙서버 목록 · 감지 시 처리 방식 · 처리별 DM 문구 (v2 · v2.1)
06 IP 관리IP 막기 · 풀기(IPv4 · IPv6) · 유저 IP 기록 초기화(부계정 오차단 해제)
07 영구 차단모든 서버 공통 · 해제 불가 웹인증 영구 차단 등록
08 기록인증 멤버 · 차단 기록 · 바이패스 이력 · Discord 로그인(v2 · v2.1) 기록

IP 차단 관리

특정 IP를 수동으로 차단해 웹 인증을 막습니다 — 검문소 블랙리스트에 특정 주소를 직접 올려두는 셈입니다. 웹인증 탭 「06 IP 관리」에서 IPv4 · IPv6 주소를 막고 풀 수 있고, 같은 IP 때문에 다른 계정이 막혔다면 그 유저의 IP 기록을 초기화하면 됩니다. 차단을 풀면 이 서버에 남은 그 IP의 인증 기록도 함께 지워집니다.

차단 기능

  • Tor Exit Node IP 자동 차단 — 변장 마스크(Tor)를 쓰고 온 방문자는 신원 확인 자체가 불가능하니 정문에서 바로 돌려보냅니다.
  • 동일 IP 다중 계정 인증 시도 감지 및 차단 (서버별로 독립 판정 — 다른 서버에서 인증한 기록은 이 서버 판정에 영향을 주지 않습니다). 같은 집 주소로 자기소개서를 10장 들고 온 사람을 보는 눈초리와 비슷합니다.
  • 추방·차단된 계정과 동일 IP 부계정 자동 차단 — 쫓겨난 사람이 변장하고 같은 현관으로 다시 들어오려는 수법을 미리 알아챕니다.
  • VPN/데이터센터 ASN 차단 (선택적) — "저는 그냥 평범한 가정집에서 왔는데요"라고 하기엔 주소가 데이터센터인 경우를 걸러냅니다.

IP 중복 차단 오탐 시 바이패스 승인

가족·회사 등 같은 네트워크를 공유하는 여러 유저가 한 서버에서 인증을 시도하면 IP 중복으로 오차단될 수 있습니다 — 한 집에 사는 가족이 전부 같은 집 주소라고 의심받는 셈이니, 억울할 만합니다. 이때 로그 채널의 차단 로그에 함께 표시되는 「✅ 바이패스 승인」 버튼을 관리자가 누르면, "알고 보니 한 가족이었네" 하고 정상 인증 완료 시 지급되는 것과 동일한 역할을 즉시 지급하고 오탐 처리를 완료할 수 있습니다.
  • 관리자 권한이 있는 사람만 버튼을 클릭할 수 있습니다.
  • 한 번 승인하면 버튼이 비활성화되어 중복 클릭·중복 지급을 방지합니다 — 보증은 한 번만 서는 겁니다.
  • 누가 언제 승인했는지는 별도의 CV2 로그로 로그 채널에 함께 기록됩니다.

인증 흐름

  1. 01
    멤버 입장
    새 멤버가 서버에 입장하면 인증 채널의 버튼이 안내됩니다 — 검문소 앞에 도착한 상황입니다.
  2. 02
    CAPTCHA 페이지
    버튼 클릭 시 해나봇 웹 인증 페이지로 이동. Cloudflare Turnstile CAPTCHA를 통과합니다 — "사람입니다"를 증명하는 간단한 손도장 확인입니다.
  3. 03
    IP 분석
    IP 주소 기반으로 Tor·VPN·악성 IP 여부를 실시간 확인합니다 — 신분증 뒷면까지 스캔해보는 단계입니다.
  4. 04
    역할 지급
    인증 통과 시 지정된 역할이 자동 부여되고 로그 채널에 기록됩니다 — 출입증이 발급되고, 발급 대장에도 기록이 남습니다.

설정 시 주의사항

  • 인증 채널은 @everyone 읽기 권한만 부여하고 다른 채널은 인증 역할 없이 접근 불가하도록 설정하세요 — 로비(인증 채널)까지는 누구나 들어올 수 있어도, 그 안쪽 사무실은 출입증이 있어야 들어갈 수 있게 만드는 구조입니다.
  • 인증 완료 역할(대시보드 웹인증 탭 「02 입장」)이 지정되지 않으면 인증 후 역할이 지급되지 않습니다 — 출입증을 찍어줄 도장 자체가 없는 상황입니다.
  • 봇 역할이 지급할 역할보다 서버 역할 목록에서 위에 있어야 합니다 — 출입증을 발급하는 직원의 직급이 그 출입증보다 낮으면 발급 권한이 없는 것과 같습니다.
  • 로그 채널은 봇과 관리자만 볼 수 있도록 권한을 제한하는 것을 권장합니다 — 출입 기록대장을 아무나 열람하게 두진 않겠죠.