Bağlayıcıyı MQTT için yapılandırma

MQTT için bağlayıcıyı kullanarak MQTT uç noktalarını Azure IoT İşlemleri varlık olarak modelleyebilirsiniz. Bu MQTT uç noktaları, dış MQTT aracılarında veya Azure IoT İşlemleri yerleşik MQTT aracısında olabilir. MQTT bağlayıcısı, yeni konu yollarını göründükleri gibi algılar ve algılanan konuları temsil eden özel kaynakları görüntüleyebilirsiniz.

Azure IoT İşlemleri asset, fiziksel bir varlığı veya cihazı temsil etmek için oluşturduğunuz mantıksal bir varlıktır. bir Azure IoT İşlemleri varlığı, davranışını ve özelliklerini açıklayan özel özelliklere, veri noktalarına, akışlara ve olaylara sahip olabilir. Bir varlık bir veya daha fazla cihazla ilişkilendirilir. Azure IoT İşlemleri varlık tanımlarını Azure Cihaz Kayıt Defteri'nde depolar.

Azure IoT İşlemleri device, fiziksel varlıklara veya cihazlara bağlantıları tanımlayan mantıksal bir varlıktır. Cihaz olmadan veriler fiziksel bir cihazdan veya varlıktan MQTT aracısına akamaz. Bir cihaz ve varlık yapılandırdığınızda, fiziksel varlık veya cihazla bağlantı kurulur ve veri noktası değerleri, olaylar ve akışlar Azure IoT İşlemleri örneğe ulaşır. Bir cihazın bir veya daha fazla gelen uç noktası vardır. Azure IoT İşlemleri cihaz tanımlarını Azure Cihaz Kayıt Defteri'nde depolar.

Aşağıdaki tabloda, MQTT bağlayıcısının desteklediği özellikler özetlenmiştir:

Özellik	Destekleniyor	Notes
Kullanıcı adı/parola kimlik doğrulaması	Yes	Temel HTTP kimlik doğrulaması
X.509 kullanıcı sertifikaları (mTLS)	Yes	İstemci kimlik doğrulaması ve yetkilendirme sertifikaları
Anonim erişim	Yes	Test amacıyla
Güney yönlü sertifika güven listesi	Yes	Gelen uç nokta ile güvenli iletişim için MQTTS
OpenTelemetry entegrasyonu	Yes
WASM veri dönüşümü	Yes	İsteğe bağlı olarak WebAssembly modüllerini kullanarak gelen verileri dönüştürme
Şema oluşturma	Yes	Çıkarsanan şemayı şema kayıt defterine kaydeder
Sağlık durumu raporları	Yes	İşlem deneyiminde ve Azure portalında varlıkların ve uç noktaların sistem durumunu bildirme

MQTT için bağlayıcı:

Belirli bir konu yolu veya MQTT joker karakter yolu altında görünen yeni konuları algılar ve Akri ile iletişim kurar.
Akri, OT onayı için hazır discovered asset özel kaynağını oluşturur ve Azure Cihaz Kayıt Defteri'ne aktarır.
Onaylı varlıklar için MQTT bağlayıcısı konulara abone olup verileri belirttiğiniz birleşik ad alanı konularına iletir.

Önemli

MQTT bağlayıcısı içeri aktarılan bir varlığa yeni veri kümeleri eklemeyi, el ile varlık oluşturmayı veya veri kümesinin dataSource alan değerini değiştirmeyi desteklemez.

Bu makalede, aşağıdaki gibi görevleri gerçekleştirmek üzere MQTT için bağlayıcının nasıl kullanılacağı açıklanmaktadır:

MQTT uç noktalarını Azure IoT İşlemleri örneğine bağlayan cihazları tanımlayın.
Bulunan varlıkları içeri aktarın ve MQTT kaynağından MQTT aracısına veri akışını etkinleştirmek için veri noktalarını tanımlayın.
MQTT konularına ileti yayımlayarak MQTT kaynağına komut göndermenize olanak sağlayan yönetim eylemlerini yapılandırın.
WebAssembly (WASM) modüllerini kullanarak veri dönüşümlerini yapılandırın.

Önkoşullar

