>마일드코드

바이브코딩에 꼭 필요한 필수 백엔드 개념 마스터하기

2026.10.24읽는 시간 9분영상
#입문#바이브코딩#백엔드
영상: 바이브코딩에 꼭 필요한 필수 백엔드 개념 마스터하기
한눈에 답하면

로그인, 결제, 데이터베이스를 붙이기 시작하면 AI 가 API, 웹훅, DB 테이블, 인증 같은 말을 꺼냅니다. 콘서트 예약 한 건을 따라가면서 그 말들이 각각 서버의 어느 지점을 가리키는지 정리했습니다. 끝까지 읽으면 AI 에게 맡겨도 되는 부분과 내가 직접 확인해야 하는 부분을 구분할 수 있습니다.

바이브코딩을 하다 보면 그럴듯한 화면은 금방 나옵니다. 그런데 로그인, 결제, DB 같은 걸 붙이기 시작하면 API, 웹훅, DB 테이블, 인증 같은 잘 이해가 안 되는 말을 AI 가 꺼내기 시작하죠.

그때 비개발자분들은 그 자리에서 막혀서 더 못 나가거나, 「알아서 해 줘」 하고 넘어갑니다. 화면은 눈에 보이기라도 하는데 백엔드, 즉 서버 쪽은 눈에도 안 보이고 코드를 한 줄씩 읽을 수도 없으니까요.

이 글을 다 읽고 나면 「백엔드는 대충 이렇게 굴러가는구나, AI 가 하는 말이 이거구나」 정도까지는 가실 수 있게 정리해 보겠습니다.

눈에 안 보이는 쪽이 백엔드입니다

콘서트 예약 웹페이지를 만든다고 해 볼게요. 사용자가 접속해서 보는 화면은 프론트엔드의 영역입니다. 아주 쉽게 말하면 사용자 눈에 보이게 만드는 모든 것을 다루는 영역이에요.

그럼 눈에 보이지 않지만 이 예약 시스템을 이루는 건 뭘까요. 누가 예약을 했는지, 남은 좌석이 얼마인지, 예약 신청을 받아서 저장하고, 내가 예약한 내용을 기억해 뒀다가 요청하면 알려 주는 일. 이런 일을 보통 백엔드, 즉 서버 쪽에서 다룹니다.

서버는 요청을 기다리는 컴퓨터입니다

그럼 서버는 뭘까요. 서버도 결국 컴퓨터입니다. 정확하게는 요청이 들어오기를 기다리면서 계속 켜져 있는 컴퓨터와, 그 위에서 실행되는 프로그램을 서버라고 부릅니다. 반대로 사용자가 예약 페이지를 여는 컴퓨터나 휴대폰의 브라우저, 앱은 클라이언트라고 하고요.

둘은 요청과 응답으로 통신합니다. 사용자가 예약하기 버튼을 누르면 클라이언트가 서버에 「이 좌석을 예약해 주세요」라는 요청을 보내고, 서버는 예약을 처리한 다음 「예약이 완료됐습니다」라는 응답을 돌려줍니다. 요청을 보내는 쪽이 먼저 말을 걸고, 서버는 요청을 받은 다음에 응답합니다.

이렇게 화면은 클라이언트가, 데이터를 저장하고 확인하는 일은 서버가 맡도록 나눈 구조를 클라이언트-서버 구조라고 합니다. 백엔드는 이 구조에서 서버 쪽이 맡는 일들입니다.

백엔드는 정말 넓습니다. 이 글은 그중에서 바이브코딩을 하다가 가장 많이 막히는 다섯 지점만 다룹니다.

지점AI 가 꺼내는 말한 줄로
1배포, 로컬, 클라우드서버를 내 컴퓨터에서 늘 켜져 있는 컴퓨터로 옮기기
2API, 웹훅서버로 요청이 들어오는 창구
3인증, 인가(권한 확인), 토큰누가 보냈는지, 해도 되는 일인지
4데이터베이스, DB 테이블계속 남아 있어야 하는 데이터를 두는 곳
5비밀 키, 환경 변수, 암호화새면 안 되는 것들을 지키는 법

로컬에서 돌던 서버는 노트북을 덮으면 꺼집니다

제가 보기에 가장 먼저 막히는 지점은 배포입니다. 예약 페이지를 만들다 보면 AI 가 「로컬에서 서버를 실행했습니다」라고 안내하는 경우가 많거든요.

로컬은 지금 작업하고 있는 내 컴퓨터를 말합니다. 로컬에서 실행한 서버에는 내 컴퓨터에서만 접속할 수 있고, 노트북을 덮거나 전원을 끄면 서버도 같이 꺼집니다. 그러면 다른 사용자들은 예약 페이지를 열어도 요청을 보낼 서버가 없는 거죠.

