토스 페이먼츠에서 유저 id를 customerKey로 사용해도 될까?

유저 id를 그대로 customerKey로 사용하는 것은 보안상 위험합니다.

❌ 그 이유는?

노출 위험 – customerKey가 유출되면, 공격자가 유효한 사용자 ID를 쉽게 유추할 가능성이 있습니다.
예측 가능성 – MongoDB의 ObjectID는 불규칙한 아이디로 안전해보이지만 암호학적으로 안전하지 않으며 반복적으로 생성할 수 있습니다.
조작 가능성 – 사용자가 자신의 customerKey를 직접 변경할 수도 있습니다.

🔐 안전한 해결 방법: 유저의 `id를` 암호화하기

가장 안전한 방법은 user._id를 암호화하여 customerKey로 사용하는 것입니다.
이 후 복호화하여 원래 user._id를 확인할 수 있어야 합니다.

✅ 첫번째: 암호화 모듈 설치하기

Node.js 프로젝트에서 crypto 모듈을 설치하세요.

npm install crypto

✅ 두번째: `encrypt.js` 유틸리티 파일 생성하기

user._id를 암호화하고 복호화하는 함수를 만듭니다.

import crypto from 'crypto';

const SECRET_KEY = process.env.ENCRYPTION_KEY || 'your-secure-key-here'; // 32자 이상의 보안 키 사용
const IV_LENGTH = 16; // IV(초기화 벡터) 길이는 16바이트

export const encrypt = (text) => {
  const iv = crypto.randomBytes(IV_LENGTH);
  const cipher = crypto.createCipheriv('aes-256-cbc', Buffer.from(SECRET_KEY), iv);
  let encrypted = cipher.update(text);
  encrypted = Buffer.concat([encrypted, cipher.final()]);
  return iv.toString('hex') + ':' + encrypted.toString('hex'); // 문자열로 변환하여 반환
};

export const decrypt = (text) => {
  const textParts = text.split(':');
  const iv = Buffer.from(textParts[0], 'hex');
  const encryptedText = Buffer.from(textParts[1], 'hex');
  const decipher = crypto.createDecipheriv('aes-256-cbc', Buffer.from(SECRET_KEY), iv);
  let decrypted = decipher.update(encryptedText);
  decrypted = Buffer.concat([decrypted, decipher.final()]);
  return decrypted.toString();
};

✅ 3단계: 토스페이먼츠에서 암호화된 `customerKey` 사용하기

결제 요청을 보낼 때, user._id를 암호화된 customerKey로 변환해주세요.

import { encrypt } from '../utils/encrypt';

const makePayment = async (user) => {
  const customerKey = encrypt(user._id.toString()); // user._id 암호화
  console.log('암호화된 customerKey:', customerKey);

  const tossPayments = await loadTossPayments(CLIENT_KEY);
  tossPayments.requestBillingAuth('카드', {
    customerKey, // 안전한 customerKey
    successUrl: `${window.location.origin}/payment-success`,
    failUrl: `${window.location.origin}/payment-fail`,
  });
};

✅ 4단계: 결제 처리 시 `customerKey` 복호화하기

결제에 대한 응답을 처리할 때 customerKey를 복호화하여 원래 user._id를 복원해서 본인의 서버에서 해당유저에 대한 작업들을 처리 할수 있습니다.

import { decrypt } from '../utils/encrypt';

const processPayment = async (customerKey) => {
  const userId = decrypt(customerKey); // 복호화하여 user._id 복원
  console.log('복호화된 userId:', userId);

  // 유저 정보 조회 및 결제 처리
  const user = await User.findById(userId);
  if (!user) {
    throw new Error('사용자를 찾을 수 없습니다!');
  }

  console.log(`결제 처리 중: ${user.name}`);
};

🚀 왜 이 방법이 안전한가?

✅ 예측 불가능 – 암호화된 customerKey는 매번 다르게 생성됩니다.
✅ 추측 불가능 – 공격자가 보더라도 원본 _id를 유추할 수 없습니다.
✅ 위변조 방지 – 데이터를 변경하면 복호화가 실패합니다.
✅ 간편한 구현 – 결제 요청 전 암호화, 결제 응답 시 복호화만 하면 됩니다.

💡 `user._id`를 그냥 사용할 수 있을까?

⚠️ 절대 안 됩니다! _id를 노출하면 보안 문제가 발생할 수 있습니다.

🚨 MongoDB `_id`를 그대로 사용하면?

공격자가 다른 유저의 _id를 유추할 가능성이 높아집니다.
_id가 노출되면, 악의적인 사용자가 다른 유저로 위장할 수 있습니다.

✅ 최선의 보안 방법 정리

방법	보안 수준	설명
`user._id` 직접 사용	❌ 매우 위험	예측 가능, 조작 가능
`uuid()` 사용	✅ 안전	보안상 좋지만, 사용자와 연결 어려움
암호화된 `user._id` 사용	🔥 최고 보안	안전하고, 추적 가능

🚀 추가 보안 기능이 필요하신가요?

👉 토큰 유효기간을 설정하여 추가적인 보안을 강화할 수도 있습니다. 🚀
궁금한 점이 있으면 언제든지 질문하세요! 😊

웹개발의 모든 것

이 블로그 검색

웹개발 시장 전망 (프리랜서, 취업, 연봉)