WEB
웹인증 v1
개요
웹인증 v1은 건물 입구에 세워둔 기본형 검문소입니다. Cloudflare Turnstile CAPTCHA("나는 로봇이 아닙니다" 체크 같은 녀석)와 IP 기록을 결합해, "일단 사람 손으로 클릭했는가"부터 확인합니다.
입장 멤버가 웹페이지에서 검문(인증)을 통과하면 출입증(지정 역할)이 자동으로 발급됩니다.
인증 데이터 보호를 위해 인증 서버 상호간 내부통신 암호화를 사용 중입니다 — 검문소끼리 주고받는 서류도 봉투에 봉인해서 옮기는 셈입니다.
설정 명령어
>_
/인증 설정인증 채널·역할 지정
>_
/인증 보안단계인증 방식 선택 (일반/웹인증/웹인증 v2)
>_
/인증 패널생성인증 버튼 패널을 채널에 배치
>_
/인증 해제인증 시스템 비활성화
>_
/인증 정보현재 인증 설정 확인
>_
/인증 재인증주기 <주기|off|status>재인증 주기 변경(1~365일)·비활성화·현황 확인 (기본 90일 활성화)
웹 인증 로그
>_
/인증 웹로그설정웹 인증 로그 채널 지정
>_
/인증 웹로그해제웹 인증 로그 채널 해제
>_
/인증 웹로그확인웹 인증 로그 채널 현황 확인
IP 차단 관리
특정 IP를 수동으로 차단해 웹 인증을 막습니다 — 검문소 블랙리스트에 특정 주소를 직접 올려두는 셈입니다. 오차단 발생 시 IP 기록을 초기화할 수 있습니다.
동일 IP 다중 계정으로 차단된 순간이라면, 명령어로 기록을 초기화하는 대신 차단 로그에 함께 뜨는 「바이패스 승인」 버튼을 눌러 바로 그 자리에서("이 사람 제가 보증합니다") 역할까지 지급하며 처리할 수도 있습니다.
동일 IP 다중 계정으로 차단된 순간이라면, 명령어로 기록을 초기화하는 대신 차단 로그에 함께 뜨는 「바이패스 승인」 버튼을 눌러 바로 그 자리에서("이 사람 제가 보증합니다") 역할까지 지급하며 처리할 수도 있습니다.
>_
/인증 ip해제 <사용자>특정 사용자의 IP 기록 초기화 (부계정 오차단 해제)
>_
/인증 ip차단 <IP주소>특정 IPv4 주소 수동 차단 — 해당 IP에서 웹 인증 불가
>_
/인증 ip차단해제 <IP주소>수동 차단된 IP 주소 해제
>_
/인증 ip차단목록수동 차단된 IP 주소 목록 확인
차단 기능
- Tor Exit Node IP 자동 차단 — 변장 마스크(Tor)를 쓰고 온 방문자는 신원 확인 자체가 불가능하니 정문에서 바로 돌려보냅니다.
- 동일 IP 다중 계정 인증 시도 감지 및 차단 (서버별로 독립 판정 — 다른 서버에서 인증한 기록은 이 서버 판정에 영향을 주지 않습니다). 같은 집 주소로 자기소개서를 10장 들고 온 사람을 보는 눈초리와 비슷합니다.
- 추방·차단된 계정과 동일 IP 부계정 자동 차단 — 쫓겨난 사람이 변장하고 같은 현관으로 다시 들어오려는 수법을 미리 알아챕니다.
- VPN/데이터센터 ASN 차단 (선택적) — "저는 그냥 평범한 가정집에서 왔는데요"라고 하기엔 주소가 데이터센터인 경우를 걸러냅니다.
IP 중복 차단 오탐 시 바이패스 승인
가족·회사 등 같은 네트워크를 공유하는 여러 유저가 한 서버에서 인증을 시도하면 IP 중복으로 오차단될 수 있습니다 — 한 집에 사는 가족이 전부 같은 집 주소라고 의심받는 셈이니, 억울할 만합니다. 이때 로그 채널의 차단 로그에 함께 표시되는 「✅ 바이패스 승인」 버튼을 관리자가 누르면, "알고 보니 한 가족이었네" 하고 정상 인증 완료 시 지급되는 것과 동일한 역할을 즉시 지급하고 오탐 처리를 완료할 수 있습니다.
- 관리자 권한이 있는 사람만 버튼을 클릭할 수 있습니다.
- 한 번 승인하면 버튼이 비활성화되어 중복 클릭·중복 지급을 방지합니다 — 보증은 한 번만 서는 겁니다.
- 누가 언제 승인했는지는 별도의 CV2 로그로 로그 채널에 함께 기록됩니다.
인증 흐름
01
멤버 입장
새 멤버가 서버에 입장하면 인증 채널의 버튼이 안내됩니다 — 검문소 앞에 도착한 상황입니다.
02
CAPTCHA 페이지
버튼 클릭 시 도그봇 웹 인증 페이지로 이동. Cloudflare Turnstile CAPTCHA를 통과합니다 — "사람입니다"를 증명하는 간단한 손도장 확인입니다.
03
IP 분석
IP 주소 기반으로 Tor·VPN·악성 IP 여부를 실시간 확인합니다 — 신분증 뒷면까지 스캔해보는 단계입니다.
04
역할 지급
인증 통과 시 지정된 역할이 자동 부여되고 로그 채널에 기록됩니다 — 출입증이 발급되고, 발급 대장에도 기록이 남습니다.
설정 시 주의사항
- 인증 채널은 @everyone 읽기 권한만 부여하고 다른 채널은 인증 역할 없이 접근 불가하도록 설정하세요 — 로비(인증 채널)까지는 누구나 들어올 수 있어도, 그 안쪽 사무실은 출입증이 있어야 들어갈 수 있게 만드는 구조입니다.
- 인증 완료 역할(
/인증 설정)이 지정되지 않으면 인증 후 역할이 지급되지 않습니다 — 출입증을 찍어줄 도장 자체가 없는 상황입니다. - 봇 역할이 지급할 역할보다 서버 역할 목록에서 위에 있어야 합니다 — 출입증을 발급하는 직원의 직급이 그 출입증보다 낮으면 발급 권한이 없는 것과 같습니다.
- 로그 채널은 봇과 관리자만 볼 수 있도록 권한을 제한하는 것을 권장합니다 — 출입 기록대장을 아무나 열람하게 두진 않겠죠.
