Struct V3SecurityConfig 

pub struct V3SecurityConfig {
    pub username: Bytes,
    pub auth: Option<(AuthProtocol, Vec<u8>)>,
    pub privacy: Option<(PrivProtocol, Vec<u8>)>,
    pub master_keys: Option<MasterKeys>,
}

SNMPv3 security configuration.

Stores the credentials needed for authenticated and/or encrypted communication. Keys are derived when the engine ID is discovered.

Master Key Caching

For high-throughput polling of many engines with shared credentials, use MasterKeys to cache the expensive password-to-key derivation. When master_keys is set, passwords are ignored and keys are derived from the cached master keys.

Fields

username: Bytes

Username for USM authentication

auth: Option<(AuthProtocol, Vec<u8>)>

Authentication protocol and password

privacy: Option<(PrivProtocol, Vec<u8>)>

Privacy protocol and password

master_keys: Option<MasterKeys>

Pre-computed master keys for efficient key derivation

Implementations

impl V3SecurityConfig

pub fn new(username: impl Into<Bytes>) -> Self

Create a new V3 security config with just a username (noAuthNoPriv).

pub fn auth(self, protocol: AuthProtocol, password: impl Into<Vec<u8>>) -> Self

Add authentication (authNoPriv or authPriv).

pub fn privacy( self, protocol: PrivProtocol, password: impl Into<Vec<u8>>, ) -> Self

Add privacy/encryption (authPriv).

pub fn with_master_keys(self, master_keys: MasterKeys) -> Self

Use pre-computed master keys for efficient key derivation.

When set, passwords are ignored and keys are derived from the cached master keys. This avoids the expensive ~850μs password expansion for each engine.

pub fn security_level(&self) -> SecurityLevel

Get the security level based on configured auth/privacy.

pub fn derive_keys(&self, engine_id: &[u8]) -> V3DerivedKeys

Derive localized keys for a specific engine ID.

If master keys are configured, uses the cached master keys for efficient localization (~1μs). Otherwise, performs full password-to-key derivation (~850μs for SHA-256).

Trait Implementations

impl Clone for V3SecurityConfig

fn clone(&self) -> V3SecurityConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for V3SecurityConfig

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

Formats the value using the given formatter.