View on GitHub

iot-identity-service

Source of the Azure IoT Identity Service and related services.

Installing the Azure IoT Identity Service

The Azure IoT Identity Service can be installed on your device by installing the appropriate aziot-identity-service. Packages are provided for the following distributions and architectures with each release of Azure IoT Edge as of v1.2:

OS Architectures
Debian 9, Raspbian 9 amd64, arm32v7, aarch64
Debian 10, Raspbian 10 amd64, arm32v7, aarch64
Ubuntu 18.04 amd64, arm32v7, aarch64
Ubuntu 20.04 amd64, arm32v7, aarch64
CentOS 7 amd64

Packages for some of these distros are available on packages.microsoft.com.

Install from packages.microsoft.com

Applies to: Ubuntu 18.04, Raspberry Pi OS Stretch

sudo apt install aziot-identity-service

You may need to first add the packages.microsoft.com to your repo sources.

  1. Install the Microsoft GPG public key

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/
    
  2. On Ubuntu 18.04

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list
    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/
    
  3. On Raspberry Pi OS Stretch

    curl https://packages.microsoft.com/config/debian/stretch/multiarch/prod.list > ./microsoft-prod.list
    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/
    

Install for an alternative distro / architecture

Download and install the aziot-identity-service pre-built package for your respective distro / architecture from the IoT Edge release collateral for v1.2 or later.

Using Ubuntu 20.04 amd64 as an example:

wget https://github.com/Azure/azure-iotedge/releases/download/1.2.0/aziot-identity-service_1.2.0-1_ubuntu20.04_amd64.deb -o aziot-identity-service.deb

sudo apt install ./aziot-identity-service.deb

Note

By design the package conflicts with the iotedge and libiothsm-std packages of IoT Edge v1.1 and earlier. If you're using apt to install the package it will prompt to remove the conflicting packages. Otherwise, be sure to manually remove them before installing the Identity Service.