🔑 Basic 인증 헤더 만들기·풀기
아이디와 비밀번호를 넣으면 Authorization: Basic 헤더를 만들어 주고, 받은 헤더는 풀어서 아이디·비밀번호로 보여 줘요. curl·fetch 예시 코드도 같이 나와요.
작업
아이디
비밀번호
받은 헤더 (Basic … 또는 Base64 부분만)
사용법
- 만들기를 고르고 아이디와 비밀번호를 넣어요. 헤더 한 줄과 Base64 부분이 바로 나와요.
- 결과의
Authorization: Basic …줄을 copy 해서 API 도구(Postman, Insomnia 등)의 헤더 칸에 붙여넣어요. 아래 curl·fetch 코드를 그대로 써도 돼요. - 받은 헤더를 확인하고 싶으면 풀기를 골라
Basic …줄(또는 Base64 부분만)을 붙여넣으세요. 아이디와 비밀번호로 나눠 보여 줘요.
만드는 규칙 한눈에 보기
| 순서 | 하는 일 | 예: admin / secret |
|---|---|---|
| 1 | 아이디와 비밀번호를 콜론으로 잇기 | admin:secret |
| 2 | UTF-8 바이트로 바꾸기 | 13바이트 |
| 3 | Base64 로 인코딩 | YWRtaW46c2VjcmV0 |
| 4 | 앞에 Basic 붙이기 | Basic YWRtaW46c2VjcmV0 |
직접 돌려 본 예시
| 아이디 | 비밀번호 | Base64 부분 |
|---|---|---|
| admin | secret | YWRtaW46c2VjcmV0 |
| user | pass123 | dXNlcjpwYXNzMTIz |
| api | a:b | YXBpOmE6Yg== (비밀번호의 콜론은 허용) |
세 번째 줄처럼 원본이 api:a:b 한 덩어리라서, 서버는 첫 콜론에서 잘라 아이디 api, 비밀번호 a:b로 읽어요. 아이디 쪽에 콜론이 있으면 잘리는 위치가 달라져서 로그인이 안 돼요.
길이는 얼마나 늘어나나요
Base64 는 3바이트를 4글자로 바꾸므로 약 33% 커지고, 3의 배수가 아니면 끝에 = 패딩이 붙어요. 한글은 UTF-8 에서 글자당 3바이트라 한글 비밀번호는 같은 글자 수의 영문보다 헤더가 길어져요. 헤더 크기 제한이 있는 프록시·서버를 쓸 땐 이 점도 염두에 두세요.
흔한 실수
- 'Basic' 뒤 공백 누락 —
BasicYWRt…처럼 붙이면 서버가 인증 방식을 못 알아봐요. 공백 한 칸이 필요해요. - Base64 에 줄바꿈이 섞임 — 터미널에서
base64명령으로 만든 값을 복사하면 끝에 줄바꿈이 붙어 있을 수 있어요. 헤더 값에는 줄바꿈이 없어야 해요. - URL 에 아이디:비밀번호@ 형태로 넣음 — 브라우저와 도구마다 처리가 달라서, API 호출에는 헤더 방식이 정확해요.
- 토큰 방식과 혼동 —
Bearer토큰은 Base64 로 감싸지 않고 그대로 보내요. 인증 방식이 다르니 서버 문서를 먼저 확인하세요. 토큰 내용이 궁금하면 JWT 디코더를 쓰세요.
이럴 때 쓰세요
- 개발·테스트 서버 호출 — 테스트 계정으로 API 를 시험할 때 헤더 한 줄을 빠르게 만들어요.
- 받은 헤더 점검 — 로그나 문서 예시의
Basic …값이 어떤 아이디인지 확인해요(테스트용 값만 붙여넣으세요). - 직접 Base64 확인 — 일반 문자열을 인코딩·디코딩하려면 Base64 인코더·디코더가 더 범용이에요.
모든 처리는 브라우저 안에서만 이뤄지고 입력한 값은 서버로 전송되지 않아요. 그래도 운영 환경의 실제 비밀번호는 입력하지 마세요. Basic 인증은 암호화가 아니라 인코딩이에요.
자주 묻는 질문
Basic 인증 헤더는 어떻게 만들어지나요?
'아이디:비밀번호'를 콜론으로 이어 붙인 문자열을 UTF-8 바이트로 바꾼 뒤 Base64로 인코딩하고, 앞에 'Basic '(뒤 공백 한 칸)을 붙여요. 예를 들어 admin:secret 은 YWRtaW46c2VjcmV0 이 되어 헤더는 'Authorization: Basic YWRtaW46c2VjcmV0' 이에요.
Basic 인증은 암호화인가요?
아니요. Base64는 바이트를 글자로 옮기는 인코딩이라 누구나 되돌릴 수 있어요. 그래서 Basic 인증은 반드시 HTTPS 위에서만 쓰고, 로그·화면 캡처·공유 링크에 헤더가 남지 않게 조심해야 해요.
아이디에 콜론(:)이 들어가도 되나요?
안 돼요. 규격(RFC 7617)상 아이디에는 콜론을 쓸 수 없어요. 서버가 첫 번째 콜론을 기준으로 아이디와 비밀번호를 나누기 때문이에요. 반대로 비밀번호에는 콜론이 들어가도 괜찮아요.
한글 아이디나 비밀번호도 되나요?
이 도구는 UTF-8 로 인코딩해요. 서버가 UTF-8 이 아닌 문자셋(예: ISO-8859-1)로 해석하면 한글이 깨질 수 있으니, 서버 문서에서 문자셋을 확인하세요. 안전하게는 영문·숫자 위주 비밀번호나 API 토큰을 쓰는 쪽이 문제가 적어요.
받은 헤더를 풀면 비밀번호가 그대로 보이나요?
네, 풀기 모드에서는 Base64 를 되돌려 아이디와 비밀번호를 그대로 보여 줘요. 그래서 실제 운영 계정의 헤더는 이 도구뿐 아니라 어디에도 붙여넣지 않는 게 좋아요. 처리는 브라우저 안에서만 이뤄지지만, 화면에 남는 건 그대로예요.
'401 Unauthorized'가 계속 나와요. 무엇을 확인하나요?
순서대로 보세요. ① 'Basic ' 뒤에 공백이 한 칸 있는지 ② 콜론이 아이디와 비밀번호 사이에 하나 있는지 ③ 줄바꿈이나 앞뒤 공백이 Base64 에 섞이지 않았는지 ④ 서버가 기대하는 인증 방식이 Basic 이 맞는지(Bearer 토큰이 아닌지)예요.