그래서 서버를 늘 켜져 있고 누구나 접속할 수 있는 컴퓨터로 옮겨야 하는데, 이 작업을 배포라고 합니다. 이렇게 클라우드 회사가 운영하는 컴퓨터를 빌려서 서버를 실행하는 방식을 일반적으로 클라우드라고 부릅니다.

요즘 배포 플랫폼은 서버를 켜 두고 돌보는 일까지 대신 해 주기도 합니다. 그렇다고 서버가 없어지는 건 아니에요. 그 일을 플랫폼이 가져갔을 뿐, 아래에서 나오는 확인들은 여전히 서버 쪽에서 일어나야 합니다.

API 는 서버가 정해 둔 약속입니다

서버를 클라우드에 올렸으면, 예약 페이지가 그 서버에 요청을 보낼 수 있도록 서버가 받을 준비를 해 둬야 합니다. 서버가 외부 요청을 받으려고 열어 둔 일종의 창구를 API 라고 부릅니다. 「이런 요청을 보내면 이렇게 응답하겠다」고 서버가 정해 둔 약속이에요.

예약 서버라면 이런 API 들로 이뤄집니다.

  • 남은 좌석을 조회하는 API
  • 예약을 받는 API
  • 내 예약을 조회하는 API

예약 페이지는 필요한 API 에 요청을 보냅니다. AI 가 API 를 꺼내면 서버가 정해 둔 약속 중 하나를 말하는 거라고 보시면 됩니다.

반대 방향으로 들어오는 요청도 있습니다. 결제사나 메일 발송 서비스처럼 내 서버와 연결된 외부 서비스에서 어떤 일이 생겼을 때, 외부 서비스가 내 서버에 먼저 알리는 방식입니다. 이걸 웹훅이라고 합니다. 결제가 끝나면 결제사가 내 서버의 API 로 「결제가 끝났다」는 요청을 보내 주는 거죠. 이때는 결제사가 요청을 보내는 쪽, 그러니까 클라이언트 자리에 섭니다.

누가 먼저언제
API 호출예약 페이지필요할 때 서버에 요청
웹훅외부 서비스(결제사 등)어떤 일이 생겼을 때 서버에 알림
CAUTION

결제가 완료됐는지는 사용자에게 보이는 결제 완료 화면이 아니라, 결제사가 웹훅으로 보내 주는 요청을 받아서 확정해야 합니다. 결제 완료 화면이 뜨기 전에 사용자의 인터넷이 끊길 수도 있거든요. 그리고 웹훅 주소도 결국 API 라서, 서버는 그 요청이 정말 결제사에서 온 건지도 확인해야 합니다.

결국 요청을 보내는 쪽이 사용자든 외부 서비스든, 서버로 들어오는 요청은 전부 API 를 통해 들어옵니다.

로그인했다고 끝이 아닙니다

API 를 열어 두면 문제가 하나 생깁니다. 서버는 방금 요청을 보낸 사람이 누구인지 모릅니다. 서버 입장에서는 요청 하나하나가 따로따로 들어오기 때문이에요.

그래서 로그인이 필요합니다. 사용자가 로그인하면 서버가 아이디와 비밀번호로 확인하고, 로그인했다는 걸 증명하는 값을 클라이언트에 줍니다. 방식은 여러 가지가 있는데, 흔히 쓰는 게 토큰을 발급하는 방식이에요. 일종의 신분증이자 출입증이죠. 그다음부터 클라이언트는 요청마다 토큰을 함께 보내고, 서버는 토큰을 보고 누가 보낸 요청인지 확인합니다. 이렇게 사용자가 누구인지 확인하는 과정을 인증이라고 합니다.

그런데 인증만으로는 부족합니다. 로그인한 사용자가 다른 사람의 예약을 조회하려고 하면, 서버는 그 사람이 누구인지와 별개로 이 예약을 볼 권한이 있는지를 한 번 더 확인해야 하거든요. 이렇게 요청을 처리해도 되는지 확인하는 과정을 권한 확인, 다른 말로 인가라고 합니다.

묻는 것예약 시스템에서
인증누구세요?이 토큰은 사용자 1 의 것이 맞다
인가(권한 확인)이걸 해도 되나요?사용자 1 이 R-0002 예약을 볼 수 있나

둘은 다른 단계라서 서버에서도 보통 따로 처리합니다.

그리고 인가는 반드시 화면이 아니라 서버에서 해야 합니다. 화면에서 다른 사람의 예약 버튼을 숨겨 두는 것만으로는, 다른 사람의 예약을 조회하는 요청이 서버로 들어오는 것 자체를 막을 수 없거든요. 그래서 권한 확인은 서버가 요청이 들어올 때마다 하도록 만들어야 안전합니다. 인증과 권한 확인을 통과한 요청만 다음 단계로 넘어갑니다.

