Files
Gnuboard7/modules/_bundled/sirsoft-ecommerce/src/Services/GuestOrderAuthService.php
T
2026-07-01 10:30:32 +09:00

255 lines
10 KiB
PHP

<?php
namespace Modules\Sirsoft\Ecommerce\Services;
use Carbon\Carbon;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Log;
use Modules\Sirsoft\Ecommerce\Models\Order;
use Modules\Sirsoft\Ecommerce\Repositories\Contracts\OrderRepositoryInterface;
/**
* 비회원 주문 조회 인증 서비스
*
* 주문번호 + 전화번호 + 조회 비밀번호로 비회원 본인 확인을 수행하고,
* 성공 시 30분 유효한 HMAC 조회 토큰을 발급한다. 이후 주문 상세/액션은
* 이 토큰(X-Guest-Order-Token)으로 보호된다.
*
* 토큰 형식: `{expiresTs}|{HMAC-SHA256}` (2-파트, 만료시각만 평문 노출)
* - HMAC 입력: `{orderNumber}|{orderId}|{expiresTs}|{passwordHashSuffix}` + `config('app.key')`
* - 주문번호/주문ID/비밀번호 해시 suffix 는 HMAC 입력으로만 사용되어 토큰 평문에서 비노출
* - 검증 시 URL 의 주문번호로 Order 조회 → 현재 비밀번호 해시 suffix 와 HMAC 재계산 비교
* - 비밀번호 변경/관리자 재설정 시 suffix 가 바뀌어 기존 토큰 즉시 무효화 (stateless revocation)
*
* 보안 정책:
* - 모든 인증 실패(주문 없음/회원 주문/전화번호 불일치/비밀번호 오류)는 동일하게 처리
* (호출 측에서 단일 "주문을 찾을 수 없습니다" 응답)
* - 토큰은 만료/위조/다른 주문 재사용을 모두 차단
*/
class GuestOrderAuthService
{
/** 토큰 유효 시간 (분) */
public const TOKEN_TTL_MINUTES = 30;
public function __construct(
private OrderRepositoryInterface $orderRepository
) {}
/**
* 전화번호를 비교용으로 정규화합니다.
*
* 숫자만 남기고, 국가번호 82 로 시작하는 국내 휴대전화는 앞자리를 0 으로 변환합니다.
* 예: "+82 10-1234-5678" → "01012345678", "010-1234-5678" → "01012345678"
*
* @param string|null $phone 원본 전화번호
* @return string 정규화된 전화번호 (숫자 only)
*/
public function normalizePhone(?string $phone): string
{
$digits = preg_replace('/\D/', '', (string) $phone);
if ($digits === '') {
return '';
}
// 국가번호 82 로 시작하면 0 으로 치환 (821012345678 → 01012345678)
if (str_starts_with($digits, '82')) {
$digits = '0'.substr($digits, 2);
}
return $digits;
}
/**
* 비회원 본인 확인 후 조회 토큰을 발급합니다.
*
* 인증에 성공하면 주문과 발급 토큰 정보를 반환하고, 실패하면 null 을 반환합니다.
* 실패 사유(주문 없음/회원 주문/전화번호 불일치/비밀번호 오류)는 구분하지 않습니다.
*
* @param string $orderNumber 주문번호
* @param string $ordererPhone 주문자 전화번호
* @param string $guestLookupPassword 조회 비밀번호 평문
* @param string|null $clientIp 요청 IP (실패 로그 식별용)
* @return array{order: Order, token: string, expires_at: string}|null 성공 시 토큰 정보, 실패 시 null
*/
public function authenticate(string $orderNumber, string $ordererPhone, string $guestLookupPassword, ?string $clientIp): ?array
{
$normalizedPhone = $this->normalizePhone($ordererPhone);
$order = $this->orderRepository->findByOrderNumber($orderNumber);
if (! $this->verifyOwnership($order, $normalizedPhone, $guestLookupPassword)) {
$this->logFailure('mismatch', $orderNumber, $clientIp);
return null;
}
$expiresAt = Carbon::now()->addMinutes(self::TOKEN_TTL_MINUTES);
$token = $this->issueToken($order, $expiresAt);
return [
'order' => $order,
'token' => $token,
'expires_at' => $expiresAt->toIso8601String(),
];
}
/**
* 조회 토큰을 검증하고 대상 주문을 반환합니다.
*
* 토큰 형식: `{expiresTs}|{HMAC-SHA256}` (2-파트). 만료/위조/형식 오류 시
* null 을 반환합니다. 검증 흐름:
* 1. 토큰 파싱(2-파트) + 만료시각 정수성/만료 여부 확인
* 2. URL 주문번호로 비회원 주문 조회 (다른 주문 재사용 차단 — 토큰의 HMAC 입력에
* 주문번호/주문ID 가 포함되므로 다른 주문번호로 조회한 Order 의 ID 로 재계산하면
* 서명 불일치)
* 3. HMAC 재계산 후 timing-safe 비교
*
* @param string|null $token X-Guest-Order-Token 헤더 값
* @param string $expectedOrderNumber 접근하려는 주문번호 (라우트 파라미터)
* @return Order|null 검증된 주문, 실패 시 null
*/
public function verifyToken(?string $token, string $expectedOrderNumber): ?Order
{
if (! is_string($token) || $token === '') {
return null;
}
$parts = explode('|', $token);
if (count($parts) !== 2) {
return null;
}
[$expiresTs, $signature] = $parts;
// 만료시각 형식 + 만료 여부 확인
if (! ctype_digit($expiresTs) || (int) $expiresTs < Carbon::now()->getTimestamp()) {
return null;
}
// 서명 형식 확인 (HMAC-SHA256 hex 64자)
if (! ctype_xdigit($signature) || strlen($signature) !== 64) {
return null;
}
// URL 의 주문번호로 비회원 주문 조회 (다른 주문 재사용 차단 1차)
$order = $this->orderRepository->findByOrderNumber($expectedOrderNumber);
if (! $order || $order->user_id !== null) {
return null;
}
// HMAC 재계산 후 timing-safe 비교. 다른 주문번호로 발급된 토큰은 orderNumber/orderId 가 달라
// 서명이 일치하지 않으며, 발급 이후 비밀번호가 변경되면 passwordHashSuffix 가 달라져 즉시 무효화된다.
$expectedSignature = $this->sign(
$order->order_number,
(int) $order->id,
(int) $expiresTs,
$this->passwordHashSuffix($order)
);
if (! hash_equals($expectedSignature, $signature)) {
return null;
}
return $order;
}
/**
* 주문 소유권을 검증합니다 (비회원 주문 + 전화번호 + 비밀번호 일치).
*
* @param Order|null $order 조회된 주문
* @param string $normalizedPhone 정규화된 입력 전화번호
* @param string $guestLookupPassword 조회 비밀번호 평문
* @return bool 소유권 일치 여부
*/
private function verifyOwnership(?Order $order, string $normalizedPhone, string $guestLookupPassword): bool
{
// 회원 주문이거나 조회 비밀번호 해시가 없으면 비회원 조회 대상 아님
if (! $order || $order->user_id !== null || empty($order->guest_lookup_password_hash)) {
return false;
}
// 비밀번호 검증
if (! Hash::check($guestLookupPassword, $order->guest_lookup_password_hash)) {
return false;
}
// 전화번호 비교 (주문자 전화번호, 동일 정규화 규칙)
$orderPhone = $this->normalizePhone($order->shippingAddress?->orderer_phone);
if ($orderPhone === '' || ! hash_equals($orderPhone, $normalizedPhone)) {
return false;
}
return true;
}
/**
* HMAC 조회 토큰을 발급합니다.
*
* 토큰 평문에는 만료시각만 노출하고, 주문번호/주문ID/비밀번호 해시 suffix 는
* HMAC 입력으로만 사용한다. 검증 시 URL 주문번호로 Order 를 조회한 뒤 현재 시점의
* 비밀번호 해시 suffix 로 HMAC 을 재계산해 비교한다.
*
* @param Order $order 대상 주문
* @param Carbon $expiresAt 만료시각
* @return string `{expiresTs}|{signature}` 형식 토큰 (2-파트)
*/
private function issueToken(Order $order, Carbon $expiresAt): string
{
$expiresTs = $expiresAt->getTimestamp();
$signature = $this->sign(
$order->order_number,
(int) $order->id,
$expiresTs,
$this->passwordHashSuffix($order)
);
return implode('|', [$expiresTs, $signature]);
}
/**
* 토큰 서명을 생성합니다 (앱 키 기반 HMAC-SHA256).
*
* @param string $orderNumber 주문번호
* @param int $orderId 주문 ID
* @param int $expiresTs 만료 timestamp
* @param string $passwordHashSuffix 조회 비밀번호 해시 suffix (stateless revocation 용)
* @return string HMAC 서명
*/
private function sign(string $orderNumber, int $orderId, int $expiresTs, string $passwordHashSuffix): string
{
$payload = $orderNumber.'|'.$orderId.'|'.$expiresTs.'|'.$passwordHashSuffix;
return hash_hmac('sha256', $payload, (string) config('app.key'));
}
/**
* HMAC 입력에 포함될 조회 비밀번호 해시 suffix 를 반환합니다.
*
* bcrypt 해시(60자)의 마지막 10자만 사용. HMAC 입력에만 사용되어 외부에 노출되지 않으며,
* 비밀번호 변경/관리자 재설정 시 suffix 가 바뀌어 기존 토큰의 서명이 자동으로 불일치한다.
* suffix 가 비어있을 가능성은 verifyOwnership 단계에서 차단되지만, 안전상 빈 문자열을 허용.
*
* @param Order $order 대상 주문
* @return string 비밀번호 해시 suffix (최대 10자)
*/
private function passwordHashSuffix(Order $order): string
{
return substr((string) $order->guest_lookup_password_hash, -10);
}
/**
* 조회 실패를 민감값 없이 최소 정보로 기록합니다.
*
* @param string $reason 실패 사유 코드 (mismatch)
* @param string $orderNumber 주문번호
* @param string|null $clientIp 요청 IP
*/
private function logFailure(string $reason, string $orderNumber, ?string $clientIp): void
{
Log::info('Guest order lookup failed', [
'reason' => $reason,
'order_number' => $orderNumber,
'ip' => $clientIp,
]);
}
}