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.

    If login succeeds, you should see a message informing you whether an Azure Sphere tenant exists for this directory. If no tenant exists, create one.

  4. 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 'ABCDE082513B529C45098884F882B2CA6D832587CAAE1A90B1CEC4A376EA2F22A96C4E7E1FC4D2AFF5633B68DB68FF4420A5588B420851EE4F3F1A7DC51399ED' into tenant ID 'd343c263-4aa3-4558-adbb-d3fc34631800'.
    Successfully claimed device ID 'ABCDE082513B529C45098884F882B2CA6D832587CAAE1A90B1CEC4A376EA2F22A96C4E7E1FC4D2AFF5633B68DB68FF4420A5588B420851EE4F3F1A7DC51399ED' into tenant ID 'd343c263-4aa3-4558-adbb-d3fc34631800'.
    Command completed successfully in 00:00:05.5459143.
    

If azsphere returns an error, see Troubleshooting for help.

Next steps