Struct NetboxConfig 

pub struct NetboxConfig {
    pub url: String,
    pub token: String,
    pub custom_field: String,
    pub sources: Vec<String>,
    pub vip_roles: Vec<String>,
    pub ca_cert_path: String,
    pub insecure_skip_verify: bool,
}

Configuration for the netbox IPAM backend.

token is a secret, so it belongs in ACME_PROXY_IPAM__NETBOX__TOKEN rather than in a file on disk — the same advice super::signer::Rfc2136Config::tsig_key_secret carries.

Fields

url: String

Base URL of the NetBox instance, e.g. https://netbox.example.com. Any path is kept, so an instance served under a subpath works.

token: String

NetBox API token. Both generations are accepted and the scheme follows the token itself: a v2 one (nbt_<key>.<secret>, the default since NetBox 4.5) is sent as Authorization: Bearer …, a legacy v1 one as Authorization: Token ….

custom_field: String

Custom field, on the IP address or on its device/VM, holding the extra names that address may have certified.

sources: Vec<String>

Which places a permitted name may come from. Empty, or an unknown entry, is a startup error; order is meaningless, since the result is a union. See crate::ipam::Source.

vip_roles: Vec<String>

Which NetBox address roles count as a service address for the vip source. Read only when vip is in sources, so this is which roles rather than whether to look at all.

ca_cert_path: String

Extra CA certificates (PEM) to trust on top of the public roots, for a NetBox behind an internal PKI. Ignored when insecure_skip_verify is on.

insecure_skip_verify: bool

Skip verification of NetBox’s TLS certificate entirely.

Off by default and meant as a temporary way out of an expired NetBox certificate: with it on, the answers this backend trusts could come from anyone able to intercept the connection. Startup logs a warning for as long as it is set.

Trait Implementations

impl Clone for NetboxConfig

fn clone(&self) -> NetboxConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NetboxConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for NetboxConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NetboxConfig

where NetboxConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.