Bu makaledeki Azure CLI örnek, her değeri bir kez ayarlayabilmeniz ve ardından komutları kopyalayıp yapıştırmanız için ortam değişkenlerini kullanır as-is. Azure IoT İşlemleri Codespaces ortamını quickstart'tan kullanıyorsanız, bu değişkenler zaten sizin için ayarlanmıştır ve bu adımı atlayabilirsiniz. Aksi takdirde, komutları çalıştırmadan önce shell'inizde aşağıdaki ortam değişkenlerini ayarlayın.

Aşağıdaki betikler en sık kullanılan ortam değişkenlerini ayarlar:

Ortam değişkeni	Açıklama
`SUBSCRIPTION_ID`	Azure IoT İşlemleri örneğini içeren aboneliğin kimliği.
`RESOURCE_GROUP`	Azure IoT İşlemleri örneğini içeren kaynak grubunun adı.
`AIO_INSTANCE_NAME`	Azure IoT İşlemleri örneğinizin adı. Örneklerinizi listelemek için çalıştırın `az iot ops list -o table`.
`CLUSTER_NAME`	Örneğinizi barındıran Azure Arc özellikli Kubernetes kümesinin adı.
`LOCATION`	Yeni kaynaklar için kullanılacak Azure bölgesi, örneğin `eastus`.

Bash
PowerShell

SUBSCRIPTION_ID=<subscription-id>
RESOURCE_GROUP=<resource-group-name>
AIO_INSTANCE_NAME=<instance-name>
CLUSTER_NAME=<cluster-name>
LOCATION=<region>

$SUBSCRIPTION_ID = "<subscription-id>"
$RESOURCE_GROUP = "<resource-group-name>"
$AIO_INSTANCE_NAME = "<instance-name>"
$CLUSTER_NAME = "<cluster-name>"
$LOCATION = "<region>"

Sadece bu makalenin kullandığı değişkenleri ayarlamanız yeterlidir. Bu makale, seçtiğiniz kaynak adları için ek ortam değişkenleri kullanabilir. Makale, tanıtıldıkları yere nasıl yerleştirileceğini açıklıyor.

Kaynak eşitleme kurallarının etkinleştirildiği dağıtılmış bir Azure IoT İşlemleri örneği. Kaynak eşitleme kurallarını etkinleştirmek için Azure IoT İşlemleri örneğinizde aşağıdaki komutu çalıştırın. Bu komut ayrıca özel konumda gerekli izinleri ayarlar:

az iot ops enable-rsync -n $AIO_INSTANCE_NAME -g $RESOURCE_GROUP

İşlemler deneyimi web arayüzüne oturum açmak için, Kubernetes - Azure Arc örneğinizi içeren kaynak grubu için en az katkıda bulunan izinlerine sahip bir Microsoft Entra ID hesabınız olmalıdır. Microsoft hesabı (MSA) ile oturum açamazsınız. Daha fazla bilgi için Operasyon deneyimi web kullanıcı arabirimine erişim sorunlarını giderme bölümüne bakın.

BT yöneticinizin Azure portalında Azure IoT İşlemleri örneğinin MQTT şablonu için bağlayıcıyı yapılandırması gerekir.

MQTT kaynağına erişmek için kimlik bilgilerine ihtiyacınız vardır. MQTT kaynağı kimlik doğrulaması gerektiriyorsa, MQTT kaynağının kullanıcı adını ve parolasını içeren bir Kubernetes gizli dizisi oluşturmanız gerekir.

MQTT bağlayıcısı şablon örneği

Ot kullanıcısının MQTT için bağlayıcıyı kullanan bir cihaz oluşturabilmesi için bt yöneticisinin Azure IoT İşlemleri örneğinize bir MQTT bağlayıcısı şablon örneği eklemesi gerekir. Daha fazla bilgi edinmek için bkz. Bağlayıcı şablonu örneklerini oluşturma ve yönetme.

Bağlayıcı için sertifika güven listesi yapılandırma

Her bağlayıcının kendi güven listesi vardır: bağlayıcı güvenli bir bağlantı kurduğunda güneye giden uç noktanın sunduğu TLS sertifikasını doğrulamak için bağlayıcının kullandığı sertifika kümesi. Güneye giden uç nokta özel veya kurumsal sertifika yetkilisi (CA) tarafından imzalanan bir TLS sertifikası veya bağlayıcının henüz güvenmediği otomatik olarak imzalanan bir sertifika kullandığında güven listesine bir sertifika ekleyin. Bağlayıcının karşılıklı TLS için güneye giden uç noktaya sunduğu istemci sertifikaları, cihazın kullanıcı kimlik doğrulamasının bir parçası olarak ayrı olarak yapılandırılır.

