바이브코딩 백엔드 개념, 서버·API·웹훅·인증·DB를 예약 한 건으로 이해
화면은 금방 만들어지는데 로그인, 결제, 데이터베이스를 붙이기 시작하면 AI가 API, 웹훅, DB 테이블, 인증 같은 말을 꺼내고 거기서 막히기 쉽습니다. 이 글은 바이브코딩 백엔드 개념을 콘서트 예약 한 건이 처리되는 흐름으로 풀어, AI가 하는 말이 백엔드의 어느 지점인지, 맡겨도 되는 부분과 내가 직접 확인할 부분이 어디인지 가르는 기준을 알려 줍니다.

프론트엔드와 백엔드, 클라이언트와 서버
콘서트 예약 웹페이지를 예로 듭니다. 사용자가 접속해서 보는 화면은 프론트엔드이고, 눈에 보이지 않게 일하는 쪽이 백엔드입니다. 누가 예약했는지, 남은 좌석이 몇 개인지 기억하고 예약 신청을 받아 저장했다가 사용자가 요청하면 알려 주는 일은 백엔드가 맡습니다.
- 서버: 요청이 들어오기를 기다리며 계속 켜져 있는 컴퓨터와 그 위에서 실행되는 프로그램입니다.
- 클라이언트: 사용자가 예약 페이지를 여는 컴퓨터나 휴대폰의 브라우저, 앱입니다.
- 요청과 응답: 예약하기 버튼을 누르면 클라이언트가 "이 좌석을 예약해 달라"는 요청을 보내고, 서버가 처리한 뒤 완료 응답을 돌려줍니다. 요청은 항상 클라이언트가 먼저 시작합니다.
화면은 클라이언트가, 데이터를 저장하고 확인하는 일은 서버가 맡도록 나눈 구조가 클라이언트-서버 구조입니다. 서버와 호스팅 비용은 "바이브코딩 서버 구조", 화면 쪽 기술은 "바이브코딩 프론트엔드 개념" 글에서 따로 다룹니다.
서버 배포, 로컬에서 클라우드로
바이브코딩에서 가장 먼저 막히는 곳이 배포입니다. AI가 "로컬에서 서버를 실행했다"고 하면, 로컬은 지금 작업하는 내 컴퓨터를 뜻합니다. 로컬 서버에는 내 컴퓨터에서만 접속할 수 있고, 노트북을 덮거나 전원을 끄면 서버도 같이 꺼집니다. 다른 사용자가 예약 페이지를 열어도 요청을 받아 줄 서버가 없습니다.
배포는 서버를 24시간 켜져 있고 누구나 접속할 수 있는 컴퓨터로 옮기는 작업입니다. 그런 컴퓨터를 빌려 서버를 실행하는 방식을 보통 클라우드라고 부릅니다. AI가 배포를 말하면 서버가 도는 컴퓨터를 내 컴퓨터에서 클라우드의 컴퓨터로 옮긴다는 뜻으로 읽으면 됩니다.
API와 웹훅, 요청이 들어오는 두 방향
API는 서버가 열어 둔 창구
서버가 외부 요청을 받으려고 열어 둔 창구가 API입니다. "이런 요청을 보내면 이렇게 응답하겠다"는 서버의 약속이기도 합니다. 예약 서버라면 남은 좌석 조회, 예약 받기, 내 예약 조회가 각각 API입니다. 예약 페이지는 필요할 때 해당 API에 요청을 보냅니다.
웹훅은 반대 방향
결제나 메일 발송처럼 내 서버와 연결된 외부 서비스에서 일이 생겼을 때, 외부 서비스가 내 서버에 먼저 알려 주는 방식이 웹훅입니다. 결제사에서 결제가 끝나면 결제사가 내 서버의 API로 "결제가 끝났다"는 요청을 보내 주는 식입니다. API는 내가 필요할 때 서버에 묻는 방식이고, 웹훅은 외부 서비스가 일이 생겼을 때 서버에 알리는 방식입니다.
결제 완료는 웹훅으로 확정한다
웹훅은 결제를 붙일 때 AI에게서 가장 자주 듣는 말입니다. 결제 완료 여부는 사용자 화면에 뜨는 결제 완료 표시가 아니라 결제사가 웹훅으로 보내 주는 요청을 받아서 확정해야 합니다. 완료 화면이 뜨기 전에 사용자의 인터넷 연결이 끊길 수도 있기 때문입니다. 사용자가 보내든 외부 서비스가 보내든, 서버로 들어오는 요청은 모두 API를 거쳐 들어옵니다.
인증과 권한 확인(인가)
서버는 누가 보냈는지 모른다
서버에는 요청이 하나하나 따로 들어옵니다. 방금 요청한 사람이 누구인지 서버는 스스로 알지 못하고, 그래서 로그인이 필요해집니다.
사용자가 로그인하면 서버가 아이디와 비밀번호로 사용자를 확인한 뒤, 로그인했다는 증명 값을 클라이언트에 내려 줍니다. 방식은 여러 가지인데 토큰을 발급하는 방식을 가장 많이 씁니다. 토큰은 신분증이자 출입증입니다. 클라이언트는 이후 요청마다 토큰을 함께 보내고, 서버는 토큰을 보고 요청한 사용자가 누구인지 확인합니다. 이렇게 사용자가 누구인지 확인하는 과정이 인증입니다.
인증만으로는 부족하다
로그인한 사용자가 다른 사람의 예약을 조회하려 하면, 서버는 누구인지와 별개로 이 사용자에게 이 예약을 조회할 권한이 있는지 한 번 더 확인해야 합니다. 요청을 처리해도 되는지 확인하는 이 과정이 권한 확인이고, 인증과 짝이 되는 말로 인가라고도 합니다. 인증과 인가는 다른 단계라 서버에서도 보통 따로 처리합니다.
권한 확인은 화면이 아니라 서버에서 한다
화면에서 다른 사람의 예약 버튼을 숨겨 두는 것만으로는, 다른 사람의 예약을 조회하는 요청이 서버로 들어오는 것 자체를 막지 못합니다. 요청은 화면을 거치지 않고 직접 만들어 보낼 수 있기 때문입니다. 그래서 권한 확인은 서버가 요청이 들어올 때마다 처리하도록 만들어야 안전합니다. 인증과 권한 확인을 통과한 요청만 다음 단계로 넘어갑니다.
데이터베이스와 테이블
서버는 요청 내용을 기억하지 않는다
서버는 요청 하나를 처리하고 나면 그 내용을 따로 기억하지 않습니다. 예약처럼 계속 남아 있어야 하는 데이터는 서버와 연결된 데이터베이스(데이터를 오래 보관하는 전용 저장소)에 저장합니다.
데이터베이스 안에는 예약 번호, 좌석, 예약한 사람, 결제 상태처럼 항목이 미리 정해진 표가 있고, 이 표가 테이블입니다. 예약이 한 건 들어올 때마다 예약 테이블에 한 줄씩 저장됩니다. AI가 "DB 테이블"을 말하면, 예약을 저장할 표의 항목을 구성하는 작업 정도로 이해하면 됩니다.
클라이언트는 데이터베이스에 직접 연결하지 않는다
브라우저 같은 클라이언트는 기본적으로 데이터베이스에 바로 연결하지 않고 서버를 거쳐 접근하게 만드는 것이 일반적입니다. 인증과 권한 확인을 처리하는 곳이 서버이기 때문입니다. 서버를 거치지 않으면 누가 보냈는지, 처리해도 되는 요청인지 확인되지 않은 요청이 그대로 데이터베이스로 갑니다.
예를 들어 내 예약 화면이 서버를 거치지 않고 아무 확인 없이 데이터베이스에서 예약을 바로 조회하게 되어 있다면, 요청의 예약 번호만 다른 번호로 바꿔도 확인할 곳이 없어 다른 사람의 예약이 그대로 나갈 수 있습니다. 서버를 거치지 않고 데이터베이스를 직접 쓰는 서비스를 쓴다면, 테이블마다 접근 규칙을 걸어 두는 것이 이 확인을 대신합니다.
비밀 키와 환경 변수
서버를 거치게 해도 많은 사람이 놓치는 부분이 비밀 키입니다. 비밀 키는 서버가 데이터베이스, 메일 발송, AI 서비스 같은 외부 서비스에 연결할 때 쓰는 값입니다. 화면 코드는 클라이언트로 내려가기 때문에 비밀 키를 화면 코드에 넣으면 누구나 꺼내 쓸 수 있습니다. 그래서 비밀 키는 서버 쪽에 두고, 가장 안전한 방법은 서버 코드에 직접 쓰지 않고 환경 변수에 저장하는 것입니다. 환경 변수는 코드 밖에 따로 저장해 두고 서버가 실행될 때 읽어 오는 설정값입니다.
로컬과 배포 서버의 환경 변수는 따로 둔다
내 컴퓨터에서 실행할 때 쓰는 환경 변수와, 클라우드에 배포한 서버의 환경 변수는 따로 저장합니다. 이걸 몰라서 헷갈리는 사람이 많습니다. 로컬에서는 잘 되던 기능이 배포한 뒤 안 된다면 배포한 서버에 환경 변수가 빠져 있지 않은지 먼저 확인합니다.
암호화와 HTTPS
보안 쪽에서 AI가 자주 꺼내는 말이 암호화입니다.
- 비밀번호 저장: 회원 가입을 하면 비밀번호가 데이터베이스에 저장되는데, 원래 값 그대로 저장하지 않고 원래 값을 알아낼 수 없는 값으로 바꿔 저장합니다. 그래야 데이터베이스가 유출돼도 비밀번호가 그대로 드러나지 않습니다.
- 통신 구간 암호화: 클라이언트와 서버 사이에 오가는 요청과 응답도 암호화해서 중간에서 내용을 볼 수 없게 만듭니다. 브라우저 주소창의 자물쇠 표시가 이 연결이 암호화되어 있다는 뜻이고, 이것이 HTTPS입니다.
예약 한 건으로 처음부터 다시 따라가기
따라 할 동작이 아니라 이해용 순서입니다.
- 사용자가 예약 페이지에서 좌석을 고르고 예약하기 버튼을 누르면, 클라이언트가 클라우드에 배포된 서버의 예약 API로 요청을 보냅니다.
- 서버가 요청에 포함된 토큰으로 사용자를 인증합니다.
- 서버가 이 사용자가 이 좌석을 예약해도 되는지 권한을 확인합니다.
- 서버가 데이터베이스의 예약 테이블에 한 줄을 저장합니다.
- 결제를 붙였다면 결제사가 웹훅으로 결제 완료를 서버에 알린 뒤 예약이 확정됩니다.
- 서버가 데이터베이스나 외부 서비스에 연결할 때 쓰는 비밀 키는 환경 변수에 저장되어 있습니다.
- 사용자가 내 예약 화면을 열면 서버가 다시 인증과 권한을 확인하고, 예약 테이블에서 사용자의 예약을 조회해 화면에 보여 줍니다.
용어 한눈에 보기
- 서버: 요청을 기다리며 계속 켜져 있는 컴퓨터와 그 위의 프로그램
- 배포: 서버를 내 컴퓨터에서 24시간 켜져 있는 클라우드 컴퓨터로 옮기는 일
- API: 서버가 요청을 받으려고 열어 둔 창구이자 응답 약속
- 웹훅: 외부 서비스가 일이 생기면 내 서버에 먼저 알리는 방식
- 인증: 요청한 사람이 누구인지 확인
- 인가(권한 확인): 그 사람이 이 요청을 해도 되는지 확인
- DB 테이블: 예약 같은 데이터를 저장하는, 항목이 정해진 표
- 환경 변수: 비밀 키 같은 값을 코드 밖에 두고 서버 실행 때 읽어 오는 설정값
AI에게 맡길 것과 내가 확인할 것
위 다섯 지점(배포, API와 웹훅, 인증과 권한, 데이터베이스, 비밀 키)이 백엔드의 전부는 아니지만 바이브코딩에서 가장 많이 막히는 곳입니다. AI가 서버 코드를 아무리 빨리 짜도, 어디까지 맡기고 어디부터 직접 확인할지는 백엔드가 대략 어떻게 구성되는지 알아야 정할 수 있습니다. 그렇지 않으면 모르는 영역에서 매번 "알아서 해 줘" 하고 넘어갈 수밖에 없습니다.
AI가 서버 코드를 만들어 준 뒤 이렇게 물어 보면 위 지점이 빠졌는지 점검할 수 있습니다.
방금 만든 서버 코드를 아래 기준으로 점검해 줘.
1. 로그인하지 않은 요청과 다른 사람의 데이터를 요청하는 경우를 서버에서 막고 있는가
2. 결제 완료를 화면이 아니라 웹훅으로 확정하고 있는가
3. 비밀 키가 화면 코드나 저장소에 들어 있지 않고 환경 변수에 있는가
4. 배포 서버에 필요한 환경 변수 목록이 무엇인가
5. 비밀번호를 원래 값 그대로 저장하고 있지는 않은가
자주 묻는 질문
웹훅과 API는 무엇이 다른가요?
방향이 다릅니다. API는 내 화면이나 앱이 필요할 때 서버에 요청하는 방식이고, 웹훅은 결제사 같은 외부 서비스가 일이 생겼을 때 내 서버에 먼저 알리는 방식입니다. 웹훅도 결국 내 서버의 API로 들어오는 요청입니다.
인증과 인가는 어떻게 다른가요?
인증은 요청한 사람이 누구인지 확인하는 것이고, 인가는 그 사람이 이 요청을 해도 되는지 확인하는 것입니다. 로그인(인증)이 됐다고 해서 다른 사람의 예약까지 볼 수 있어서는 안 되므로 서버에서 둘을 따로 확인합니다.
로컬에서는 되는데 배포하면 안 되는 이유가 뭔가요?
대부분 환경 변수 문제입니다. 내 컴퓨터의 환경 변수와 클라우드에 배포한 서버의 환경 변수는 따로 저장되므로, 배포한 서버에 비밀 키나 데이터베이스 주소가 빠져 있으면 기능이 실패합니다. 배포 서비스의 환경 변수 설정 화면부터 확인합니다.
권한 확인을 화면에서만 하면 안 되나요?
안 됩니다. 버튼을 숨겨도 요청은 화면을 거치지 않고 직접 만들어 보낼 수 있습니다. 권한 확인은 서버가 요청을 받을 때마다 해야 안전합니다.
이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.
원본 영상 보러가기 ↗