Netscape 쿠키 JSON 변환과 X 쿠키 가져오기

cookies.txt 파일은 있는데, 쓰려는 확장 프로그램이나 자동화 도구가 JSON 쿠키 배열만 받는 경우가 있습니다. 파일의 각 열이 무엇을 뜻하는지 알면 Netscape 쿠키를 JSON으로 변환하는 일은 간단하고, 읽지 못한 줄을 정확히 알려 주는 변환기를 쓰면 몇 초면 끝납니다.

이 가이드는 Netscape 쿠키 파일 형식을 설명하고, JSON 쪽은 어떤 모양인지 보여 주며, 무료 변환 도구를 단계별로 안내합니다. 이어서 결과를 쿠키 편집기에 가져오고 X 세션이 실제로 작동하는지 확인하는 방법도 다룹니다. 실패의 대부분을 일으키는 붙여넣기 실수 몇 가지와, 도구가 JSON 대신 Base64를 요구할 때의 대처법도 알게 됩니다.

Netscape 쿠키를 JSON으로: 탭으로 구분된 7개 열

Netscape 쿠키 파일은 한 줄에 쿠키 하나를 적은 일반 텍스트입니다. 각 줄에는 탭 문자 하나로 구분된 필드 7개가 항상 같은 순서로 들어 있습니다. curl, wget, 그리고 대부분의 브라우저 쿠키 내보내기 확장 프로그램이 이 형식으로 파일을 씁니다.

• 도메인(Domain): 쿠키가 적용되는 곳입니다(예: .x.com). 맨 앞의 점은 서브도메인을 포함한다는 뜻입니다.
• 서브도메인 플래그: TRUE 또는 FALSE로, 서브도메인도 쿠키를 받을 수 있는지 나타냅니다.
• 경로(Path): 보통 슬래시 하나이며 사이트 전체를 뜻합니다.
• Secure: 쿠키가 HTTPS로만 전송되면 TRUE입니다.
• 만료 시각: 초 단위 Unix 타임스탬프입니다. 0은 브라우저를 닫으면 끝나는 세션 쿠키를 뜻합니다.
• 이름: auth_token이나 ct0 같은 쿠키 이름입니다.
• 값: 쿠키의 값 자체이며, 비밀로 해야 하는 부분입니다.

자주 나오는 특수한 경우가 두 가지 있습니다. 해시 기호로 시작하는 줄은 주석이라 무시되지만, 예외가 하나 있습니다. #HttpOnly_ 접두사로 시작하는 줄은 실제 쿠키이며, 도메인은 접두사 뒤에 오고 HTTP-only로 표시됩니다. 또 일부 내보내기 도구는 마지막 값을 비워 두기 때문에 필드가 6개인 행도 가능하며 여전히 유효합니다.

확장 프로그램이 기대하는 JSON 쿠키 형식

JSON 쿠키 가져오기는 보통 쿠키 하나당 객체 하나로 이루어진 배열이고, 필드마다 키가 있습니다. 이 사이트의 무료 변환기는 domain, includeSubdomains, path, secure, expires, name, value, httpOnly라는 키를 만듭니다. 7개 열을 그대로 반영하고, 여기에 HTTP-only 접두사용 플래그가 더해진 형태입니다.

확장 프로그램이 완전히 똑같지는 않다는 점에 유의하세요. 브라우저 확장 프로그램 API는 만료 필드를 expires 대신 expirationDate라고 부르는 경우가 많고, hostOnly나 sameSite 같은 키를 추가하는 곳도 있습니다. 많은 양을 옮기기 전에, 가져올 확장 프로그램에서 쿠키 하나를 내보내 그 키 이름을 변환기 출력과 비교해 보세요. 이름이 다르면 키 이름을 찾아 바꾸는 것만으로 대개 해결됩니다.

무료 도구로 cookies.txt를 JSON으로 변환하기

가장 빠른 방법은 Netscape 쿠키를 JSON으로 바꾸는 도구입니다. 브라우저 안에서 실행되므로 붙여넣은 텍스트가 서버로 전송되거나 저장되지 않습니다. 그래도 쿠키 값은 유효한 세션 인증 정보이므로 내용은 비밀번호처럼 다루세요.

• 주석 줄을 포함해 cookies.txt 전체를 붙여넣습니다. 미리 정리할 필요는 없습니다.
• 카운터 세 개를 확인합니다: 유효한 쿠키, 잘못된 줄, 건너뛴 줄. 건너뛴 줄은 주석과 빈 행이며 정상입니다.
• 잘못된 줄이 나오면 읽지 못한 줄 목록을 엽니다. 각 항목에 줄 번호와 이유가 표시됩니다.
• 유효한 쿠키 수가 예상과 맞으면 JSON 목록을 복사합니다.

받은 파일의 종류가 확실하지 않다면 먼저 몇 줄을 형식 식별 도구에 붙여넣어 보세요. 콜론으로 구분된 계정 줄이 있는 납품 파일은 탭으로 구분된 쿠키 파일과 다릅니다. 둘을 구별하는 방법은 형식 도구를 쓰기 전에 납품 파일 구조 확인하기 가이드에서 설명합니다.

JSON을 쿠키 편집기로 가져오고 세션 확인하기

JSON이 준비되면 이 작업에 쓰는 브라우저 프로필의 쿠키 편집기 확장 프로그램으로 가져옵니다.