Uyarı

OPC UA bağlayıcısı için güven listesi, OPC UA uygulama örneği sertifikalarını da işler. Daha fazla bilgi edinmek için bkz. OPC UA sertifika altyapısını anlama.

Bağlayıcının güven listesine iki yolla sertifika ekleyebilirsiniz:

İşlem deneyimi. İşlemler deneyimi web kullanıcı arayüzünde, ister bir sertifika dosyasını doğrudan karşıya yükleyebilir ister Azure Key Vault’tan mevcut bir gizli anahtar seçebilirsiniz. İşlemler deneyimi, sertifikayı Azure Key Vault’a gizli dizi olarak ekler (gerekirse), küme üzerinde eşitlenen gizli dizi kaynağını oluşturur ve sizin için bunu bağlayıcının güven listesine ekler. Daha fazla bilgi edinmek için bkz. Dış iletişim için sertifikaları yönetme.
Azure CLI. Azure CLI akışı, sertifikanın Azure Key Vault'da gizli dizi olarak depolandığını varsayar. kümede Key Vault gizli diziye başvuran eşitlenmiş bir gizli dizi oluşturmak için az iot ops secretsync secret set ve ardından bağlayıcı şablonunun güven listesinde eşitlenen gizli diziye başvuru eklemek için az iot ops connector template update kullanırsınız. Daha fazla bilgi edinmek için bkz. Sertifika ekleme ve kullanma. Azure Key Vault’a nasıl sertifika ekleneceğini öğrenmek için bkz. Sertifikaları Azure Key Vault’a gizli diziler olarak ekleme.

İşlem deneyimi ve Azure CLI akışları kısmen çakışıyor. İşlem deneyimi, Azure Key Vault için yeni bir sertifika yükleyebilir ve bunu tek bir deneyimde kümeyle eşitleyebilir. Azure CLI akışı sertifikanın zaten Azure Key Vault olduğunu varsayar ve yalnızca eşitleme ve güven listesi kablolarını işler.

Cihaz oluşturma

Bağlayıcıyı MQTT için yapılandırmak için önce abone olunacak MQTT konusuna bağlantıyı tanımlayan bir cihaz oluşturun. Cihaz, MQTT konusunun adresini ve erişmek için ihtiyacınız olan tüm kimlik bilgilerini içerir. Gelen uç noktayı Azure IoT İşlemleri'ndeki yerleşik MQTT aracısına veya bir dış MQTT aracısına bağlanacak şekilde yapılandırabilirsiniz.

External MQTT aracısı: Azure IoT İşlemleri örneğinizdeki yerleşik MQTT aracısı dışında bir MQTT aracısına bağlanırken bu seçeneği kullanın. Sunucu URL'sini belirtilen biçimde ve gerekli kimlik doğrulama bilgileriyle sağlamanız gerekir.
Built-in MQTT aracısı: Azure IoT İşlemleri örneğinizin parçası olan yerleşik MQTT aracısında konu başlıklarına abone olmak istediğinizde bu seçeneği kullanın. Bu seçenek, yerleşik broker ile sistemin diğer bölümleri arasında verileri varlık modeli aracılığıyla yönlendirerek köprü oluşturmada kullanışlıdır.

Bağlayıcı ayrıca bir konu filtresine dayalı olarak MQTT konularından varlıkları bulur ve verileri konu eşleme ön eki tarafından tanımlanan birleşik bir ad alanı yoluna iletir:

