BackendX
  • BackendX 소개
  • 블로그
  • 문의
Sign in Subscribe
By BackendX Team in 소셜 로그인 설정 — 19 Oct 2026

소셜 로그인 직접 설정하기 ③ 네이버

바이브코딩으로 만든 BackendX 앱에 네이버 로그인을 직접 연결하는 방법. 네이버 개발자 센터 앱 등록, PC 웹·Callback URL, 테스터 ID, 자주 나는 오류까지 화면과 함께 정리했어요.

BackendX와 네이버 로그인 연결

바이브코딩으로 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: 네이버 로그인을 골라요.
  • 제공 정보 선택: 아무것도 고르지 않아도 돼요. 로그인에는 네이버가 기본으로 주는 이용자 식별자만 쓰기 때문이에요. 닉네임 같은 정보는 앱의 프로필 화면에서 직접 받아요.
네이버 애플리케이션 등록 — 이름과 제공 정보
애플리케이션 이름과 제공 정보 — 제공 정보는 하나도 고르지 않아도 로그인돼요
⚠️
네이버 이메일은 확인된(verified) 주소가 아니에요. 제공 정보의 이메일은 사용자가 정한 '연락처 이메일'이고, 네이버는 확인 여부를 알려 주지 않아요. 그래서 BackendX는 네이버에서 받은 이메일을 항상 '확인 안 됨'으로 다뤄요. 앱의 기능이 확인된 이메일에 기댄다면(예: 이메일로 꼭 받아야 하는 안내) 백엔드엑스 채팅창에 그렇게 알려 주세요. 앱이 첫 로그인 때 확인 링크를 메일로 보내고, 이를 위해 메일 발송 키(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)

약관 동의에 체크하고 등록하기를 눌러요.

네이버 로그인 서비스 환경 PC 웹
서비스 환경: PC 웹 — 서비스 URL과 Callback URL(앱 주소 + /login)

③ Client ID와 Client Secret

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

네이버 Client ID와 Client Secret
개요: Client ID와 Client Secret (이미지에서는 가렸어요)

④ 개발 중에는 등록된 아이디만 로그인할 수 있어요

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

💡
단체(비즈니스) 아이디로 앱을 만들었다면 그 아이디로는 네이버 로그인을 할 수 없어요. 시험할 개인 네이버 아이디를 테스터 ID로 등록해 주세요. 개인 아이디로 앱을 만들었다면 그 아이디로 바로 시험할 수 있어요.
네이버 멤버관리 테스터 ID 등록
멤버관리: 시험할 개인 아이디를 테스터 ID로 등록 (이미지에서는 가렸어요)

모든 사용자에게 열려면 네이버 로그인 검수상태 탭에서 검수를 요청해요. 검수를 통과하면 아이디 제한이 없어져요.


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 로그인도 언제든 선택할 수 있어요 🙂

Previous

소셜 로그인 직접 설정하기 ② 카카오

Next

소셜 로그인 직접 설정하기 ④ Facebook

You might also like...

바이브코딩 앱 보안, BackendX가 대신 챙겨요
바이브코딩

바이브코딩 앱 보안, BackendX가 대신 챙겨요

바이브코딩으로 만든 앱, 보안 설정 없이 배포해도 될까요? BackendX로 배포한 앱에 기본으로 켜져 있는 웹 방화벽, 서버 점검, 보안 업데이트, 암호화와 백업을 정리했어요.
Read more
BackendX Team
바이브코딩으로 지도 앱 만들기: 카카오 지도 키 받고 앱 주소 등록하기
바이브코딩

바이브코딩으로 지도 앱 만들기: 카카오 지도 키 받고 앱 주소 등록하기

바이브코딩으로 만든 BackendX 앱에 카카오 지도와 장소 검색을 연결하는 방법. 카카오 앱 만들기부터 키 두 개, 카카오맵 켜기, 많이들 놓치는 도메인 등록까지 화면과 함께 정리했어요.
Read more
BackendX Team
바이브코딩으로 발음 평가 앱 만들기: Azure Speech 키 받기
바이브코딩

바이브코딩으로 발음 평가 앱 만들기: Azure Speech 키 받기

바이브코딩으로 만든 BackendX 앱에 Azure Speech 발음 평가를 연결하는 방법. Azure 가입부터 Speech 리소스, 키·지역 입력, 비용까지 화면과 함께 정리했어요.
Read more
BackendX Team
바이브코딩 너머: GitHub PR 로 백엔드엑스 앱에 요구사항 전달하기
바이브코딩

바이브코딩 너머: GitHub PR 로 백엔드엑스 앱에 요구사항 전달하기

바이브코딩만으로도 충분하지만, 코어 개발자라면 GitHub PR 로 변경을 보여 줄 수도 있어요. 백엔드엑스가 PR 을 요구사항으로 읽고 앱을 업데이트하는 방법을 알아봐요.
Read more
BackendX Team
BackendX © 2026
Powered by Ghost