Why am I seeing an authentication error in my embedded model?

The developer key in your embed code is not authorized to be used on this domain or in this application.

When a model embedded with a developer key is initialized, our system checks for a match between your developer key and your registered domain(s) and/or bundle ID(s).

If you try to embed a model into a domain or application that has not been registered to your developer key, this validation step will fail and the model will fail to load.

Add the current domain or bundle ID to your developer key (see How to edit my apps).

A developer key or user analytic ID ("uaid") is either missing from your embed code or is invalid.

When embedding a BioDigital Human model into a webpage, your embed code must include one of these two types of keys, which we use to authenticate your user credentials. 

Add a developer key or uaid to your embed code. There are two ways to do this:

• Republish the model from the web app to retrieve a new embed code.
  • If you are a developer and previously registered an app, your default developer key will automatically be inserted into your new embed code.
  • If you are not a developer or never registered an app with your developer account, a uaid will be inserted into your new embed code.
• Manually append your or your team's developer key to the URL in your embed code (preceded by "&").

Your BioDigital Human user account is not associated with a valid subscription.

When a model embedded with a developer key is initialized, our services check to make sure the user account that owns the developer key is associated with a valid subscription, i.e., an active free trial or an active School or Business plan.

If your free trial or paid plan has expired, or you are not a member of your organization's paid plan, this validation step will fail and the model will fail to load.

If you need to be added to your organization's paid plan, ask your administrator to invite you to their team. If you still need help, contact us at developers@biodigital.com.

If your free trial has expired, contact our Sales team to request an extension.

If your paid plan has expired, reach out to your dedicated Account Manager or contact us at developers@biodigital.com.

Your developer key is not compatible with the platform into which you are embedding your model. 

When you first registered your app, you selected one of the following platforms:

• Viewer API
• iOS SDK
• Android SDK

1. Find out which platform is associated with your developer key (see step 2 in Where can I find my developer key and developer secret?)
2. If the platform is incorrect, you will have to register a new app to generate a new developer key. The platform for existing developer keys cannot be updated.
3. If the platform is correct, make sure you are embedding in the appropriate platform.

Our services are unable to verify your user credentials due to missing HTTP referrer data.

This means the application hosting your model is configured in a way that is preventing our Human Viewer code from accessing the webpage's document referrer, which is required for authentication.

See What do I do if my HTTP referrer is unavailable? for potential solutions.