서버는 기억하지 않고, 데이터베이스가 남깁니다

통과한 예약은 나중에 「내 예약」 화면에서 다시 볼 수 있어야 하잖아요. 그런데 서버는 보통 요청 하나를 처리하고 나면 그 내용을 따로 기억해 두지 않습니다. 그래서 예약처럼 계속 남아 있어야 하는 데이터는 서버와 연결된 데이터베이스, 데이터를 오래 보관하는 전용 저장소에 둡니다.

데이터베이스 안에는 항목이 미리 정해진 표가 있습니다. 이 표를 테이블이라고 부릅니다. 예약이 한 건 들어올 때마다 예약 테이블에 한 줄씩 쌓이는 거예요.

예약 번호좌석예약한 사람결제 상태
R-0001A열 12번사용자 1결제 완료
R-0002B열 3번사용자 2결제 대기

AI 가 DB 테이블을 꺼내면, 예약을 저장할 표의 항목을 정하는 작업 정도로 이해하시면 됩니다.

그리고 브라우저 같은 클라이언트는 기본적으로 데이터베이스에 직접 붙지 않고 서버를 거쳐서 데이터베이스에 접근하도록 만드는 게 일반적입니다. 인증과 권한 확인을 하는 곳이 서버이기 때문이에요.

예를 들어 「내 예약」 화면이 서버를 거치지 않고, 아무 확인 없이 데이터베이스에서 바로 예약을 조회하도록 만들어져 있다고 해 볼게요. 그러면 요청에 든 예약 번호만 R-0001 에서 R-0002 로 바꿔도, 누가 보냈는지 확인할 곳이 없으니 다른 사람의 예약이 그대로 보일 수 있습니다.

NOTE

화면이 데이터베이스에 바로 붙는 구성도 있습니다. 그 경우에는 데이터베이스에 건 접근 규칙이 서버의 확인을 대신 맡습니다. 어느 쪽이든 따져 볼 질문은 같습니다. 누가 보냈는지, 해도 되는 일인지를 화면 말고 다른 곳에서 확인하고 있는가입니다. 이 구성은 프론트엔드 글에서 다뤘습니다.

비밀 키, 환경 변수, 그리고 암호화

서버를 거치게 해도 많은 분들이 놓치시는 게 있습니다. 비밀 키예요. 비밀 키는 서버가 데이터베이스나 메일 발송, AI 서비스 같은 외부 서비스에 연결할 때 쓰는 값입니다.

비밀 키를 화면 코드에 넣으면, 화면 코드는 클라이언트로 내려가니까 누구나 꺼내 쓸 수 있습니다. 그래서 비밀 키는 서버 쪽에 두고, 서버 코드에 직접 적지 않고 환경 변수에 두는 게 기본입니다. 환경 변수는 코드 밖에 따로 저장해 두고, 서버가 실행될 때 읽어 오는 설정값이에요.

하나 알아 두시면 좋은 게 있습니다. 내 컴퓨터에서 쓰는 환경 변수와 클라우드에 배포한 서버의 환경 변수는 따로 저장해야 합니다. 이걸 몰라서 헷갈리시는 분이 정말 많아요. 로컬에서는 잘 되던 기능이 배포하고 나서 안 된다면, 배포한 서버에 환경 변수가 빠져 있지 않은지부터 확인해 보세요. 플랫폼에 따라서는 환경 변수를 바꾼 뒤 다시 배포해야 반영되기도 합니다.

보안에서 AI 가 자주 꺼내는 말이 하나 더 있습니다. 암호화입니다. 여기서 두 가지를 구분해 두면 좋습니다.

어떻게왜
비밀번호 저장원래 값 그대로가 아니라, 다시 원래 값으로 되돌릴 수 없는 값으로 바꿔서 저장합니다데이터베이스가 유출돼도 원래 비밀번호가 그대로 드러나지 않게
오가는 연결클라이언트와 서버 사이의 요청과 응답을 암호화합니다중간에서 다른 사람이 내용을 엿볼 수 없게

비밀번호는 흔히 「암호화해서 저장한다」고 말하지만, 정확히는 되돌릴 수 없게 바꾸는 쪽입니다. 암호화는 열쇠가 있으면 다시 풀 수 있어서 둘은 다른 개념이에요.

오가는 연결을 암호화한 게 HTTPS 입니다. 주소가 https:// 로 시작하면 클라이언트와 서버 사이의 연결이 암호화돼 있다는 뜻이고, S 는 Secure 의 S 입니다.

