ערוך

Get started with Azure Enclave

Use this article to onboard to Azure Enclave by registering the required resource providers and preparing the permissions needed to manage Azure Enclave resources in your subscription.

Prerequisites

  • You must already have an Azure tenant and subscription.
  • You must be an Owner of an existing Azure subscription.

Register the required resource providers and configure NetworkWatcherRG access

Option 1: PowerShell

PowerShell is the fastest way to register the required resource providers.

You can run the following code to quickly register all required resource providers to begin using Azure Enclave.

  1. Sign in to your Azure tenant and open the subscription.

  2. In the Azure portal, select the Cloud Shell icon at the top of the window.

    Screenshot showing the location of the Cloud Shell icon in the portal.

  3. Set the Azure context for your subscription. For example, run Set-AzContext -Subscription <subscription-id>.

  4. Copy and paste this code into Cloud Shell, and then press Enter.

# Register the Azure Enclave Resource Provider and grant permissions to the Resource Provider application

$resourceProviders = @(
   "Microsoft.Advisor",
   "Microsoft.AlertsManagement",
   "Microsoft.Authorization",
   "Microsoft.Automation",
   "Microsoft.Billing",
   "Microsoft.Capacity",
   "Microsoft.ChangeAnalysis",
   "Microsoft.ClassicSubscription",
   "Microsoft.CognitiveServices",
   "Microsoft.Compute",
   "Microsoft.Consumption",
   "Microsoft.CostManagement",
   "Microsoft.DesktopVirtualization",
   "Microsoft.Features",
   "Microsoft.GuestConfiguration",
   "Microsoft.Insights",
   "Microsoft.KeyVault",
   "Microsoft.Logic",
   "Microsoft.ManagedIdentity",
   "Microsoft.MarketplaceOrdering",
   "Microsoft.Network",
   "Microsoft.OperationalInsights",
   "Microsoft.OperationsManagement",
   "Microsoft.PolicyInsights",
   "Microsoft.Portal",
   "Microsoft.ResourceGraph",
   "Microsoft.ResourceHealth",
   "Microsoft.ResourceNotifications",
   "Microsoft.Resources",
   "Microsoft.Security",
   "Microsoft.SecurityInsights",
   "Microsoft.SerialConsole",
   "Microsoft.SqlVirtualMachine",
   "Microsoft.Storage",
   "Microsoft.Support",
   "Microsoft.Web",
   "Microsoft.Mission"
)

$resourceProviders | foreach {Register-AzResourceProvider -ProviderNamespace $_ -Verbose}

  1. (Optional) Enable the EncryptionAtHost feature

The EncryptionAtHost feature enables encryption at the compute host level.

# Register the feature
az feature register --namespace Microsoft.Compute --name EncryptionAtHost

# Check registration status (may take 10-15 minutes)
az feature show --namespace Microsoft.Compute --name EncryptionAtHost

# Once registered, refresh the provider
az provider register --namespace Microsoft.Compute
  1. After the update is complete, proceed to Azure setup or next steps.

Option 2: Azure portal

  1. Sign in to your Azure tenant and open the subscription.

  2. Under Settings, select Resource providers.

  3. Register the resource providers listed in Option 1: PowerShell in the subscription. The PowerShell script is the fastest option and the authoritative source for the required registrations. These images show the expected end state.

    Screenshot showing the first set of resource providers required by Azure Enclave.

    Screenshot showing the second set of resource providers required by Azure Enclave.

  4. Search for and select Microsoft.Mission, and then select Register.

    Screenshot showing the Microsoft.Mission resource provider registered successfully.

  5. Proceed to Azure setup or next steps.

For reference, you can also review the generic instructions for enabling a preview feature.

Configure NetworkWatcherRG access

To avoid potential problems with virtual network flow log creation, make sure the NetworkWatcherRG resource group exists in each subscription and that the Mission Enclave app has the Owner role on that group before you create your first enclave. If the subscription automatically creates the group and role, verify that they already exist.

  1. Select the NetworkWatcherRG resource group, select Access control (IAM), then select Add and Add role assignment.

    Screenshot showing role assignment selection in the NetworkWatcherRG resource group.

  2. Select Privileged administrator roles, select Owner, and then select Next.

    Screenshot showing Owner role selection in the role assignment wizard.

  3. Select Select members, type Mission Enclave in the search box, select the Mission Enclave app, and then select Select and Next.

    Screenshot showing Mission Enclave app selection in the members picker.

  4. If your subscription requires a condition, select Allow user to assign all roles except privileged administrator roles Owner, UAA, RBAC (Recommended), then select Review + assign.

    Screenshot showing role assignment selection condition when required by the subscription.

  5. Once the update is complete, you can start deploying Azure Enclave resources.

When a community or enclave is created, Azure Enclave attempts the following steps:

  1. Check if the NetworkWatcherRG exists. If not, attempt to create that resource group.
  2. Check if the Mission Enclave App has a permanent Owner assignment on NetworkWatcherRG. If not, attempt to assign the Mission Enclave App as a permanent Owner assignment on NetworkWatcherRG. Even if an inherited Owner permission exists, a permanent Owner assignment creation is attempted.
  3. If any step fails, enclave deployments might fail when attempting to create virtual network flow logs.

Transition steps for existing preview customers

Existing preview customers must re-register the Azure Enclave resource provider so their subscriptions can use the latest Azure Enclave API and service updates.

Complete these steps to use the latest Azure Enclave API:

  1. In the Azure portal, navigate to your subscription.
  2. Under Settings, select Resource providers.
  3. Search for and select Microsoft.Mission, and then select Re-register.
  4. Repeat these steps for any additional subscriptions.

Next steps

After registering the Azure Enclave resource provider, you can start deploying Azure Enclave resources into your subscription.