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.

In order to not overwhelm the logs with repetitive messages, deprecation notes will only be shown once per hour (the first time it occurs within that hour) rather than for each authentication transaction involving the deprecated feature.

Navigate to the Logs screen in the Dashboard. Search for deprecation related messages by entering type:depnote in the query box.

Dashboard - Logs

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:

Dashboard - Logs

Dashboard - Logs

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.

Management API - Token Setup

On the left, navigate to Logs > Search log events and then scroll down to Parameters.

Management API - Logs

In the q field enter: type:"depnote"

Click on the TRY button. If successful, you should see a screen similar to the one below.

Management API - Logs - Results

  • 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 Messages

up-idp-initiated

Management API - Legacy Lock Results

Error Description: "Legacy Lock API: This feature is being deprecated. Please refer to our documentation to learn how to migrate your application."

Cause Resolution
You are using a legacy version of embedded Lock or Auth0.js SDK. Migrate to Universal Login if possible or upgrade to Lock v11 / Auth0.js v9 (Reference guide for Lock v11 and for Auth0.js v9).
Calling /login endpoint directly. Migrate to use a form of the /authorize endpoint as the start of authentication transactions.
Users bookmarking the login URL and trying to initiate login from that bookmarked link at a later time. Educate users to bookmark instead the place in your app to which they want to return (such as the home page). Depending on your design choices, and if there's no valid session for the user in the app, the app will either start the authorization process or show a login button.
Users hitting the back button in the middle of a login transaction. Educate users to start the login transaction again, starting from the initial login button/link, rather than using the back or forward button.
Calling the /usernamepassword/login endpoint directly. Use the Lock or Auth0.js libraries instead.

ssodata

Management API - getSSOData Results

Error Description: "SSOdata endpoint: This feature is being deprecated. Please refer to our documentation to learn how to migrate your application."

Cause Resolution
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.