65 lines
2.2 KiB
PHP
65 lines
2.2 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Requests\Identity;
|
|
|
|
use Illuminate\Foundation\Http\FormRequest;
|
|
|
|
/**
|
|
* 외부 IDV provider 의 redirect 콜백 수신 요청.
|
|
*
|
|
* `POST /api/identity/callback/{providerId}` — 외부 본인인증 SDK / OAuth-style
|
|
* provider 가 사용자 브라우저를 우리 서버로 다시 보내는 콜백 진입점.
|
|
*
|
|
* 요청 형식 예시:
|
|
* - PortOne 스타일: body 에 `{ challenge_id, identity_verification_id, ... }`
|
|
* - OAuth 스타일: query 에 `?challenge_id=...&code=...&state=...`
|
|
*
|
|
* 본 FormRequest 는 challenge_id 추출 + 자유로운 provider 페이로드 통과만 검증합니다.
|
|
* 실제 provider 별 페이로드 해석은 IdentityVerificationManager 가 provider 의
|
|
* `verify($challengeId, $input, $context)` 에 위임합니다.
|
|
*
|
|
* @since engine-v1.46.0
|
|
*/
|
|
class IdentityCallbackRequest extends FormRequest
|
|
{
|
|
/**
|
|
* 요청 권한 — 외부 redirect 콜백은 라우트 미들웨어 (throttle/optional.sanctum) 가 담당.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function authorize(): bool
|
|
{
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 검증 규칙.
|
|
*
|
|
* challenge_id 는 body 또는 query 둘 중 하나에 반드시 포함되어야 합니다.
|
|
* 그 외 provider 별 필드는 자유 통과 (provider->verify 내부에서 추가 검증).
|
|
*
|
|
* @return array<string, array<int, string>>
|
|
*/
|
|
public function rules(): array
|
|
{
|
|
return [
|
|
'challenge_id' => ['required', 'string', 'max:64'],
|
|
// 일반적으로 사용되는 필드 — 명시적으로 nullable 로 허용해 검증 통과
|
|
'code' => ['nullable', 'string', 'max:512'],
|
|
'token' => ['nullable', 'string', 'max:1024'],
|
|
'state' => ['nullable', 'string', 'max:512'],
|
|
'redirect_url' => ['nullable', 'string', 'max:2048'],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* body / query 양쪽에서 challenge_id 를 합쳐 검증 대상에 포함시킵니다.
|
|
*/
|
|
protected function prepareForValidation(): void
|
|
{
|
|
if (! $this->filled('challenge_id') && $this->query('challenge_id')) {
|
|
$this->merge(['challenge_id' => (string) $this->query('challenge_id')]);
|
|
}
|
|
}
|
|
}
|