Konu filtresi, bağlayıcının hangi konulara abone olduğunu belirtir. Filtre, tek düzeyli joker karakter (+) destekler. Bağlayıcı, bir konudaki mesaj joker karakter konumundaki filtreyle eşleştiğinde her defasında yeni bir varlık algılar. Örneğin, filtre A/B/+ ve A/B/asset1 öğesini ayrı varlıklar olarak algılarA/B/asset2. Konu filtreleri çok seviyeli joker kartı (#) veya sistem konularını (konular ile $SYS/başlayan) desteklemez.
Konu eşleme ön eki, gelen konuyu birleşik bir ad alanı yolu ile eşler. Örneğin, ön ek X/Y ve gelen konu A/B/asset1 ise bağlayıcı verileri X/Y/A/B/asset1 iletir.

Önemli

Cihazı oluşturmadan önce konu filtresini dikkatlice tasarlayın. Cihazı oluşturduktan sonra, varlık keşfi yapılandırmasını değiştiremezsiniz, ancak cihazı silip yeniden oluşturabilirsiniz. Bağlayıcı, konu filtresiyle eşleşmeyen konulara gönderilen mesajları sessizce görmezden gelir ve onlardan keşfedilen varlıklar oluşturmaz.

İşlem deneyimi web kullanıcı arabiriminde sol gezinti bölmesinde Cihazlar'ı seçin. Ardından Yeni oluştur'u seçin.
Cihazınız için gibi mqtt-connectorbir ad girin. MQTT bağlayıcısının gelen uç noktasını eklemek için Microsoft.Mqtt kutucuğunda New öğesini seçin.
Temel sayfasında uç nokta ayrıntılarını ekleyin:
- Dış MQTT aracısı: Bir uç nokta adı, sunucu URL'si ve gerekli kimlik doğrulama bilgilerini ekleyin.
- Yerleşik MQTT aracısı: Uç nokta mqtt://aio-broker:18883 için sunucu URL'si olarak bir ad ve kimlik doğrulaması kimlik bilgileri için Anonim ekleyin.
  
  Tavsiye
  
  Yerleşik MQTT aracı yapılandırması kimlik doğrulama değerleri gerektirmez ve bilinen bir URL'ye sahiptir. Girdiğiniz değerler yoksayılır.

Gelişmiş sayfasında, konu keşfi ve aracı bağlantısı ayarlarını yapılandırın:

Konu filtresi ve Konu eşleme ön eki değerlerini ekleyin.
Yerleşik MQTT aracısını kullanıyorsanız Yerleşik mqtt aracısı kullan ayarını etkinleştirin. Harici aracı yapılandırma ayarlarını göz ardı edin.

Bir dış MQTT aracısına bağlanıyorsanız, isteğe bağlı olarak aşağıdaki ayarları yapılandırın:

Setting	Türü	Varsayılan	Açıklama
`keepAlive`	tamsayı	60	MQTT bağlantısı için saniye cinsinden bağlantıyı etkin tutma aralığı.
`receiveMax`	tamsayı	65535	İstemcinin eşzamanlı olarak işlemek istediği maksimum hizmet içi QoS 1 ve QoS 2 yayımlama sayısı.
`receivePacketSizeMax`	tamsayı	Hiçbiri	İstemcinin kabul edilen bayt cinsinden en büyük paket boyutu.
`sessionExpiry`	tamsayı	3600	Oturumun süresi saniye cinsinden sona eriyor.
`connectionTimeout`	tamsayı	30	MQTT bağlantısı için saniye cinsinden bağlantı zaman aşımı.

Uç noktayı kaydetmek için Uygula'yı seçin.
Devam etmek için Cihaz ayrıntıları sayfasında İleri'yi seçin.
Özel özellik ekle sayfasında, cihazla ilişkilendirmek istediğiniz diğer özellikleri ekleyin. Örneğin, cihazın üreticisini belirtmek için bir özellik ekleyebilirsiniz. Ardından devam etmek için Sonraki seçin.
Özet sayfasında, cihazın ayrıntılarını gözden geçirin ve oluştur'u seçerek varlığı oluşturun.
Cihaz oluşturulduktan sonra Cihazlar listesinde görüntüleyebilirsiniz:

Bir dış MQTT aracısına bağlanmak için aşağıdaki komutları çalıştırın. Konu filtresi ve konu eşleme ön eki değerlerini senaryonuzla eşleşecek şekilde değiştirin:

az iot ops ns device create \
  -n mqtt-connector-cli \
  -g {your resource group name} \
  --instance {your instance name}

az iot ops ns device endpoint inbound add mqtt \
  --device mqtt-connector-cli \
  -g {your resource group name} \
  -i {your instance name} \
  --name mqtt-connector-0 \
  --endpoint-address "mqtt://my-broker:1883" \
  --topic-filter "A/B/+" \
  --topic-mapping-prefix "X/Y"

Yerleşik MQTT aracısına bağlanmak için uç nokta adresi olarak kullanın aio-broker:18883 :

az iot ops ns device endpoint inbound add mqtt \
  --device mqtt-connector-cli \
  -g {your resource group name} \
  -i {your instance name} \
  --name mqtt-connector-0 \
  --endpoint-address "aio-broker:18883" \
  --topic-filter "A/B/+" \
  --topic-mapping-prefix "X/Y"

Daha fazla bilgi edinmek için bkz. az iot ops ns device.

MQTT bağlayıcısı için gelen uç noktasına sahip bir cihaz oluşturmak için aşağıdaki Bicep şablonunu dağıtın. <AIO_NAMESPACE_NAME> ve <CUSTOM_LOCATION_NAME> yer tutucularını sırasıyla Azure IoT İşlemleri ad alanı adınız ve özel konum adınızla değiştirin. Uç nokta adresini, konu filtresini ve konu eşleme ön ekini senaryonuza uyacak şekilde ayarlayın:

param adrNamespaceName string = '<AIO_NAMESPACE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'

resource adrNamespace 'Microsoft.DeviceRegistry/namespaces@2026-04-01' existing = {
  name: adrNamespaceName
}

resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}

