교육 기관 전용 이메일 계정은 다양한 학생 혜택을 누릴 수 있는 통행증 역할을 한다. 수동으로 신청하려면 복잡한 절차와 긴 대기 시간이 필요하지만, 자동화 스크립트를 활용하면 이 과정을 극적으로 단축할 수 있다. 본 문서에서는 Python 기반 오픈소스 솔루션을 활용해 OpenCCC(캘리포니아 커뮤니티 칼리지 시스템) 가입 절차를 자동화하는 방법을 상세히 다룬다.

도구 개요 및 원리

해당 프로젝트는 Selenium WebDriver를 기반으로 한 헤드리스 브라우저 자동화 도구로, 웹 폼의 자동 기입, 캡차 우회, 봇 탐지 메커니즘 회피 등의 기능을 포함한다. 핵심 아키텍처는 다음과 같이 구성된다.

• 엔진 모듈(engine.py): 브라우저 인스턴스 초기화 및 탐색 흐름 제어
• 인증 들러(auth_handler.py): 세션 토큰 및 쿠키 기반 인증 상태 관리
• 설정 상수(settings.py): 선택자(Selector), URL, 대기 시간 등 정적 값 집합
• 드라이버 유틸리티(driver_utils.py): ChromeDriver/GeckoDriver 버전 자동 매칭

필요 환경

설치 및 실행

저장소를 로컬 머신으로 가져온 후 의존성을 설치한다.

git clone https://gitcode.com/gh_mirrors/ed/Edu-Mail-Generator
cd Edu-Mail-Generator
pip install -r requirements.txt

브라우저 드라이버가 자동으로 다운로드되지 않는 경우, driver_utils.py를 실행해 수동으로 매칭할 수 있다.

python driver_utils.py --browser=chrome

핵심 로직 분석

자동화의 핵심은 실제 사용자 행동을 시뮬레이션하는 것이다. 다음은 랜덤 지연과 동작 패턴을 삽입한 대표적인 예시다.

import time
import random
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

class EduMailAutomator:
    def __init__(self):
        opts = webdriver.ChromeOptions()
        opts.add_argument("--disable-blink-features=AutomationControlled")
        opts.add_experimental_option("excludeSwitches", ["enable-automation"])
        self.driver = webdriver.Chrome(options=opts)
        self.wait = WebDriverWait(self.driver, 15)
    
    def human_like_delay(self, base=1.0, variance=0.8):
        """자연스러운 입력 간격 시뮬레이션"""
        sleep_time = base + random.uniform(0, variance)
        time.sleep(sleep_time)
    
    def fill_personal_info(self, profile):
        """개인정보 섹션 자동 기입"""
        field_map = {
            'fname': profile['given_name'],
            'lname': profile['family_name'],
            'dob': profile['birth_date'],
            'ssn': profile['tax_id']
        }
        
        for element_id, value in field_map.items():
            field = self.wait.until(
                EC.element_to_be_clickable((By.ID, element_id))
            )
            field.clear()
            self.human_like_delay(0.3, 0.5)
            
            # 문자별 타이핑 시뮬레이션
            for char in str(value):
                field.send_keys(char)
                time.sleep(random.uniform(0.05, 0.15))
            
            self.human_like_delay()
    
    def bypass_incapsula(self):
        """Incapsula WAF 탐지 회피"""
        self.driver.execute_script("""
            Object.defineProperty(navigator, 'webdriver', {
                get: () => undefined
            });
        """)
        self.human_like_delay(2.0, 1.5)

프로필 데이터 구성

가입에 필요한 가상 신원 정보는 JSON 형태로 분리 관리하는 것이 바람직하다.

{
  "applicant": {
    "given_name": "Alex",
    "family_name": "Morgan",
    "birth_date": "2002-05-17",
    "residence": {
      "street": "742 Evergreen Terrace",
      "municipality": "Springfield",
      "province": "CA",
      "postal": "90210"
    },
    "credentials": {
      "username_prefix": "amorgan",
      "password_phrase": "SecureP@ss!2024"
    }
  }
}

실행 흐름

메인 진입점에서 전체 워크플로우를 조율한다.

if __name__ == "__main__":
    bot = EduMailAutomator()
    
    try:
        bot.navigate_to_portal()
        bot.bypass_incapsula()
        bot.fill_personal_info(load_profile())
        bot.submit_application()
        bot.handle_email_verification()
        
        account = bot.retrieve_credentials()
        print(f"생성 완료: {account['edu_address']}")
        
    except Exception as err:
        bot.capture_diagnostic_screenshot()
        raise
    finally:
        bot.driver.quit()

탐지 회피 고급 기법

현대 웹 보안 솔루션은 다양한指標로 자동화를 식별한다. 다음 기법들을 조합해 탐지율을 낮출 수 있다.

주의사항 및 윤리적 고려사항

• 본 도구는 교육 목적의 기술 연구를 전제로 하며, 실제 운영 환경 적용 시 해당 기관의 이용약관을 반드시 확인해야 한다
• 자동화된 대량 생성은 IP 기반 차단과 법적 책임을 초래할 수 있다
• 생성된 계정은 학술 리소스 접근 외의 상업적 목적으로 사용해서는 안 된다

문제 해결

WebDriver 버전 불일치

# Chrome 버전 확인
google-chrome --version

# 대응 드라이버 수동 설치
wget https://chromedriver.storage.googleapis.com/LATEST_RELEASE

reCAPTCHA v2 차단

무인 솔루션은倫理적으로 문제가 있으므로, 개발 단계에서는 공식 데모 페이지에서 수동 해결 패턴을 학습하는 것을 권장한다.