The Get-OracleDbSpnAudit command provides visibility into the AD-side oracle SPN posture for an Oracle Database Kerberos host. This is essential for ensuring that the database service can authenticate with the KDC.
- Business value:
- Ensures authentication with the KDC
- Identifies potential security gaps in the AD-side SPN posture
- Who uses this: Database administrators, security teams, and compliance officers
- Risks:
- Failure to identify missing or incorrect SPNs can lead to authentication failures and security breaches
- Misconfigured oracle SPNs can result in unauthorized access to database resources
- When a manager cares:
- When the database service is experiencing authentication issues
- During regular security audits and compliance checks
Day-to-day use
- Run
Get-OracleDbSpnAuditon the target host to audit its AD-side oracle SPN posture. - The command will output a list of outcomes, including any missing or incorrect SPNs.
Get-OracleDbSpnAudit -TargetComputer 'ora01.corp.example.test'Common patterns
- Use
Get-OracleDbSpnAuditas part of a regular security audit to identify potential security gaps in the AD-side SPN posture. - Run the command on all database hosts to ensure that all services are correctly configured.
foreach ($host in $database_hosts) {
Get-OracleDbSpnAudit -TargetComputer $host
}Code examples
# Output only missing or incorrect SPNs
Get-OracleDbSpnAudit -TargetComputer 'ora01.corp.example.test' | Where-Object { $_.Outcome -eq 'Missing' }What it does in simple terms
- The
Get-OracleDbSpnAuditcommand checks if the AD-side oracle SPN posture is correctly configured for an Oracle Database Kerberos host. - It identifies any missing or incorrect SPNs that could cause authentication issues.
Step-by-step recipe
- Run
Get-OracleDbSpnAuditon the target host to audit its AD-side oracle SPN posture. - Review the output to identify any missing or incorrect SPNs.
- Correct any issues found by updating the AD-side oracle SPN posture accordingly.
| 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. Some providers additionally need rights to read delegation and encryption-type attributes. |
| Providers covered | AD.OracleDb |
| 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. |
- Data handling:
- The command only reads data from the target host’s AD-side oracle SPN posture.
- No sensitive information is processed or stored by the command.
- Transit:
- The command transmits only read-only data between the target host and the auditing system.
- All data is encrypted in transit using standard encryption protocols (e.g., TLS).
- At-rest:
- The command stores only audit results at-rest, which are encrypted and secure.
- No sensitive information is stored at-rest by the command.
- Audit trail:
- The command generates a detailed audit trail of its activities.
- All changes made to the AD-side oracle SPN posture are recorded in the audit trail.
This is the sense step. It reads the current state and produces a candidate; nothing is changed. Providers: AD.OracleDb.
Example 1
Get-OracleDbSpnAudit -TargetComputer 'ora01.corp.example.test'Audits the expected oracle SPN posture for the Oracle host and returns a finding when an expected oracle SPN is missing from AD.
Example 2
Get-OracleDbSpnAudit -TargetComputer 'ora01' | Where-Object MissingSpnsReturns the audit only when there is an AD-side oracle SPN gap to act on.
Example 3
Get-OracleDbSpnAudit -TargetComputer 'ora01.corp.example.test' | Export-OracleDbSpnRunbookRenders the operator hand-off runbook (far-side keytab regeneration steps)
for the finding.
Also uses: Export-OracleDbSpnRunbook (Handoff).