resource device 'Microsoft.DeviceRegistry/namespaces/devices@2026-04-01' = {
  name: 'mqtt-connector'
  parent: adrNamespace
  location: resourceGroup().location
  extendedLocation: {
    type: 'CustomLocation'
    name: customLocation.id
  }
  properties: {
    endpoints: {
      outbound: {
        assigned: {}
      }
      inbound: {
        'mqtt-connector-0': {
          endpointType: 'Microsoft.Mqtt'
          address: 'mqtt://my-broker:1883'
          additionalConfiguration: string({
            topicFilter: 'A/B/+'
            topicMappingPrefix: 'X/Y'
          })
        }
      }
    }
  }
}

Yerleşik MQTT aracısına bağlanmak için aio-broker:18883 değeri olarak address kullanın.

Bu yapılandırma, kümeye device adlı bir mqtt-connector kaynağı ve mqtt-connector-0 adlı bir gelen uç noktası dağıtır.

Bir cihazı kullanıcı adı ve parola kullanacak şekilde yapılandırma

Önceki örnekte kimlik doğrulama modu kullanılır Anonymous . Bu mod kullanıcı adı veya parola gerektirmez.

Kimlik doğrulama modunu kullanmak Username password için aşağıdaki adımları tamamlayın:

İşlem deneyiminde, gelen uç noktayı ekleyip Kullanıcı adı parolası kimlik doğrulama modunu seçtiğinizde, kullanıcı adı ve parola için gizli dizi başvurularını eklemek için Başvuru ekle'yi seçin. İşlem deneyimi iki seçenek sunar:

Yeni bir gizli anahtar oluşturun: değeri Azure Key Vault’a yükler ve kümeyle senkronize edilmiş bir gizli anahtar olarak eşitler.
Azure Key Vault'tan ekle: mevcut bir Key Vault gizli anahtarını kümeyle eşitler.

İşlem deneyimi hem kullanıcı adı hem de parola başvurularını kümedeki tek bir eşitlenmiş gizli dizi kaynağına kaydeder ve eşitlenen gizli diziye bir ad verirsiniz.

Daha fazla bilgi için bkz: Gizli anahtarlar ekleme ve kullanma.

Kullanıcı adı ve parolanın Azure Key Vault gizli dizi olarak depolandığından emin olun. Daha fazla bilgi için bkz. Azure Key Vault'a gizli diziler ekleme.
Kümede, her iki Key Vault gizlisine de atıfta bulunan tek bir eşitlenmiş gizli oluşturun. Aşağıdaki örnek, my-endpoint-creds adlı eşitlenmiş bir gizli oluşturur ve Key Vault sırları my-kv-username ile my-kv-password öğelerini username ve password anahtarlarına eşler:
```
az iot ops secretsync secret set \
  --instance <your-instance-name> \
  --resource-group <your-resource-group> \
  --name my-endpoint-creds \
  --secret target=username source=my-kv-username \
  --secret target=password source=my-kv-password
```
Daha fazla bilgi için bkz. az iot ops secretsync secret set.
Kullanıcı adı ve parola için eşitlenen gizli anahtarın adına ve anahtarına atıfta bulunmak üzere ve --user-ref parametreleriyle --pass-ref komutunu kullanın (örneğin, my-endpoint-creds/username ve my-endpoint-creds/password).

Uyarı

Bu Azure CLI akışı, işlem deneyimiyle kısmen çakışıyor. İşlem deneyimi aynı adımın bir parçası olarak gizli diziyi Azure Key Vault'a da yükleyebilirken, Azure CLI akışı gizli dizinin Azure Key Vault zaten var olduğunu varsayar.

