laps-rs 0.1.2

Library for the retrieval of LAPS passwords
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

# laps-rs


THIS CRATE IS WINDOWS ONLY!

Library for the retrieval of [LAPS](https://learn.microsoft.com/en-us/windows-server/identity/laps/laps-overview) 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`:

```toml
[dependencies.laps_rs]
version = "0.1.0"
```

## Example

Both examples perform a search for `"computername"`

### Synchronous search

```rust
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

```rust
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