예약 한 건을 처음부터 다시 따라가 보면

예약 한 건을 처음부터 만든다고 생각하고 다시 따라가 보겠습니다.

  1. 사용자가 좌석을 고르고 예약하기 버튼을 누르면, 클라이언트가 클라우드에 배포된 서버의 예약 API 로 요청을 보냅니다.
  2. 서버는 요청에 든 토큰으로 사용자를 인증하고, 이 사용자가 이 좌석을 예약해도 되는지 권한을 확인합니다.
  3. 통과하면 데이터베이스의 예약 테이블에 한 줄을 저장합니다.
  4. 결제를 붙였다면, 결제사가 웹훅으로 결제 완료를 알린 다음에 예약이 확정됩니다.
  5. 서버가 데이터베이스나 외부 서비스에 연결할 때 쓰는 비밀 키는 환경 변수에 있습니다.
  6. 사용자가 「내 예약」 화면을 열면, 서버가 다시 인증과 권한을 확인하고 예약 테이블에서 그 사람의 예약을 조회해서 돌려줍니다.

처음에 AI 가 꺼냈던 API, 웹훅, DB 테이블, 인증이 각각 어느 지점을 말한 건지 이제 조금 보이실 겁니다.

물론 이 다섯 지점이 백엔드의 전부는 아닙니다. 다루지 않은 영역도 많아요. 바이브코딩을 하면서 가장 많이 막히는 지점부터 이해하시도록 핵심만 골랐습니다.

맡길 부분과 확인할 부분을 가르는 눈

가져가시면 좋은 건 백엔드가 무엇으로 이뤄져 있는지에 대한 감입니다. AI 가 API, 웹훅, 인증 같은 말을 꺼냈을 때 그게 어느 지점 이야기인지, 그리고 AI 에게 맡겨도 되는 부분인지 내가 직접 확인해야 하는 부분인지 구분할 수 있으면 충분합니다.

AI 에게 맡겨도 되는 편내가 직접 확인해야 하는 편
API 를 만드는 코드, 테이블 항목을 짜는 일누가 보냈는지(인증)와 해도 되는지(권한 확인)를 서버가 매번 하는지
배포 과정의 자잘한 설정결제를 화면이 아니라 웹훅으로 확정하는지
화면과 서버 사이 요청 주고받기비밀 키가 화면 코드가 아니라 서버의 환경 변수에 있는지

저도 현직 개발자로 일하면서 보면, 이제는 AI 가 서버 코드도 정말 빠르게 작성합니다. 그런데 어디까지 AI 에게 맡기고 어디부터 내가 확인할지, 내 서비스의 백엔드에서 가장 중요한 부분을 내가 얼마나 알고 정할 수 있는지는 백엔드가 대충이라도 어떻게 생겼는지 알아야만 정할 수 있습니다. 안 그러면 매번 잘 모르는 영역에서 「알아서 해 줘」 하고 넘어갈 수밖에 없죠.

COPY THIS PROMPT
이 프로젝트의 서버 쪽을 점검만 해줘. 아직 아무것도 고치지 마.

1. 서버가 열어 둔 API 를 전부 표로 정리해줘. 각 API 가 무슨 일을 하는지 한 줄씩.
2. 각 API 마다, 누가 보냈는지 확인(인증)하는지, 그 사람이 해도 되는 일인지 확인(권한 확인)하는지 표시해줘.
 화면에서만 막고 서버에서는 확인하지 않는 곳이 있으면 따로 짚어줘.
3. 결제가 있다면, 결제 완료를 결제 완료 화면이 아니라 결제사가 보내는 웹훅으로 확정하는지,
 그 웹훅이 진짜 결제사에서 온 건지 확인하는지 알려줘.
4. 비밀 키가 코드나 화면 쪽 파일에 직접 적혀 있지 않은지, 로컬과 배포 서버 양쪽에 환경 변수로 들어가 있는지 확인해줘.
5. 비밀번호를 저장한다면 원래 값으로 되돌릴 수 없게 바꿔서 저장하는지 알려줘.

개발을 모르는 사람이 읽는다고 생각하고 쉬운 말로 설명해줘.

자주 묻는 것

COURSE
만드는 건 이제 쉽습니다. 문제는 그다음입니다.

바이브코딩 바닥부터 프로 개발자처럼 서비스를 운영하는 법과 수익화까지, 인프런 강의 「모두의 클로드 코드」에 순서대로 담았습니다.

개인 링크 페이지, 구글 로그인과 관리자 화면이 붙은 구독 관리 서비스, 결제 알림이 오는 모바일 앱, 자동 배포 파이프라인까지 네 가지를 직접 만들어 봅니다.

모두의 클로드 코드 보기