Kullanıcı adı ve parolanın Azure Key Vault'ta gizli diziler olarak depolandığından ve kümedeki eşitlenen bir gizli dizinin iki Key Vault gizli dizisinin de başvurusunu içerdiğinden emin olun. Eşitlenmiş gizli diziyi işlem deneyimi aracılığıyla veya Azure CLI kullanarak oluşturabilirsiniz. Daha fazla bilgi edinmek için bkz. Azure IoT İşlemleri dağıtımınız için gizli bilgileri yönetme.
Bağlayıcı için olan Bicep yapılandırmanızdaki authentication bloğunu, kümedeki eşitlenmiş gizliye başvuracak şekilde değiştirin. usernameSecretName ve passwordSecretName değerleri şu formu <synced-secret-name>/<key>kullanır:
```
authentication: {
    method: 'UsernamePassword'
        usernamePasswordCredentials: {
            usernameSecretName: 'my-endpoint-creds/username'
            passwordSecretName: 'my-endpoint-creds/password'
        }
}
```

Uyarı

Eşitlenen gizli diziyi oluşturmaya yönelik Azure CLI akışı, işlem deneyimiyle kısmen çakışıyor. İşlem deneyimi aynı adımın bir parçası olarak gizli diziyi Azure Key Vault'a da yükleyebilirken, Azure CLI akışı gizli dizinin Azure Key Vault zaten var olduğunu varsayar.

Cihazı X.509 sertifikası kullanacak şekilde yapılandırma

İşlem deneyiminde, gelen uç noktayı ekleyip X509 sertifika kimlik doğrulama modunu seçtiğinizde, istemci sertifikası ve özel anahtar için gizli dizi başvuruyu eklemek için Başvuru ekle'yi seçin. İşlem deneyimi iki seçenek sunar:

Yeni bir gizli dizi oluşturun: sertifika ve özel anahtar dosyalarını Azure Key Vault yükler ve bunları eşitlenmiş gizli dizi olarak kümeyle eşitler.
Azure Key Vault'tan ekle: mevcut Key Vault gizli anahtarlarının kümeyle eşitlenmesini sağlar.

İşlem deneyiminde, sertifika ve anahtar başvuruları kümedeki tek bir senkronize edilmiş gizli kaynakta kaydedilir ve bu senkronize edilmiş gizli kaynağa bir ad verirsiniz.

Daha fazla bilgi edinmek için bkz. Karşılıklı TLS için istemci sertifikasını ve özel anahtarı eşitleme.

İstemci sertifikasını ve özel anahtarı Azure Key Vault'ta gizli olarak sakladığınızdan emin olun. Daha fazla bilgi edinmek için bkz. Karşılıklı TLS için istemci sertifikasını ve özel anahtarı eşitleme.
Kümede, her iki Key Vault gizlisine de atıfta bulunan tek bir eşitlenmiş gizli oluşturun. Aşağıdaki örnek, my-endpoint-cert adlı eşitlenmiş bir gizli oluşturur ve Key Vault sırları my-kv-client-cert ile my-kv-client-key öğelerini certificate ve privateKey anahtarlarına eşler:
```
az iot ops secretsync secret set \
  --instance <your-instance-name> \
  --resource-group <your-resource-group> \
  --name my-endpoint-cert \
  --secret target=certificate source=my-kv-client-cert \
  --secret target=privateKey source=my-kv-client-key
```
Daha fazla bilgi için bkz. az iot ops secretsync secret set.
Sertifika ve özel anahtar için eşitlenen gizli ad ve anahtara başvurmak üzere (örneğin, ve --cert-ref), --key-ref ve my-endpoint-cert/certificate parametreleriyle birlikte my-endpoint-cert/privateKey komutunu kullanın.

Uyarı

Bu Azure CLI akışı, işlem deneyimiyle kısmen çakışıyor. İşlem deneyimi aynı adımın bir parçası olarak sertifikayı ve özel anahtarı da Azure Key Vault yükleyebilirken, Azure CLI akışı gizli dizilerin Azure Key Vault zaten var olduğunu varsayar.

