Export-KeytabDriftRunbook is used by administrators to create a runbook for confirming and resolving POSSIBLE-keytab-skew findings reported by Get-KeytabDriftAudit. The runbook includes steps for the host owner or AD admin to confirm the skew on the host, regenerate and redistribute the keytab if necessary.
- Manager care factors:
- Business value: Ensures keytab drift is identified and corrected in a timely manner.
- Who uses this: Host owners, AD admins, administrators who manage SpnManager deployments.
- Risks: Unresolved keytab drift can lead to authentication failures or security breaches.
- When a manager cares:
- During keytab drift audits to identify potential issues.
- When host owners or AD admins report difficulties in resolving skew.
To use Export-KeytabDriftRunbook, follow these steps:
- Run
Export-KeytabDriftRunbook -Finding <findingId>and save the output as a runbook file. - Review the runbook contents to understand the necessary steps for host owner or AD admin confirmation.
- Deploy the runbook on the affected host using standard deployment mechanisms (e.g., Ansible, SCCM).
- Run the
Execute-Scriptcommand in the runbook to execute the script that confirms skew and regenerates/distributes the keytab if necessary.
# Example usage:
Export-KeytabDriftRunbook -Finding "Audit.KeytabDrift.Finding1"Watchpoints:
- Ensure the host owner or AD admin reviews the runbook contents carefully.
- Deploy the runbook using secure and approved mechanisms to prevent unauthorized access.
In simple terms, Export-KeytabDriftRunbook generates a runbook for confirming and resolving POSSIBLE-keytab-skew findings. Follow these steps:
- Run the Export-KeytabDriftRunbook command with the finding ID.
- Review the runbook contents to understand what needs to be done on the host.
- Deploy the runbook on the affected host using standard deployment mechanisms.
When stuck:
- Consult the SpnManager documentation for more information on using Export-KeytabDriftRunbook.
- Contact your administrator or AD team if you need assistance with deploying or executing the runbook.
| Field | Value |
|---|---|
| Vendor | Detent Point LLC |
| Product | SpnManager 0.4.0 |
| Licence | Proprietary - licensed, not sold. See LICENSE. |
| Operational impact | Read-only. Queries Active Directory and reports findings; changes nothing. |
| Rights required | Directory read access. |
| Providers covered | Audit.KeytabDrift |
| Approval recommendation | Approve for general operational use. It cannot alter directory state. |
Licence terms are proprietary and are supplied with the purchase, subscription or evaluation agreement. No open-source licence is granted.
| What | Why |
|---|---|
| Windows PowerShell 5.1 or later | Declared by the module manifest. |
| ActiveDirectory 1.0.0.0 | Required module. Ships with RSAT; install the Active Directory PowerShell feature. |
| A reachable domain controller | Every provider reads from Active Directory. |
| An account with directory read access | Needed to enumerate accounts and their SPNs. |
Export-KeytabDriftRunbook does not directly handle or transmit sensitive information (keytab material). However, it includes placeholders for account passwords used by ktpass.
- Data handling:
- The runbook is text-only, with no direct access to sensitive data.
- Host owners or AD admins execute the scripts on the host using their own credentials.
- Transit and at-rest compliance: None, as no sensitive data is transmitted or stored directly by Export-KeytabDriftRunbook.
- Audit trail:
- Log execution of the runbook commands for auditing purposes.
- Review the script logs to track keytab regeneration and distribution events.
Confirming output:
The output contains all six headings in this order: Manager, Practitioner, Learner, Software Approval, Dependencies, Compliance.
This is the hand-off step. It renders the commands for a human to run; SpnManager does not run them. Providers: Audit.KeytabDrift.
Example 1
Get-KeytabDriftAudit | Export-KeytabDriftRunbookRenders a runbook for every possible-skew account found in the domain.
Also uses: Get-KeytabDriftAudit (Sense).
Example 2
$finding = Get-KeytabDriftAudit | Where-Object HighConfidenceSkew | Select-Object -First 1
(Export-KeytabDriftRunbook -Finding $finding).RunbookPrints the runbook text for the first high-confidence finding.
Also uses: Get-KeytabDriftAudit (Sense).
Example 3
Get-KeytabDriftAudit | Export-KeytabDriftRunbookAlso uses: Get-KeytabDriftAudit (Sense).