• 먼저 그 프로필에서 x.com을 열어, 확장 프로그램이 쿠키를 연결할 페이지와 도메인을 갖게 합니다.
• 확장 프로그램의 가져오기 옵션을 열고 JSON 배열을 붙여넣습니다.
• 페이지를 새로 고치고 로그인 화면 대신 로그인된 홈 타임라인이 보이는지 확인합니다.

X 로그인에서 가장 중요한 쿠키는 세션을 담고 있는 auth_token과, 사이트가 요청에 쓰는 짝 토큰인 ct0입니다. 도메인이 .x.com(내보낸 파일이 예전 방식이면 .twitter.com)인지, 경로가 슬래시인지, 만료 시각이 미래 날짜인지 확인하세요. 다른 것은 다 완벽한데 가져오기가 실패하는 가장 흔한 이유는 만료된 타임스탬프입니다. 토큰 기반 로그인의 전체 그림은 auth token으로 Twitter에 로그인하는 방법을 읽어 보세요.

자주 나오는 변환 오류: 탭, #HttpOnly_ 줄, 주석

실패의 대부분은 몇 가지 실수에서 비롯되며, 변환기의 오류 목록이 바로 그 원인을 가리킵니다.

• 탭이 공백으로 바뀜: 채팅 창, 워드 프로세서, 일부 웹페이지에서 복사하면 탭 문자가 공백으로 바뀔 수 있습니다. 그러면 도구는 필드 7개 대신 긴 필드 하나로 인식합니다. 일반 텍스트 편집기에서 원본 파일을 직접 복사하세요.
• 필드 수가 맞지 않음: 모든 행은 필드가 6개 또는 7개여야 합니다. 값 안에 공백이 더 들어가 있거나 열이 빠진 행은 줄 번호와 함께 보고됩니다.
• 도메인이나 이름이 비어 있음: 도메인이나 쿠키 이름이 빈 행은 쓸 수 없으므로, 도구가 추측하지 않고 목록에 표시합니다.
• 만료 값이 숫자가 아님: 다섯 번째 필드는 숫자여야 합니다. 텍스트로 쓴 날짜나 엉뚱한 문자가 있으면 거부됩니다.
• 주석과의 혼동: 해시 기호로 시작하는 줄은 건너뛰지만 #HttpOnly_ 줄은 실제 쿠키입니다. 개수가 예상보다 적다면 앞선 정리 단계에서 지워지지 않았는지 확인하세요.

원본을 고친 뒤 다시 붙여넣고, 유효한 쿠키 수를 예상한 개수와 비교하세요. 읽지 못한 줄을 모두 알려 주는 변환기가 조용히 버리는 변환기보다 낫습니다.

도구가 요구하면 Base64로 추가 변환하기

일부 패널이나 가져오기 양식은 읽기 쉬운 JSON 대신 쿠키 배열을 하나의 Base64 문자열로 요구합니다. JSON을 JSON을 Base64로 바꾸는 도구에 붙여넣고, 대상이 들여쓰기를 요구하지 않는 한 한 줄로 압축한 출력을 선택하세요. 기존 Base64 문자열을 확인하거나 디버그하려면, 반대 방향은 Base64 쿠키 데이터를 JSON으로 디코딩하기에서 다룹니다.

원본 cookies.txt는 기준 자료로 보관하세요. JSON과 Base64 버전은 언제든 그 파일에서 다시 만들 수 있습니다. 작업 흐름에 계정을 추가할 준비가 되면 에이징 계정 카테고리를 둘러본 뒤, 위의 무료 도구로 사용하는 도구에 필요한 형식을 준비하세요.

자주 묻는 질문

Netscape와 JSON 쿠키 형식은 무엇이 다른가요?

Netscape 파일은 한 줄에 탭으로 구분된 열 7개가 있는 일반 텍스트입니다. JSON은 각 쿠키가 이름 붙은 키를 가진 객체인 구조화된 배열입니다. 둘은 같은 정보를 담고 있으므로 변환해도 바뀌는 것은 배치일 뿐 쿠키 데이터가 아닙니다.

붙여넣은 cookies.txt에서 쿠키가 0개로 나오는 이유는 무엇인가요?

대개 복사하는 과정에서 탭이 공백으로 바뀌어 모든 줄의 필드 수가 맞지 않게 된 경우입니다. 일반 텍스트 편집기에서 원본 파일을 직접 복사해 다시 붙여넣으세요. 주석이나 빈 줄만 있는 파일도 쿠키가 0개로 나옵니다.

#HttpOnly_로 시작하는 줄은 주석인가요, 실제 쿠키인가요?

실제 쿠키입니다. 접두사는 HTTP-only라는 표시일 뿐이며, 도메인은 그 바로 뒤에서 시작합니다. 해시 기호로 시작하는 일반 줄은 주석이며 건너뜁니다.

X 로그인에서 가장 중요한 쿠키 필드는 무엇인가요?

auth_token과 ct0의 이름과 값이 가장 중요하고, .x.com 같은 올바른 도메인, 슬래시 경로, 아직 지나지 않은 만료 날짜가 함께 필요합니다. 이 항목들이 맞으면 서브도메인 플래그 같은 필드는 문제를 일으키는 일이 드뭅니다.

나중에 JSON을 다시 Netscape나 Base64로 변환할 수 있나요?

Base64는 JSON을 Base64로 도구와 Base64를 JSON으로 도구로 양방향 변환이 가능합니다. 이 사이트에는 JSON을 Netscape로 바꾸는 변환기가 없으므로, 그 형식이 다시 필요할 수 있다면 원본 cookies.txt를 보관하세요.