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

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

바이브코딩으로 만든 BackendX 앱에 Facebook 로그인을 직접 연결하는 방법. Meta 앱 만들기, email 권한, JavaScript SDK 도메인, 앱 ID·시크릿, 개발 모드 테스터, 이메일이 없는 계정까지 화면과 함께 정리했어요.

BackendX와 Facebook 로그인 연결

바이브코딩으로 BackendX에서 앱을 만들고 있다면, 로그인은 기본으로 들어가는 BackendX 로그인으로 충분한 경우가 많아요. 그래도 소셜 로그인을 내 앱에 직접 연결해야 하는 바이브코더를 위해, 그 방법을 제공자별로 정리하는 「소셜 로그인 직접 설정하기」 시리즈예요. 이번 편에서는 Facebook(Meta)에 내 앱을 등록하고, 그 값을 BackendX 앱에 넣는 방법을 화면과 함께 따라가 볼게요.

🤔 먼저, 이 설정이 정말 필요한가요?

BackendX로 만든 앱의 로그인은 기본으로 BackendX 로그인(Sign in with BackendX)을 써요. 따로 고르지 않아도 기본으로 들어가고, 제공자 콘솔에 들어갈 필요도, 키를 관리할 필요도 없어요. 대부분의 앱은 이 글의 설정이 필요 없어요.

아래 두 경우에만 Facebook에 내 앱을 직접 등록하면 돼요.

  • 백엔드엑스 채팅창에서 Facebook 로그인을 BackendX 로그인을 거치지 않고 직접 연결해 달라고 요청한 경우
  • BackendX 로그인에서 제공하지 않는 로그인 방식이 필요해서 Facebook으로 직접 연결하기로 한 경우

어느 쪽인지 헷갈린다면, 앱의 API 문서나 BackendX가 알려 주는 환경 변수 목록을 확인해 보세요. FACEBOOK_APP_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:// 주소는 쓰지 마세요.


Meta for Developers에서 설정하기

Meta for Developers에 Facebook 계정으로 로그인한 뒤 내 앱 → 앱 만들기로 들어가요.

① 앱 만들기: 이름과 이용 사례

  • 앱 이름: Facebook 로그인 동의 화면에 그대로 보이는 이름이에요.
  • 앱 연락처 이메일: Meta가 앱에 관한 안내를 보낼 주소예요.
  • 이용 사례: Facebook 로그인을 통한 인증 및 사용자의 데이터 요청을 골라요.
  • 비즈니스: 지금은 연결하지 않아도 돼요.
Meta 앱 만들기 — 앱 이름과 이용 사례
앱 만들기 마지막 단계: 이용 사례는 Facebook 로그인 (이미지에서는 이메일을 가렸어요)

마지막 화면의 요구 사항(비즈니스 인증, 앱 검수)은 앱을 모든 사람에게 공개할 때 필요한 항목이에요. 내 계정으로 시험할 때는 건너뛰어도 돼요.

② 권한: email 추가

왼쪽 메뉴 이용 사례 → Facebook 로그인 → 맞춤 설정 → 권한 및 기능에서 email 옆의 추가를 눌러요. public_profile은 처음부터 들어가 있어요. 생일, 연령대 같은 다른 권한은 추가하지 않아도 돼요.

Facebook 로그인 권한 — email과 public_profile
권한 및 기능: email과 public_profile이 '테스트 준비 완료'면 돼요
⚠️
Facebook 이메일은 없을 수도 있어요. 사용자가 동의 화면의 액세스 권한 수정에서 이메일을 끌 수 있고, 휴대전화번호로 가입한 계정처럼 Facebook이 앱에 줄 이메일이 없는 계정도 있어요. 이메일을 허용했는데도 받지 못할 수 있다는 뜻이에요. BackendX 앱은 이메일이 없어도 그대로 가입·로그인돼요. 또 Facebook은 이메일 확인 여부를 알려 주지 않아서, 받은 이메일은 항상 '확인 안 됨'으로 다뤄요. 앱의 기능이 확인된 이메일에 기댄다면 백엔드엑스 채팅창에 그렇게 알려 주세요. 앱이 첫 로그인 때 확인 링크를 메일로 보내고, 이를 위해 메일 발송 키(SENDGRID_API_KEY)를 함께 물어봐요.

③ 설정: JavaScript SDK로 로그인

같은 화면의 설정 탭으로 가요. BackendX 앱은 Facebook의 JavaScript SDK로 로그인 창을 띄워요.

  • JavaScript SDK로 로그인: 예
  • JavaScript SDK에 허용된 도메인: 앱 주소의 도메인 (예: <프로젝트 ID>.app.pool1.backendx.cloud, 내 컴퓨터에서는 localhost)
  • 유효한 OAuth 리디렉션 URI: 비워 둬도 돼요.
  • 그 밖의 스위치는 기본값 그대로 두세요.
Facebook 로그인 클라이언트 OAuth 설정
클라이언트 OAuth 설정: JavaScript SDK로 로그인 '예', 허용된 도메인에 앱 도메인

④ 앱 설정: 앱 ID, 앱 시크릿 코드, 웹사이트 주소

왼쪽 메뉴 앱 설정 → 기본 설정에 앱 ID와 앱 시크릿 코드가 있어요. 앱 시크릿 코드는 보기를 눌러 확인해요.

