GitHub Trending오픈소스 · 도구

JenkinWoo/sheeridVerify

학생 신분 검증 자동화 도구, Node.js 기반 오픈소스 공개

원제 JenkinWoo/sheeridVerify

스타 1,787JavaScript
Key Point

학생 신분 검증 자동화 도구를 만드는 개발자와 보안 감시자가 이 구현 방식(브라우저 제어, 문서 업로드, 상태 폴링, 프록시 통합)과 제약(20 MiB 크기, 3회 재시도, 메모리만 보존)을 정확히 파악해야 하기 때문이다.

핵심 요약

  • Node.js 22.15 이상 기반 검증 흐름 자동화 프로젝트로, 웹 워크스테이션·작업 큐·브라우저 양식 상호작용·HTTP 상태 조회를 제공한다.
  • 로컬 웹 인터페이스(127.0.0.1:8787)에서 검증 링크, 이름, 성, 생년월일, 프록시를 입력해 작업을 생성·대기열·중지·복구·삭제할 수 있다.
  • 브라우저 자동 채우기(Camoufox 사용)와 문서 업로드 흐름을 분리하며, 자동 제출 후 기본 5초마다 상태를 폴링해 결과를 추적한다.
  • 원본 PNG·JPEG·PDF만 전송하고 문서를 생성·수정하지 않으며, 대화형 사람 인증은 사용자가 브라우저에서 직접 완료해야 한다.
  • 웹 API 세션에서 이메일은 설정의 도메인 후위사 규칙으로 자동 생성되며, 동시성 제한·작업 진행률 로깅·액세스 암호·쿠키·출처 확인·쓰기 토큰으로 보호된다.
  • CLI 모드는 로컬 설정 파일 또는 `--file`·`--url`로 문서 경로를 지정하며, HTTP·SOCKS5 프록시(계정 인증 포함) 및 시스템 프록시 호환을 제공한다.
  • 학교 선택 시 이름 매칭·중국어 지원·비동기 갱신 처리·최대 120초(설정 가능) 대기·자동 재시도(최대 1회 문자 삭제)를 실행한다.
  • 브라우저 시작 시 Camoufox 자체 uBlock Origin을 제외하고, 참가자 검증 재시도는 최대 3회(각 5초 간격)로 제한하며 누적 180초 예산이다.
  • 문서 단계의 상태 변환에서 SSO 취소 또는 직접 업로드를 수행하고, PUT 요청 전에 HTTPS S3·SheerID 주소 검증을 필수화하며, 파일 크기는 20 MiB 상한이다.
  • 공개 배포 시 ONE_WEB_PASSWORD로 기본 암호 변경·ONE_WEB_PUBLIC_ORIGIN 설정·systemd 서비스 지원(`.env.web` 권한 600)을 지원한다.
  • 작업 큐는 메모리에만 보존되며 서비스 재시작 시 소실되고, 실행 로그는 `.runs/.json`에 저장(문서 바이트·파일 경로·사전 서명 URL·전체 응답 제외)된다.
  • 교육·연구 목적 명시, SheerID 공식 관계 부정, 신분 위조·학적 거짓·권리 편취·자격 우회 금지 등 면책 조항 및 ISC 라이선스를 문서에 기재했다.
AI 요약 안내

AI가 한국어로 정리한 내용입니다. 정확한 정보는 원문을 확인해 주세요.

요약 원칙 ↗