소셜 로그인 직접 설정하기 ③ 네이버
바이브코딩으로 만든 BackendX 앱에 네이버 로그인을 직접 연결하는 방법. 네이버 개발자 센터 앱 등록, PC 웹·Callback URL, 테스터 ID, 자주 나는 오류까지 화면과 함께 정리했어요.
바이브코딩으로 BackendX에서 앱을 만들고 있다면, 로그인은 기본으로 들어가는 BackendX 로그인으로 충분한 경우가 많아요. 그래도 소셜 로그인을 내 앱에 직접 연결해야 하는 바이브코더를 위해, 그 방법을 제공자별로 정리하는 「소셜 로그인 직접 설정하기」 시리즈예요. 이번 편에서는 네이버에 내 앱을 등록하고, 그 값을 BackendX 앱에 넣는 방법을 화면과 함께 따라가 볼게요.
🤔 먼저, 이 설정이 정말 필요한가요?
BackendX로 만든 앱의 로그인은 기본으로 BackendX 로그인(Sign in with BackendX)을 써요. 따로 고르지 않아도 기본으로 들어가고, 제공자 콘솔에 들어갈 필요도, 키를 관리할 필요도 없어요. 대부분의 앱은 이 글의 설정이 필요 없어요.
아래 두 경우에만 네이버에 내 앱을 직접 등록하면 돼요.
- 백엔드엑스 채팅창에서 네이버 로그인을 BackendX 로그인을 거치지 않고 직접 연결해 달라고 요청한 경우
- BackendX 로그인에서 제공하지 않는 로그인 방식이 필요해서 네이버로 직접 연결하기로 한 경우
어느 쪽인지 헷갈린다면, 앱의 API 문서나 BackendX가 알려 주는 환경 변수 목록을 확인해 보세요. NAVER_CLIENT_ID 같은 값을 넣으라는 안내가 있다면 이 글이 필요한 경우예요.
📝 시작하기 전에: 내 앱의 "주소"를 정해 두세요
제공자 콘솔에는 로그인이 일어나는 웹 주소를 등록해야 해요. 주소는 앱을 어디서 실행하느냐에 따라 달라요. 가장 간편한 방법은 백엔드엑스를 통해서 배포하는 거예요.
- 백엔드엑스를 통해서 배포할 때 (BackendX 관리형 클라우드):
https://<프로젝트 ID>.app.pool1.backendx.cloud
<프로젝트 ID>는 BackendX 대시보드에서 프로젝트를 열었을 때 주소창에 보이는 긴 ID(예:4e51bf17-cc28-…, 36자리)예요. 이 주소는 프로젝트를 다시 배포해도 바뀌지 않아요. - 내 컴퓨터에서 실행할 때 (내려받은
docker-compose.yaml로docker compose up):http://localhost:8080
8080 포트를 이미 다른 프로그램이 쓰고 있다면,docker-compose.yaml옆에.env파일을 만들고BX_FRONTEND_PORT=5175처럼 다른 포트를 적으면 돼요. 그때는 주소도http://localhost:5175가 돼요.
⚠️ 이때 주소는 꼭http://localhost:포트를 쓰세요. docker compose가 함께 띄우는http://frontend.localhost주소는 제공자가 받아 주지 않을 수 있어요. - 내 서버에 직접 배포할 때: 내 도메인 주소 (예:
https://myapp.example.com)
내 컴퓨터에서도 시험하고 배포도 할 거라면, 두 주소를 모두 등록해 두면 편해요. 배포한 앱 주소는 꼭 https://로 등록하고, IP 주소나 http:// 주소는 쓰지 마세요.
네이버 개발자 센터에서 설정하기
네이버 개발자 센터에 로그인한 뒤 상단의 Application → 애플리케이션 등록으로 들어가요.
① 애플리케이션 등록: 이름과 사용 API
- 애플리케이션 이름: 네이버 로그인 동의 화면에 그대로 보이는 이름이에요.
- 사용 API:
네이버 로그인을 골라요. - 제공 정보 선택: 아무것도 고르지 않아도 돼요. 로그인에는 네이버가 기본으로 주는 이용자 식별자만 쓰기 때문이에요. 닉네임 같은 정보는 앱의 프로필 화면에서 직접 받아요.

