← cd ~/errors
// entra id sign-in error · app registration and tokens
AADSTS500021
What Microsoft says
Access to '{tenant}' tenant is denied. AADSTS500021 indicates that the tenant restriction feature is configured and that the user is trying to access a tenant that isn't in the list of allowed tenants specified in the header Restrict-Access-To-Tenant. For more information, see Use tenant restrictions to manage access to SaaS cloud applications.
How to fix it
Microsoft doesn't publish a specific fix for this code beyond the description above. This site groups it under app registration and tokens, based on that description, so start with the steps below.
How to investigate
- Compare what the app sends (client ID, redirect URI, scopes, tenant) with the app registration.
- Decode the token or request: the JWT and SAML decoders on this site show exactly what was sent.
- Check the app's credentials (secrets and certificates) and whether the service principal exists and is enabled in this tenant.
- Search the sign-in logs for the request ID or correlation ID from the troubleshooting details on the error page.
Tools that help
The description is quoted from Microsoft's error code reference. The grouping and investigation steps are this site's guidance.