SAML login to Cloud Director fails after configuration with "no local entity found for alias vcd, verify your configuration"

Products

• VMware Cloud Director

Issue/Introduction

After configuration of SAML for an organization login fails with "An unexpected error occurred, please contact your administrator". Checking the /opt/vmware/vcloud-director/logs/vcloud-container-debug.log we have the error:

2026-04-15 16:36:56,708 | DEBUG    | pool-jetty-2193500        | CustomSamlEntryPointForH5UI    | Error initializing entry point | requestId=95fc10f6-6e06-4e34-bb3f-201e5aef9952,request=GET https://<FQDN of VCD>/login/<Organization>/saml/login/alias/vcd,requestTime=1776285416694,remoteAddress=###########:29461,userAgent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ...,accept=text/html application/xhtml+xml application/xml;q 0.9 image/avif image/webp image/apng */*;q 0.8 application/signed-exchange;...
org.opensaml.saml2.metadata.provider.MetadataProviderException: No local entity found for alias vcd, verify your configuration.

Environment

VMware Cloud Director 10.x

Cause

The entity ID for the service provider is incorrect within Cloud Director, or the information in the .xml file from the identity provider is incorrect for the entityID value.

Resolution

Ensure that the service provider entity ID in Cloud Director is correct for the SAML configuration in the Organization -> Administration -> SAML. This should be an URL that references Cloud Director and the Organization. This is asserted to the identity provider for specific tenant access.

If that is correct please verify that the entityId in the .xml provided from the identity provider is correctly pointing to the same settings on the identity provider side.