Deprecation Error Reference
When Auth0 features are deprecated, there may be errors or notices in the tenant logs that show up to indicate that your applications are using the deprecated features. This guide will provide assistance with searching your logs for deprecation related messages as well as explanations of potential causes and resolutions for particular items.
How to search logs for deprecation warnings
There are two different ways to search for warning messages showing usage of deprecated features: The Dashboard or the Management API. Note that in either case, the log retention period is governed by the subscription level of your account.
Search logs via the Dashboard
If your application uses a deprecated feature, a Deprecation Notice message will show up in the Logs section of the Dashboard.
Navigate to the Logs screen in the Dashboard. Search for deprecation related messages by entering
type:depnote in the query box.
A list of deprecation related warning messages from your logs will be shown, if any exist.
The Description field provides information on the particular deprecated feature used. Clicking on the link in the Event column for each item will show additional information such as the client id which identifies the client application using the deprecated feature.
Clicking each item and selecting Context Data will give you details about the item:
Search logs via the Management API
Customers can also use the Management API to search through logs for such messages by looking for "Type" = "depnote".
To check your logs using the Management API, go to the Management API.
If you have not already done so, get and set up your API token in the API explorer.
On the left, navigate to Logs > Search log events and then scroll down to Parameters.
In the q field enter:
Click on the TRY button. If successful, you should see a screen similar to the one below.
- The results will match one of the messages + descriptions below.
- The Client ID field in the results will indicate which application (client) on your tenant is using the deprecated feature.
Deprecation Log Messages
Error Description: "Legacy Lock API: This feature is being deprecated. Please refer to our documentation to learn how to migrate your application."
|You are using a legacy version of embedded Lock or Auth0.js SDK.||Migrate away from the deprecated library versions as soon as possible.|
|Calling the /usernamepassword/login endpoint directly.||Use the Lock or Auth0.js libraries instead.|
|Automatic monitoring tools making requests to login page||If you have an automatic monitoring tool making requests to the login page, the tool will likely not preserve state correctly and will cause the Legacy Lock API error to occur in your logs. Use of the tool should either be discontinued, or accounted for when considering causes of the log notices.|
|Coding errors in a customized Universal Login Page||Make sure the
Error Description: "SSOdata endpoint: This feature is being deprecated. Please refer to our documentation to learn how to migrate your application."
|Either calling the /ssodata directly or using old versions of embedded Lock or Auth0.js SDK to call a function which called the /ssodata endpoint.||Migrate to Universal Login or migrate to Lock v11 or Auth0.js v9.|
Legacy Lock API notice
If you see the warning panel
Your tenant has the Legacy Lock API enabled. Please follow our Deprecation Guide then disable the Legacy Lock API in your advanced settings. The Legacy Lock API will be removed on July 16th, 2018 and your applications will no longer work if you have not fully migrated. when you login to the Dashboard, it is because you have not turned off the Legacy Lock API switch in your advanced settings. If you are unaffected by the migration, or have completed it, you should be able to turn that setting off and remove the warning.
If you are unsure if you are safely migrated yet, you can follow the Deprecation Guide to be sure.