Migrate to an Azure resource authoring key

Language Understanding (LUIS) authoring authentication changed from an email account to an Azure resource.

Why migrate?

Using an Azure resource for authoring allows you, as the owner of the resource, to control access to authoring. You can create and name authoring resources to manage different groups of authors.

For example, if you have 2 types of LUIS apps you are authoring, with different members, you can create two different authoring resources and assign contributors. The Azure authoring resource controls the authorization.

Note

Before migration, co-authors are known as collaborators. After migration, the Azure role of contributor is used for the same functionality.

What is migrating?

Migration includes:

  • All users of LUIS, owners and contributors.
  • All apps.
  • A one-way migration.

The owner can't choose a subset of apps to migrate and the process isn't reversible.

The migration is not:

  • A process that collects collaborators and automatically moves or adds to the Azure authoring resource. You, as the app owner, need to complete this step. This step requires permissions to the appropriate resource.
  • A process to create and assign a prediction runtime resource. If you need a prediction runtime resource, that is a separate process and is unchanged.

How are the apps migrating?

The LUIS portal provides the migration process.

You will be asked to migrate if:

  • You have apps on the email authentication system for authoring.
  • And you are the app owner.

You can delay the migration process, by canceling out of the window. You are periodically asked to migrate until you migrate or the migration deadline is passed. You can start the migration process from the top navigation bar's lock icon.

Migration for the app owner

Before you migrate

  • Optionally, backup the apps from the LUIS portal's apps list by exporting each app or use the export API.
  • Optionally, save each app's collaborator's list. This email list is provided as part of the migration process.
  • Required, you need to have an Azure subscription. A part of the subscription process does require billing information. However, you can use the Free (F0) pricing tier when you use LUIS.

Authoring your LUIS app is free, indicated by the F0 tier. Learn more about pricing tiers.

If you do not have an Azure subscription, sign up.

Migration steps

Follow these migration steps.

After you migrate

After the migration process, all your LUIS apps are now assigned to a single LUIS authoring resource.

You can create more authoring resources and assign from the Manage -> Azure resources page in the LUIS portal.

You can add contributors to the authoring resource from the Azure portal, on the Access Control (IAM) page for that resource. See add contributor access for more information.

Portal Purpose
Azure * Create prediction and authoring resources.
* Assign contributors.
LUIS * Migrate to new authoring resources.
* Assign or unassign prediction and authoring resources to apps from Manage -> Azure resources page.

Migration for the app contributor

Every user of LUIS needs to migrate, including collaborators/contributors.

Before the app is migrated

You may choose to export an app you are a collaborator on, then import the app back into LUIS. The import process creates a new app with a new app ID, for which you are the owner.

After the app is migrated

The app owner needs to add your email to the Azure authoring resource as a collaborator.

After the migration process, any apps you own are available on the My apps page of the LUIS portal.

Troubleshooting

LUIS authoring keys are only visible in the LUIS portal after the migration process is complete. If you create the authoring keys, such as with the LUIS CLI, the user still needs to complete the migration process.

Next steps