파이썬 Selenium 쿠키 조작 방법 get_cookies add_cookie delete_cookie 활용과 보안 주의사항

🔎 Selenium에서 쿠키란 무엇일까?

웹 브라우저에서 쿠키(Cookie)는 사용자의 세션을 유지하거나 로그인 상태를 확인하기 위해 필수적으로 활용되는 작은 데이터 조각입니다.
예를 들어 온라인 쇼핑몰에 로그인했을 때, 페이지를 새로고침하거나 다른 상품 페이지로 이동해도 로그인이 유지되는 이유가 바로 쿠키 덕분입니다.
Selenium은 이러한 쿠키를 코드로 직접 제어할 수 있게 하여, 자동화된 브라우저 테스트나 웹 크롤링 과정에서 유용하게 활용할 수 있습니다.

쿠키에는 도메인, 이름, 값, 만료 시점, 보안 플래그 등 다양한 속성이 포함됩니다.
이를 잘 이해하고 있어야만 올바르게 쿠키를 추가하거나 삭제할 수 있으며, 불필요한 인증 오류를 방지할 수 있습니다.
만약 쿠키를 무분별하게 다룬다면 정상적인 세션이 끊기거나 서버에서 비정상 접근으로 판단해 차단당할 수도 있죠.

💡 Selenium에서 쿠키 활용이 중요한 이유

1. 자동 로그인 유지 – 테스트 환경에서 매번 아이디와 비밀번호를 입력할 필요 없이, 저장된 세션 쿠키를 불러와 로그인 상태를 유지할 수 있습니다.

2. 사용자 맞춤 데이터 검증 – 쿠키 값에 따라 노출되는 UI나 데이터를 확인할 수 있어 QA 테스트에 필수적입니다.

3. 보안 테스트 – HTTPS 전용 쿠키, HttpOnly 플래그 등 보안 속성을 확인하여 사이트의 취약점을 점검하는 데 활용됩니다.

• 🔑세션 쿠키와 영구 쿠키의 차이를 구분하기
• 🌐쿠키는 반드시 같은 도메인에서만 유효하다는 점 기억하기
• 🛡️HttpOnly, Secure 속성의 의미와 활용 이해하기

📥 get_cookies로 쿠키 조회하기

Selenium에서 가장 기본적인 쿠키 관련 기능은 get_cookies()입니다.
이 메서드는 현재 브라우저 세션에 저장된 모든 쿠키를 리스트 형태로 반환합니다.
리턴 값은 각 쿠키의 이름, 값, 도메인, 만료일자 등 세부 속성을 포함하는 딕셔너리 구조입니다.
이를 통해 현재 로그인 상태를 확인하거나 인증에 필요한 정보를 추출할 수 있습니다.

예를 들어, 로그인 직후 get_cookies()를 호출하면 세션 유지에 사용되는 토큰 값을 확인할 수 있습니다.
이를 별도로 저장해두면 브라우저를 재시작하거나 다른 환경에서 동일한 로그인 상태를 재현할 수도 있습니다.
다만 이런 민감 정보는 외부에 유출되지 않도록 각별히 주의해야 합니다.

🧾 기본 사용 예제

from selenium import webdriver

driver = webdriver.Chrome()
driver.get("https://example.com")

# 현재 브라우저에 저장된 모든 쿠키 가져오기
cookies = driver.get_cookies()
for cookie in cookies:
    print(cookie)

출력되는 값은 딕셔너리의 리스트로 제공되며, 예를 들어 다음과 같은 구조를 가집니다.

➕ add_cookie로 새로운 쿠키 추가하기

Selenium은 add_cookie() 메서드를 통해 새로운 쿠키를 브라우저에 삽입할 수 있습니다.
이 기능은 특정 세션을 미리 설정하거나, 로그인 과정을 생략하기 위해 자주 활용됩니다.
예를 들어, 개발 환경에서 테스트 계정의 세션 쿠키를 바로 삽입해 로그인 상태를 재현할 수 있습니다.

단, Selenium에서 쿠키를 추가하려면 반드시 현재 페이지의 도메인이 해당 쿠키의 도메인과 일치해야 합니다.
예를 들어 example.com 도메인에서만 유효한 쿠키는 example.com 페이지에 접속한 상태에서 추가해야 정상적으로 동작합니다.