Meta 앱 기본 설정 — 앱 ID와 앱 시크릿 코드
기본 설정: 앱 ID와 앱 시크릿 코드 (이미지에서는 가렸어요)
  • 앱 도메인: 배포한 앱의 도메인을 넣어요. localhost는 받아 주지 않으니, 내 컴퓨터에서만 시험할 때는 비워 둬도 돼요.
  • 페이지 맨 아래 플랫폼 추가 → 웹사이트를 고르고 사이트 URL에 앱 주소(예: https://<프로젝트 ID>.app.pool1.backendx.cloud/, 내 컴퓨터에서는 http://localhost:8080/)를 넣은 뒤 변경 내용 저장을 눌러요.
웹사이트 플랫폼 — 사이트 URL
플랫폼 추가 → 웹사이트: 사이트 URL에 앱 주소

⑤ 개발 모드에서는 앱 역할이 있는 계정만 로그인할 수 있어요

새로 만든 앱은 개발 모드예요. 이때는 앱을 만든 계정과 앱 역할에 넣은 계정(관리자, 개발자, 테스터)만 Facebook 로그인을 할 수 있어요. 다른 계정으로 시험하려면 앱 역할 → 역할 → 테스터 추가로 그 계정을 넣어 주세요.

모든 사용자에게 열려면 앱 설정 → 기본 설정의 개인정보처리방침 URL, 사용자 데이터 삭제, 앱 아이콘, 카테고리를 채우고, 대시보드의 필요한 작업에 나오는 항목을 마친 뒤 게시해요. 개발 모드에서는 동의 화면에 "로그인 검수를 위해 제출" 안내가 보여도 괜찮아요.


BackendX 앱에 값 넣기

환경 변수어디서 복사하나요
FACEBOOK_APP_ID앱 설정 → 기본 설정 → 앱 ID
FACEBOOK_APP_SECRET앱 설정 → 기본 설정 → 앱 시크릿 코드 (보기)
  • 백엔드엑스를 통해서 배포할 때: 배포 단계에서 BackendX가 필요한 값을 물어봐요. 같은 이름의 칸에 넣으면 돼요. 값이 비어 있으면 배포 전에 알려 줘요.
  • 내 컴퓨터에서 실행할 때: 프로젝트에서 내려받은 압축 파일의 env.txt에서 해당 줄을 찾아 = 뒤에 값을 붙여 넣고 docker compose up -d를 실행해요.
  • 내 서버에 직접 배포할 때: 서버의 env.txt(또는 환경 변수)에 같은 이름으로 넣어 주세요.

앱을 열면 로그인 화면에 Facebook으로 계속하기 버튼이 생겨요. 앱에 닉네임 같은 프로필 항목이 있다면, 처음 로그인한 사용자는 프로필 입력 화면으로 이어져요.

Facebook으로 계속하기 버튼이 있는 로그인 화면
설정을 마친 앱의 로그인 화면
Facebook 로그인 동의 화면
Facebook 동의 화면: 이름과 프로필 사진, 이메일 주소를 요청해요. 사용자는 '액세스 권한 수정'에서 이메일을 끌 수 있어요

🔒 키는 이렇게 다뤄 주세요

  • 앱 ID는 로그인할 때 브라우저에서도 쓰는 값이라 비밀은 아니에요.
  • 앱 시크릿 코드는 서버만 쓰는 비밀값이에요. 화면 코드나 GitHub 저장소, 채팅방에 붙여 넣지 마세요. 혹시 노출됐다면 기본 설정에서 재설정하고 새 값으로 바꿔 주세요.
  • BackendX 앱은 로그인할 때마다 Facebook에 "이 토큰이 내 앱 것인지"를 앱 시크릿 코드로 확인해요. 다른 앱에서 받은 토큰으로는 로그인할 수 없어요.

🧯 이런 화면이 나오면

"앱을 사용할 수 없음" (개발 모드)

앱이 아직 개발 모드이고, 로그인한 계정에 앱 역할이 없어요. 앱 역할 → 테스터 추가로 그 계정을 넣거나, 앱을 게시해 주세요.

"URL을 로드할 수 없음" 또는 도메인 오류

JavaScript SDK에 허용된 도메인에 지금 열고 있는 앱의 도메인이 있는지, 웹사이트 사이트 URL이 앱 주소와 같은지(http/https, 포트까지) 확인해 주세요. JavaScript SDK로 로그인이 '예'인지도 확인해요.

로그인은 되는데 이메일이 비어 있어요

사용자가 이메일 제공을 껐거나, Facebook이 그 계정의 이메일을 앱에 주지 않은 경우예요. 앱 문제가 아니고, 이메일 없이도 그대로 쓸 수 있어요. 앱에 이메일이 꼭 필요하다면 프로필 화면에서 직접 받도록 백엔드엑스 채팅창에 알려 주세요.

Facebook에서 돌아왔는데 "로그인에 실패했습니다"

대부분 서버에 넣은 값 문제예요. FACEBOOK_APP_ID와 FACEBOOK_APP_SECRET이 같은 앱의 값인지 확인하고, 값을 고쳤다면 docker compose up -d로 다시 시작해요.


📚 「소셜 로그인 직접 설정하기」 시리즈

  • ① Google
  • ② 카카오
  • ③ 네이버
  • ④ Facebook (이 글)
  • ⑤ Apple (준비 중이에요)

설정이 번거롭게 느껴진다면, 키 관리 없이 바로 쓸 수 있는 BackendX 로그인도 언제든 선택할 수 있어요 🙂

Previous

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

Next

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

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