Crates.io | veil |
lib.rs | veil |
version | 0.1.7 |
source | src |
created_at | 2022-09-14 12:02:24.37311 |
updated_at | 2023-11-20 13:27:36.31183 |
description | Rust derive macro for redacting sensitive data in `std::fmt::Debug` |
homepage | |
repository | https://github.com/primait/veil |
max_upload_size | |
id | 665739 |
size | 60,638 |
A derive macro that implements std::fmt::Debug
for a struct or enum variant, with certain fields redacted.
The purpose of this macro is to allow for easy, configurable and efficient redaction of sensitive data in structs and enum variants. This can be used to hide sensitive data in logs or anywhere where personal data should not be exposed or stored.
Add to your Cargo.toml:
[dependencies]
veil = "0.1.7"
Usage documentation can be found here.
The example is explained in detail here.
#[derive(Redact)]
struct CreditCard {
#[redact(partial)]
number: String,
#[redact]
expiry: String,
#[redact(fixed = 3)]
cvv: String,
#[redact(partial)]
cardholder_name: String,
}
#[derive(Redact)]
#[redact(all, variant)]
enum CreditCardIssuer {
MasterCard,
Visa,
AmericanExpress,
}
#[derive(Redact)]
#[redact(all, partial)]
struct Vehicle {
license_plate: String,
make: String,
model: String,
color: String,
}
#[derive(Debug)]
struct Policy {
id: Uuid,
name: String,
description: String,
}
#[derive(Redact)]
enum InsuranceStatus {
#[redact(all, partial)]
Insured {
#[redact(fixed = 12)]
policy: Policy,
policy_started: String,
policy_expires: String,
#[redact(skip)]
payment_card: CreditCard,
#[redact(skip)]
vehicles: Vec<Vehicle>,
},
Uninsured {
policies_available: Vec<Policy>,
},
}
In testing environments it may be useful to disable redaction entirely. You can globally disable Veil's redaction behavior at runtime by enabling the non-default feature flag toggle
and:
VEIL_DISABLE_REDACTION
environment variable to "1", "true" or "on" (case insensitive).OR
veil::disable
function. See this example.These are only checked ONCE for security purposes.