Exercise - Declare the Azure IoT Central network endpoints

  • 5 minutes

In this exercise, you'll declare the Azure IoT Central network endpoints.

List your Azure IoT Central network endpoints

Follow these steps to list the network endpoints of your Azure IoT Central web application.

  1. Open the Command Prompt window.

  2. Go to the Azure Sphere samples folder in the Altair8800Emulator folder that you cloned to your computer.

    • For Windows: Go to the Samples\AzureIoT\Tools\win-x64 folder.

    • For Linux: Go to the Samples/AzureIoT/Tools/linux-x64 folder.

      You might need to explicitly set execution permissions for the ShowIoTCentralConfig tool. To do so, from a terminal, run chmod +x ShowIoTCentralConfig.

  3. Run the ShowIoTCentralConfig tool, and then follow the prompts, as shown in the following table:

    Note

    Your organization might require consent for the ShowIoTCentralConfig tool to access your Azure IoT Central data in the same way that the Azure API requires such consent.

    Prompt Response
    Are you using a legacy (2018) IoT Central application? (Y/N) Respond N.
    IoT Central App URL The URL can be found in your browser address bar (for example, https://apps.azureiotcentral.com).
    API token The token can be generated from your Azure IoT Central app.
    1. Select Administration > API Tokens > Generate Token.
    2. Provide a name for the token (for example, "AzureSphere").
    3. Select Administrator as the role, and then select Generate.
    4. Copy the token to the clipboard. The token starts with SharedAccessSignature.
    ID Scope In the Azure IoT Central application, select Administration > Device Connection, and then copy the ID Scope.

  4. Review the output from the ShowIoTCentralConfig tool. It will look similar to the following JSON text:

    "CmdArgs": [ "--ScopeID", "0ne0099999D" ],
"Capabilities": {
   "AllowedConnections": [ "global.azure-devices-provisioning.net", "iotc-9999bc-3305-99ba-885e-6573fc4cf701.azure-devices.net", "iotc-789999fa-8306-4994-b70a-399c46501044.azure-devices.net", "iotc-7a099966-a8c1-4f33-b803-bf29998713787.azure-devices.net", "iotc-97299997-05ab-4988-8142-e299995acdb7.azure-devices.net", "iotc-d099995-7fec-460c-b717-e99999bf4551.azure-devices.net", "iotc-789999dd-3bf5-49d7-9e12-f6999991df8c.azure-devices.net", "iotc-29999917-7344-49e4-9344-5e0cc9999d9b.azure-devices.net", "iotc-99999e59-df2a-41d8-bacd-ebb9999143ab.azure-devices.net", "iotc-c0a9999b-d256-4aaf-aa06-e90e999902b3.azure-devices.net", "iotc-f9199991-ceb1-4f38-9f1c-13199992570e.azure-devices.net" ],
   "DeviceAuthentication": "--- YOUR AZURE SPHERE TENANT ID---",
}

  5. Copy the output from the ShowIoTCentralConfig tool to Notepad, because you'll use this information in a later unit.