WEB

웹인증 v1

카테고리: 🔐 보안 & 인증

개요

Cloudflare Turnstile CAPTCHA와 IP 기록을 결합한 기본 웹 인증 방식입니다. 입장 멤버가 웹페이지에서 인증을 완료하면 지정 역할이 자동 부여됩니다. 인증 데이터 보호를 위해 인증 서버 상호간 내부통신 암호화를 사용 중입니다.

설정 명령어

>_
/인증 설정
관리자
인증 채널·역할 지정
>_
/인증 보안단계
관리자
인증 방식 선택 (일반/웹인증/웹인증 v2)
>_
/인증 패널생성
관리자
인증 버튼 패널을 채널에 배치
>_
/인증 해제
관리자
인증 시스템 비활성화
>_
/인증 정보
관리자
현재 인증 설정 확인

웹 인증 로그

>_
/인증 웹로그설정
관리자
웹 인증 로그 채널 지정
>_
/인증 웹로그해제
관리자
웹 인증 로그 채널 해제
>_
/인증 웹로그확인
관리자
웹 인증 로그 채널 현황 확인

IP 차단 관리

특정 IP를 수동으로 차단해 웹 인증을 막습니다. 오차단 발생 시 IP 기록을 초기화할 수 있습니다.

동일 IP 다중 계정으로 차단된 순간이라면, 명령어로 기록을 초기화하는 대신 차단 로그에 함께 뜨는 「바이패스 승인」 버튼을 눌러 바로 그 자리에서 역할까지 지급하며 처리할 수도 있습니다.
>_
/인증 ip해제 <사용자>
관리자
특정 사용자의 IP 기록 초기화 (부계정 오차단 해제)
>_
/인증 ip차단 <IP주소>
관리자
특정 IPv4 주소 수동 차단 — 해당 IP에서 웹 인증 불가
>_
/인증 ip차단해제 <IP주소>
관리자
수동 차단된 IP 주소 해제
>_
/인증 ip차단목록
관리자
수동 차단된 IP 주소 목록 확인

차단 기능

  • Tor Exit Node IP 자동 차단
  • 동일 IP 다중 계정 인증 시도 감지 및 차단 (서버별로 독립 판정 — 다른 서버에서 인증한 기록은 이 서버 판정에 영향을 주지 않습니다)
  • 추방·차단된 계정과 동일 IP 부계정 자동 차단
  • VPN/데이터센터 ASN 차단 (선택적)

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

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

인증 흐름

01
멤버 입장
새 멤버가 서버에 입장하면 인증 채널의 버튼이 안내됩니다.
02
CAPTCHA 페이지
버튼 클릭 시 도그봇 웹 인증 페이지로 이동. Cloudflare Turnstile CAPTCHA를 통과합니다.
03
IP 분석
IP 주소 기반으로 Tor·VPN·악성 IP 여부를 실시간 확인합니다.
04
역할 지급
인증 통과 시 지정된 역할이 자동 부여되고 로그 채널에 기록됩니다.

설정 시 주의사항

  • 인증 채널은 @everyone 읽기 권한만 부여하고 다른 채널은 인증 역할 없이 접근 불가하도록 설정하세요.
  • 인증 완료 역할(/인증 설정)이 지정되지 않으면 인증 후 역할이 지급되지 않습니다.
  • 봇 역할이 지급할 역할보다 서버 역할 목록에서 위에 있어야 합니다.
  • 로그 채널은 봇과 관리자만 볼 수 있도록 권한을 제한하는 것을 권장합니다.