SpnManager Kerberos SPN auditing and repair for Active Directory

Show-SqlSpnDiagnostic

The Show-SqlSpnDiagnostic command is used to provide visibility into recent SPN audit log files, enabling managers to quickly assess the impact of their ac...

Available today in SqlSpnManager

SQL Server is where this work started. Show-SqlSpnDiagnostic ships in SqlSpnManager, on the PowerShell Gallery now — Install-Module SqlSpnManager. You can run it today.

SPN Manager takes the same approach across the rest of the directory, 26 service families in all. How the two products relate long term is not settled, and the free edition’s scope may narrow toward auditing in a future release. Any version you install stays yours — the Gallery keeps published versions available.

The Show-SqlSpnDiagnostic command is used to provide visibility into recent SPN audit log files, enabling managers to quickly assess the impact of their actions on the system. This command is primarily used by administrators who need to troubleshoot issues related to SPN management.

  • Key business value:
    • Rapidly identify and diagnose issues related to SPN management
    • Improve overall system reliability and performance
  • Risks:
    • Inaccurate or incomplete log data can lead to misdiagnosis of issues
    • Failure to properly secure log files can compromise sensitive information
  • When a manager cares:
    • During troubleshooting exercises, when identifying the root cause of SPN-related issues is critical
    • When assessing the effectiveness of SPN management policies and procedures

To use Show-SqlSpnDiagnostic effectively:

  1. Run Show-SqlSpnDiagnostic without any parameters to list all recent audit log files, including their sizes and entry counts.
  2. Use the -Latest parameter to display only the path to the most recent file.
  3. Employ the -Tail N parameter to tail the last N entries in the most recent file.
# List all recent audit log files
Show-SqlSpnDiagnostic

# Display only the path to the most recent file
Show-SqlSpnDiagnostic -Latest

# Tail the last 10 entries in the most recent file
Show-SqlSpnDiagnostic -Tail 10

Watchpoints:

  • Ensure the log directory is correctly configured and accessible.
  • Be cautious when working with sensitive information stored in log files.

The Show-SqlSpnDiagnostic command helps you understand what’s happening with your SPN settings by showing recent changes made to them. To use it, follow these simple steps:

  1. First, run Show-SqlSpnDiagnostic without any parameters.
  2. Look for the most recent log file in the list and take a closer look at its contents using the -Latest parameter or -Tail N.
  3. Review the changes made to your SPN settings over time.

If you get stuck:

  • Check that you have permission to access the log files.
  • Consult with an experienced administrator if needed.
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 framework surface (not provider-specific)
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.

The Show-SqlSpnDiagnostic command operates within the following compliance requirements:

  • Data-handling: Logs sensitive information related to SPN settings and changes made.
  • Transit: Transmits log data between components, ensuring encryption is used where necessary.
  • At-rest: Stores logs securely in a designated directory with access controls in place.
  • Audit trail: Maintains an audit record of all actions performed on SPNs, including changes made.
  • Compliance requirements:
    • Aligns with standard security and compliance frameworks for SPN management.

Example 1

Show-SqlSpnDiagnostic

Example 2

Show-SqlSpnDiagnostic -Tail 20

Example 3

Get-Content (Show-SqlSpnDiagnostic -Latest)