SENDGRID_API_KEY)를 함께 물어봐요.② 서비스 환경: PC 웹과 Callback URL
로그인 오픈 API 서비스 환경에서 환경 추가 → PC 웹을 골라요. (Windows App, Android 같은 다른 환경이 아니에요.)
- 서비스 URL: 앞에서 정한 앱 주소 (예:
https://<프로젝트 ID>.app.pool1.backendx.cloud, 내 컴퓨터에서는http://localhost:8080) - 네이버 로그인 Callback URL:
앱 주소 + /login(예:https://<프로젝트 ID>.app.pool1.backendx.cloud/login, 내 컴퓨터에서는http://localhost:8080/login)
약관 동의에 체크하고 등록하기를 눌러요.

③ Client ID와 Client Secret
등록이 끝나면 내 애플리케이션 → 개요에 Client ID와 Client Secret이 보여요. Client Secret은 보기를 눌러 확인해요.

④ 개발 중에는 등록된 아이디만 로그인할 수 있어요
새로 만든 애플리케이션은 개발 중 상태예요. 이때는 관리자 아이디와 멤버관리 → 테스터 ID 등록에 넣은 아이디(최대 20개)만 네이버 로그인을 할 수 있어요. 다른 아이디로 로그인하면 "입력하신 아이디로 로그인할 수 없습니다"가 떠요.

모든 사용자에게 열려면 네이버 로그인 검수상태 탭에서 검수를 요청해요. 검수를 통과하면 아이디 제한이 없어져요.
BackendX 앱에 값 넣기
| 환경 변수 | 어디서 복사하나요 |
|---|---|
NAVER_CLIENT_ID | 내 애플리케이션 → 개요 → Client ID |
NAVER_CLIENT_SECRET | 내 애플리케이션 → 개요 → Client Secret (보기) |
- 백엔드엑스를 통해서 배포할 때: 배포 단계에서 BackendX가 필요한 값을 물어봐요. 같은 이름의 칸에 넣으면 돼요. 값이 비어 있으면 배포 전에 알려 줘요.
- 내 컴퓨터에서 실행할 때: 프로젝트에서 내려받은 압축 파일의
env.txt에서 해당 줄을 찾아=뒤에 값을 붙여 넣고docker compose up -d를 실행해요. - 내 서버에 직접 배포할 때: 서버의
env.txt(또는 환경 변수)에 같은 이름으로 넣어 주세요.
앱을 열면 로그인 화면에 네이버로 계속하기 버튼이 생겨요. 앱에 닉네임 같은 프로필 항목이 있다면, 처음 로그인한 사용자는 프로필 입력 화면으로 이어져요.


🔒 키는 이렇게 다뤄 주세요
- Client ID는 로그인할 때 브라우저 주소창에도 보이는 값이라 비밀은 아니에요.
- Client Secret은 서버만 쓰는 비밀값이에요. 화면 코드나 GitHub 저장소, 채팅방에 붙여 넣지 마세요. 혹시 노출됐다면 개요 화면에서 재발급받고 새 값으로 바꿔 주세요. (재발급하면 기존 값은 30일 뒤 완전히 지워져요.)
🧯 이런 화면이 나오면
"입력하신 아이디로 로그인할 수 없습니다" (개발 중 상태)
앱이 아직 개발 중이고, 로그인한 아이디가 관리자나 테스터가 아니에요. 멤버관리 → 테스터 ID 등록에 그 아이디를 넣어 주세요. 단체 아이디는 테스터로도 로그인할 수 없으니 개인 아이디를 쓰세요.

네이버에서 돌아오지 않거나 Callback URL 오류가 나요
서비스 환경이 PC 웹인지, Callback URL이 지금 열고 있는 앱 주소 + /login과 정확히 같은지(http/https, 포트까지) 확인해 주세요.
네이버에서 돌아왔는데 "로그인에 실패했습니다"
대부분 서버에 넣은 값 문제예요. NAVER_CLIENT_ID와 NAVER_CLIENT_SECRET이 같은 애플리케이션의 값인지 확인하고, 값을 고쳤다면 docker compose up -d로 다시 시작해요.
📚 「소셜 로그인 직접 설정하기」 시리즈
- ① Google
- ② 카카오
- ③ 네이버 (이 글)
- ④ Facebook
- ⑤ Apple (준비 중이에요)
설정이 번거롭게 느껴진다면, 키 관리 없이 바로 쓸 수 있는 BackendX 로그인도 언제든 선택할 수 있어요 🙂