# UPN suffixes details should be retrievable

Detailed visibility into UPN (User Principal Name) suffix configuration is essential for maintaining a secure and well-managed Active Directory…

Source: https://maester.dev/docs/tests/AD-FORS-02

<!-- This file is generated by website/scripts/generate-test-docs.mjs. Do not edit manually. -->

<div class="test-byline"><div class="test-byline-avatars"><a class="test-byline-avatar test-byline-avatar--author" href="/contributors/soulemike" title="Michael Soule · Original author"><img src="https://github.com/soulemike.png" alt="Michael Soule" width="28" height="28" loading="lazy" decoding="async" /></a></div><div class="test-byline-meta"><span class="test-byline-text">Contributed by <a href="/contributors/soulemike">Michael Soule</a></span><a class="test-byline-link" href="/contributors">All contributors →</a></div></div>

<p class="test-part">Part of <a href="/docs/tests/ad">Active Directory</a> · Active Directory · Domain and forest · <a href="/docs/tests">All checks</a></p>

```powershell title="Run this check"
Invoke-Maester -TestId AD-FORS-02
```

## Overview

Detailed visibility into UPN (User Principal Name) suffix configuration is essential for maintaining a secure and well-managed Active Directory environment. UPN suffixes directly impact:

 * **User Authentication**: Users log on with UPN format (user@domain.com), making suffix configuration critical for daily operations
 * **Multi-Domain Environments**: Organizations with multiple domains or brands rely on UPN suffixes for seamless authentication
 * **Security Boundaries**: Understanding configured UPN suffixes helps identify potential authentication attack surfaces
 * **Operational Continuity**: During domain migrations or consolidations, UPN suffix management ensures user authentication continuity

#### Control Type

**Operational**

#### Security Recommendation

Based on the UPN suffix details retrieved:

1. **Audit Regularly**: Review the list of UPN suffixes quarterly to ensure they align with current business requirements
2. **Remove Unused Suffixes**: Delete UPN suffixes from divested business units or completed migration projects
3. **Document Changes**: Maintain documentation of why each UPN suffix exists and which business unit owns it
4. **Monitor for Unauthorized Additions**: Unexpected UPN suffixes could indicate compromise or unauthorized administrative activity

#### How the Test Works

This test retrieves the complete list of UPN suffixes configured at the forest level. It displays each suffix individually, allowing administrators to review the complete authentication namespace configuration. The test uses `Get-ADForest` to access the `UPNSuffixes` property.

#### Related Tests

- `Test-MtAdUpnSuffixesCount` - Provides a count of configured UPN suffixes
- `Test-MtAdSpnSuffixesCount` - Checks SPN suffix configuration

## Details

<details>
<summary>Every attribute of this check</summary>

| Field | Value |
| --- | --- |
| Test ID | AD-FORS-02 |
| Severity | Info |
| Suite | Active Directory |
| Product | Active Directory |
| Feature | Domain and forest |
| Area | Infrastructure hardening |
| Resource type | Tenant |
| MITRE ATT&CK | None |
| PowerShell test | [Test-MtAdUpnSuffixesDetails](https://github.com/maester365/maester/blob/main/tests/ad/domain/Test.AD-FORS-02.ps1) |
| Services | ActiveDirectory |
| Permissions | ActiveDirectory:Ldap:crossRef:ReadProperty |

</details>

## Source

- Test: [`tests/ad/domain/Test.AD-FORS-02.ps1`](https://github.com/maester365/maester/blob/main/tests/ad/domain/Test.AD-FORS-02.ps1)
- Documentation: [`tests/ad/domain/Test.AD-FORS-02.md`](https://github.com/maester365/maester/blob/main/tests/ad/domain/Test.AD-FORS-02.md)