İstemci sertifikası ile özel anahtarın Azure Key Vault’ta gizli dizi olarak depolandığından ve kümedeki eşitlenmiş bir gizli dizinin her iki Key Vault gizli dizisine de başvurduğundan emin olun. Eşitlenmiş gizli diziyi işlem deneyimi aracılığıyla veya Azure CLI kullanarak oluşturabilirsiniz. Daha fazla bilgi edinmek için bkz. Karşılıklı TLS için istemci sertifikasını ve özel anahtarı eşitleme.
Cihaz gelen uç noktası için Bicep yapılandırmanızdaki authentication bloğunu, kümedeki eşitlenen gizli diziye başvuracak şekilde değiştirin. certificateSecretName ve keySecretName değerleri şu formu <synced-secret-name>/<key>kullanır:
```
authentication: {
    method: 'Certificate'
        x509Credentials: {
            certificateSecretName: 'my-endpoint-cert/certificate'
            keySecretName: 'my-endpoint-cert/privateKey'
        }
}
```

Uyarı

Bağlayıcı şu anda dış MQTT aracılarına bağlandığında ara sertifikaları desteklememektedir.

Varlıkları bulma ve oluşturma

Bir cihazın varlık bulma yapılandırmasındaki konu filtresiyle eşleşen bir konuya ileti gönderdiğinizde, MQTT bağlayıcısı yeni konuyu algılar ve algılanan bir varlık özel kaynağı oluşturur. Örneğin, konu filtresini olarak A/B/+belirtir ve konusuna A/B/asset1bir ileti gönderirseniz, MQTT bağlayıcısı yeni konuyu algılar ve işlem deneyimi web kullanıcı arabiriminde görüntüleyebileceğiniz bulunan bir varlık oluşturur:

Keşfedilen varlıktan bir varlık oluşturmak için şu adımları izleyin:

Operasyon deneyiminde, listeden keşfedilen varlığı seçin, ardından İçe aktar ve varlık oluştur.
Varlık ayrıntıları sayfasında, gelen uç nokta cihazdan zaten seçilidir. Varlıkla ilişkilendirmek istediğiniz bir ad, açıklama ve özel özellikler ekleyin. Ardından devam etmek için Sonraki seçin.
Veri setleri sayfasında, bağlantıcının konu filtresi ve varlık adı kullanarak keşfedilen varlıktan otomatik olarak oluşturduğu bir veri seti görürsünüz:

Devam etmek için İleri'yi seçin.
Gözden geçirme sayfasında, varlığın ayrıntılarını gözden geçirin ve oluştur'u seçerek varlığı oluşturun. Birkaç dakika sonra varlık Varlıklar sayfasında görünür:

Bu örnekte, içeri aktarılan varlık aşağıdaki ayarlara sahip bir veri kümesi tanımına sahiptir:

Setting	Değer
Veri kümesi adı	`A/B/asset1`
Veri kaynağı	`A/B/asset1`
Hedef konu başlığı	`X/Y/A/B/asset1`

Artık bağlayıcı, konusuna A/B/asset1 yayımlanan tüm iletileri birleştirilmiş ad alanının konusuna X/Y/A/B/asset1 kopyalar.

Yönetim grupları ve eylemler ekleme

Yönetim grubu, MQTT varlığına karşı çağırabileceğiniz mantıksal bir eylem grubudur. Eylem, abonenin üzerinde işlem yapabilecekleri bir konuya ileti yayımlamanıza olanak tanır. Eylemler bir yönetim grubuna ait olmalıdır.

Uyarı

İşlem deneyimi, MQTT için bağlayıcının yönetim gruplarını ve eylemlerini otomatik olarak bulmaz. Varlığı içeri aktarırken veya aldıktan sonra bunları el ile oluşturmanız gerekir.

Bir yönetim grubu eklemek ve bunun eylemlerini tanımlamak için:

İşlem deneyiminde Varlıklar listesinden varlığı seçin ve Yönetim grupları sekmesini seçin.
Yönetim grubu ekle'yi seçin ve bir ad verin.
Yönetim grubunda Eylem ekle'yi seçin ve eylemi yapılandırın:
- Ad: Eylem için kullanıcı dostu bir ad.
- Hedef URI: Eylem yükünü yayımlamak için cihaz uç noktanızda bulunan MQTT konusu. Örneğin, A/B/asset1/commands.
- Konu: Eylem yürütme isteğinin yayımlanması için MQTT konusu.
- Eylem türü: Write MQTT için bağlayıcı için desteklenen tek eylem türüdür.
- Zaman aşımı: Eylem yürütme isteği zaman aşımına uğramadan önce zaman aşımı değeri.

