3 releases
0.1.2 | Jul 1, 2024 |
---|---|
0.1.1 | Jun 30, 2024 |
0.1.0 | Jun 30, 2024 |
#267 in Windows APIs
36KB
524 lines
laps-rs
THIS CRATE IS WINDOWS ONLY!
Library for the retrieval of LAPS passwords
Central for that are the two structs AdConnection
and AdConnectionAsync
which hold a connection to the Active Directory and implement try_search()
Usage
In Cargo.toml
:
[dependencies.laps_rs]
version = "0.1.0"
Example
Both examples perform a search for "computername"
Synchronous search
use laps_rs::{AdSettings, AdConnection, LdapProtocol, Scope};
let settings = AdSettings::new(
"dc.test.internal",
636,
LdapProtocol::Secure,
"OU=path,OU=to,OU=computers,DC=test,DC=internal",
Scope::Subtree,
);
let mut con: AdConnection = settings.connect()?;
let password = con.try_search("computername", &settings)?;
println!("{password:?}");
See also [AdConnection::try_search()
]
Asynchronous search
use laps_rs::{AdSettings, AdConnectionAsync, LdapProtocol, Scope};
let settings = AdSettings::new(
"dc.test.internal",
636,
LdapProtocol::Secure,
"OU=path,OU=to,OU=computers,DC=test,DC=internal",
Scope::Subtree,
);
let mut con: AdConnectionAsync = settings
.connect_async()
.await?;
let password = con
.try_search("computername", &settings)
.await?;
println!("{password:?}");
See also [AdConnectionAsync::try_search()
]
Quirks
Since it can be the case that both encrypted and unencrypted LAPS data exists for the same
computer [process_ldap_search_result()
] will prefer the encrypted information in case of
an identical password expiration.
In any other case the password with the longer expiration will be returned.
Current Version
0.1.2
Dependencies
~21–51MB
~801K SLoC