🧾 기본 사용 예제

from selenium import webdriver

driver = webdriver.Chrome()
driver.get("https://example.com")

# 새로운 쿠키 추가
cookie = {
    "name": "session_id",
    "value": "123456789",
    "domain": "example.com"
}
driver.add_cookie(cookie)

# 추가된 쿠키 확인
print(driver.get_cookies())

이처럼 add_cookie()는 딕셔너리 형태의 인자를 받아 쿠키를 브라우저에 삽입합니다.
여러 개의 쿠키를 한 번에 넣으려면 반복문을 활용해 순차적으로 추가할 수 있습니다.

💡 활용 포인트

• 🚀로그인 절차를 반복하지 않고 세션 복원 가능
• 🔄테스트 환경에서 여러 사용자 계정 쿠키를 전환하며 검증 가능
• 🛡️보안 속성이 포함된 쿠키는 브라우저 정책에 따라 삽입이 제한될 수 있음

🗑️ delete_cookie로 쿠키 삭제하기

자동화 과정에서 불필요하거나 문제가 되는 쿠키를 제거해야 할 때는 delete_cookie() 또는 delete_all_cookies() 메서드를 활용할 수 있습니다.
특정 이름의 쿠키만 지울 수도 있고, 브라우저에 저장된 모든 쿠키를 한 번에 초기화할 수도 있습니다.

예를 들어 로그인 후 잘못된 세션이 유지되는 경우, delete_cookie로 해당 세션 쿠키만 삭제하고 다시 로그인 절차를 진행하면 문제를 해결할 수 있습니다.
또는 테스트 환경에서 여러 계정을 순차적으로 검증해야 한다면 delete_all_cookies()를 활용해 매번 새로운 환경을 재현할 수 있습니다.

🧾 기본 사용 예제

from selenium import webdriver

driver = webdriver.Chrome()
driver.get("https://example.com")

# 특정 쿠키 삭제
driver.delete_cookie("session_id")

# 모든 쿠키 삭제
driver.delete_all_cookies()

위 코드에서 delete_cookie(“session_id”)는 이름이 session_id인 쿠키만 삭제합니다.
반대로 delete_all_cookies()는 현재 브라우저 세션의 모든 쿠키를 제거하므로, 로그인 상태나 개인화된 환경이 모두 초기화됩니다.

💡 활용 포인트

• ♻️여러 계정 테스트 시 쿠키 초기화로 깔끔한 환경 유지
• 🧹세션 충돌 방지를 위해 로그인 전 불필요한 쿠키 제거
• 🔒보안 이슈 예방을 위해 자동화 종료 시 모든 쿠키 삭제

⚠️ 쿠키 조작 시 반드시 지켜야 할 보안 주의사항

Selenium에서 쿠키를 다루는 것은 매우 편리하지만, 잘못 활용하면 심각한 보안 문제를 초래할 수 있습니다.
특히 세션 쿠키에는 사용자의 로그인 정보가 포함될 수 있으므로 관리 부주의는 곧 계정 탈취나 개인정보 유출로 이어질 수 있습니다.
따라서 쿠키 조작을 사용할 때는 항상 보안 원칙을 우선해야 합니다.

예를 들어, get_cookies()로 가져온 정보를 로그 파일에 그대로 저장하거나 협업 과정에서 공유하는 것은 매우 위험합니다.
또한 add_cookie()를 통해 삽입한 쿠키가 제3자에게 유출된다면, 해당 사용자의 세션이 무단으로 재현될 수 있습니다.
delete_cookie() 역시 보안적인 목적에서 자주 활용되는데, 자동화가 끝난 후 민감한 세션 정보를 정리하는 것이 권장됩니다.

🔒 안전한 쿠키 관리 원칙

• 🛡️쿠키 정보는 암호화된 저장소에만 보관
• 🚫협업 시 세션 쿠키 직접 공유 금지
• ✅테스트 종료 후 반드시 delete_all_cookies() 실행
• 🌐도메인 불일치 쿠키는 추가하지 않기
• 🔍항상 HttpOnly, Secure 속성 확인

💬 특히 공용 환경에서 테스트를 진행할 때는, 모든 쿠키를 남김없이 삭제한 뒤 브라우저를 종료하는 습관을 가져야 안전합니다.

❓ 자주 묻는 질문 (FAQ)