Claim your device

Every device must be "claimed" by an Azure Sphere tenant. Claiming the device associates its unique, immutable device ID with your Azure Sphere tenant. The Azure Sphere Security Service uses the device ID to identify and authenticate the device.

We recommend that each company or organization create only one Azure Sphere tenant.

Important

Claiming is a one-time operation that you cannot undo even if the device is sold or transferred to another person or organization. A device can be claimed only once. Once claimed, the device is permanently associated with the Azure Sphere tenant.

Before you claim your device, complete these steps to ensure that you use the right work/school account to create and access your Azure Sphere tenant. Your device must be connected to your PC before you create the tenant, and you can only use the device to create a single tenant.

To claim your device:

  1. Connect your device to your PC.

  2. Open an Azure Sphere Developer Command Prompt, which is available in the Start menu under Azure Sphere.

  3. Sign in to Azure Sphere, using your work or school account:

    azsphere login

    If you have not yet logged in as this user, you will need to use the password that was auto-generated during sign-up and you will be prompted to change your password. You might also be prompted to obtain admin consent to use the Azure Sphere Utility.

  4. If login succeeds, the command returns a list of the Azure Sphere tenants that are available for you.

    • If you are the first in your organization to sign in, you will not see any tenants, and you'll need to create a tenant.
    • If multiple tenants exist, you'll need to select one. See azsphere tenant select for details.
    • If a single tenant is available, it will be selected by default, and you can proceed to the next step.

    The Azure Sphere Security Service currently enables all members of the organization to manage all devices in an Azure Sphere tenant. If you want greater control over access to your Azure Sphere devices, you or your IT administrator can limit access to your tenant.

  5. Claim your device. After you claim your device into a tenant, you cannot move it to a different tenant.

    azsphere device claim

    You should see output like this:

    Claiming device.
    Claiming attached device ID '<device ID>' into tenant ID 'd343c263-4aa3-4558-adbb-d3fc34631800'.
    Successfully claimed device ID '<device ID>' into tenant ID 'd343c263-4aa3-4558-adbb-d3fc34631800'.
    Command completed successfully in 00:00:05.5459143.
    

If azsphere returns an error, see Troubleshoot Installation for help.

Next steps