Eylemi çağırdığınızda bağlayıcı, eylem yükünü cihazın gelen uç noktasındaki Hedef URI konusuna yayımlar. Bu konudaki aşağı akış abonesi iletiyi alır ve bu konuda işlem yapabilir.

Yönetim gruplarının ve eylemlerin bağlayıcılar arasında nasıl çalıştığı hakkında arka plan için bkz:

Yönetim eylemlerini etkinleştirme ve çalıştırma
OPC UA sunucularını denetleme — eylem çağırma desenini ve eylemleri tetiklemede kullanılan MQTT RPC protokollerini açıklar.
Kamerayı yönetme ve denetleme — ONVIF bağlayıcısı için benzer bir desenin nasıl kullanıldığını gösterir.

Gelen verileri dönüştürme

Önemli

Rezerve edilmiş bulut başlıklarıyla çarpışmaları önlemek için, konnektör MQTT kullanıcı özelliklerini gelen mesajlardan giden mesajlara yaymaz. Kullanıcı özelliklerini korumak için, bunları ileti yüküne eklemek üzere kullanıcı özelliklerini ileti yüküne ekleme örneğini kullanın. Örnek, en üst seviyede bir JSON nesne yükü gerektirir ve anahtarın altına _user_properties bu özellikleri ekler.

WasM modülü ve grafı kullanarak gelen verileri dönüştürmek için aşağıdaki adımları tamamlayın:

Özel dönüşümü gerçekleştirmek için bir WASM modülü geliştirin. Daha fazla bilgi için bkz. WebAssembly (WASM) modülleri geliştirme.
Dönüştürme grafınızı yapılandırın. Daha fazla bilgi için bkz. WebAssembly (WASM) graf tanımlarını yapılandırma.
Hem modülü hem de grafı kapsayıcı kayıt defterinize dağıtın. Daha fazla bilgi için bkz. WebAssembly (WASM) modüllerini ve graf tanımlarını dağıtma.
Azure IoT İşlemleri kapsayıcı kayıt defterine erişebilmesi için kimlik doğrulaması ve bağlantı ayrıntılarını ayarlayın.
Dönüştür alanında dağıtılan WASM grafiğinin URL'si ile varlığınızın veri kümesini yapılandırın:

Bağlayıcıdaki veri dönüştürme işlemi yalnızca tek bir eşleme işleci gerektirir, ancak WASM grafikleri aşağıdaki kısıtlamalarla tam olarak desteklenir:

Grafın tek bir source düğümü ve tek bir sink düğümü olmalıdır.
Grafın DataModel::Message veri türünü tüketmesi ve üretmesi gerekir.
Grafik durumsuz olmalıdır. Mevcut kısıtlama, birikim operatörlerinin desteklenmediği anlamına gelir.

Bilinen sorunlar

Aşağıdaki bilinen sorun MQTT bağlayıcısı için geçerlidir:

Yanlış yapılandırılmış varlık bulma ayarları tanılama çıkışı üretmez

Varlık bulma yapılandırması - konu filtresi veya konu eşleme ön eki - geçersiz veya tutarsızsa, bağlayıcı bir hata bildirmez. Hiçbir keşfedilen varlık görünmüyor ve kullanıcı arabiriminde veya günlüklerde hiçbir uyarı gösterilmiyor.

Yanlış yapılandırmayı tanılamak için şunları doğrulayın:

İletiler, konu filtresiyle eşleşen bir konu başlığında yayımlanıyor.
Bağlayıcı pod günlükleri, aracı uç noktasına bağlantı hatalarını göstermez.

Yapılandırmayı düzeltmeniz gerekiyorsa cihazı silin ve yeniden oluşturun.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-08-27

Bağlayıcıyı MQTT için yapılandırma

Önkoşullar

MQTT bağlayıcısı şablon örneği

Bağlayıcı için sertifika güven listesi yapılandırma

Cihaz oluşturma

Bir cihazı kullanıcı adı ve parola kullanacak şekilde yapılandırma

Cihazı X.509 sertifikası kullanacak şekilde yapılandırma

Varlıkları bulma ve oluşturma

Yönetim grupları ve eylemler ekleme

Gelen verileri dönüştürme

Bilinen sorunlar

Yanlış yapılandırılmış varlık bulma ayarları tanılama çıkışı üretmez

Geri Bildirim

Ek kaynaklar