validateCsrfToken function

bool validateCsrfToken({
  1. required String? expectedToken,
  2. String? headerToken,
  3. String? formToken,
  4. bool enforce = true,
})

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);
}