Nothing
# This file contains small cryptographic utility helpers that other auth and
# state helpers build on
# Used for constant-time comparisons and small byte-conversion tasks where
# sensitive data should not leak through timing or formatting
# 1 Cryptographic primitives ---------------------------------------------------
## 1.1 Raw and comparison helpers ----------------------------------------------
# Functions in this subsection encode raw values and compare secret material
# without branching on obvious input differences.
#' Convert raw vector to lowercase hex string (cachem-safe)
#'
#' Used when helpers need a cache-safe or log-safe hexadecimal encoding.
#'
#' @param r Raw vector to convert.
#' @return Lowercase hexadecimal string.
#' @keywords internal
#' @noRd
raw_to_hex_lower <- function(r) {
if (!is.raw(r)) {
err_input(
"raw_to_hex_lower requires a raw vector",
context = list(phase = "cache_key")
)
}
paste0(as.character(r), collapse = "")
}
#' Internal: normalize one compare input to raw bytes
#'
#' Used by `constant_time_compare()` before both values are passed through the
#' same blinded hashing path.
#'
#' @param x Raw bytes or a scalar character value.
#' @return Raw bytes for supported inputs, otherwise `NULL`.
#' @keywords internal
#' @noRd
constant_time_compare_normalize_input <- function(x) {
if (is.raw(x) && !is.null(x)) {
return(x)
}
if (is.character(x) && length(x) == 1L && !is.na(x)) {
return(charToRaw(as.character(x)))
}
NULL
}
#' Internal: compare two values using a timing-blinded path
#'
#' Character inputs are converted to raw bytes; invalid inputs are treated as a
#' mismatch but still pass through the same SHA-256 and accumulator path so the
#' caller does not branch on type- or length-based timing differences. Used by
#' token, JWT, and state-validation helpers.
#'
#' @param a First value to compare.
#' @param b Second value to compare.
#' @return `TRUE` when the values compare equal after normalization; otherwise
#' `FALSE`.
#' @keywords internal
#' @noRd
constant_time_compare <- function(a, b) {
a_raw <- constant_time_compare_normalize_input(a)
b_raw <- constant_time_compare_normalize_input(b)
if (is.null(a_raw) || is.null(b_raw)) {
# Treat invalid inputs as a mismatch but keep the blinded comparison path.
a_raw <- raw()
b_raw <- as.raw(0L)
}
ar <- openssl::sha256(a_raw)
br <- openssl::sha256(b_raw)
acc <- as.integer(0L)
for (i in seq_len(length(ar))) {
ai <- as.integer(ar[[i]])
bi <- as.integer(br[[i]])
acc <- bitwOr(acc, bitwXor(ai, bi))
}
isTRUE(identical(acc, 0L))
}
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.