validateCsrfToken function
Validates a CSRF token from header and form values.
Returns true immediately when enforce is false. Otherwise a non-empty
expectedToken is required, and headerToken takes precedence over
formToken even when the header value is empty. Comparison is constant-time.
Implementation
bool validateCsrfToken({
required String? expectedToken,
String? headerToken,
String? formToken,
bool enforce = true,
}) {
if (!enforce) {
return true;
}
if (expectedToken == null || expectedToken.isEmpty) {
return false;
}
final presented = headerToken ?? formToken;
return presented != null &&
constantTimeStringEquals(expectedToken, presented);
}