To add a domain to Microsoft 365 and configure domain federation:
- In the Microsoft 365 Admin Center, go to
- Click Add Domain.
- In the Enter a domain you own field, enter the name of your domain.
- Click Next.
Choose a method to verify your ownership of the domain:
- Use Domain Connect to let Microsoft verify the domain.
- Add a TXT record to your domain's website using the values supplied by Microsoft.
- Upload a text file to your website's top-level folder.
- Click Verify.
Configure the DNS records on the domain registrar for other services.
Do not make the new domain the primary domain for your Microsoft 365 account. Setting the new domain as the default domain causes an error when you use Set-MsolDomainAuthentication to set the domain as a federated domain.
For more information, see Add a domain to Microsoft 365 in the Microsoft documentation.You've added your domain. Now you're ready to configure federation.
At the PowerShell command line, enter
Connect-MsolService.PowerShell initiates a connection to Azure and opens an embedded browser window.
- In the browser window, sign on to the Azure tenant with a Global Administrator account.
Run the following commands in the Azure AD PowerShell.
You can find the bolded values in the Microsoft 365 application configuration tab in PingOne for Enterprise.
$dom = "<your domain name, such as example.com>" $BrandName = "<The name of your organization, such as Example Inc.>" $ActiveLogOn = "<The Active Log On URI value from PingOne for Enterprise>" $LogOnURl = "<The Passive Log On URI value from PingOne for Enterprise>" $LogOffUrl = "<The Log Off URI value from PingOne for Enterprise>" $MyURI = "<The Issuer URI value from PingOne for Enterprise>" $Metadata = "<The Metadata Exchange URI value from PingOne for Enterprise>" $MySigningCert = "<The Signing Certificate text from PingOne for Enterprise in base64 format>" Set-MsolDomainAuthentication ` -DomainName $dom ` -FederationBrandName $BrandName ` -Authentication Federated ` -PassiveLogOnUri $LogonUrl ` -SigningCertificate $MySigningCert ` -IssuerUri $MyURI ` -LogOffUri $LogOffUrl ` -MetadataExchangeUri $Metadata ` -ActiveLofOnUri $ActiveLogOn `Important:
When copying the base64-encoded signing certificate to enter into the MSOL cmdlet, make sure to remove any line breaks in the certificate text. Line breaks will cause errors when attempting to execute the commands.
Use the following commands to confirm domain federation settings:
- Get-MsolDomain: check the status of domain federation.
- Set-MsolDomainAuthentication: change the authentication type for a given domain.
For a complete list of commands, see MSOnline in the Microsoft documentation.