MQTT.fx kullanarak bir MQTT cloud gateway'e bağlanma - IoT Platform

Bu konuda, Windows bilgisayarınızda MQTT.fx yazılımını kullanarak bir MQTT cloud gateway cihazını simüle etme, IoT Platform'a bağlama ve veri gönderme adımları açıklanmaktadır.

Önkoşullar

Enterprise Edition örneği satın alın. Bu eğitimde Çin (Şanghay) bölgesindeki Exclusive Enterprise Edition örneği kullanılmaktadır.
MQTT.fx yazılımını indirin ve yükleyin. Talimatlar için bkz. MQTT.fx.

Üçüncü taraf yazılımlar düzenli olarak güncellendiğinden kullanıcı arayüzünüz farklılık gösterebilir.
Özel sertifika oluşturun.

Bu eğitimde kök sertifika (root-ca.crt), sunucu tarafı özel anahtar (server.key) ve sunucu sertifikası (server.crt) içeren özel bir sertifika gerekmektedir.

Sertifikayı oluşturmak için OpenSSL kullanabilirsiniz. Daha fazla bilgi için bkz. Özel sertifika oluşturma.

Arka plan bilgileri

MQTT.fx; Eclipse Paho tabanlı, Java ile yazılmış bir MQTT istemcisidir. Windows, macOS ve Linux ortamlarını destekler. Bir cihazın IoT Platform'a bağlanabildiğini ve konular aracılığıyla iletişim kurabildiğini doğrulamak için MQTT.fx'i kullanabilirsiniz.

Cihazlar; özel sertifikalar, sunucu tarafı kimlik doğrulama ve özel konular gibi özellikleri kullanarak IoT Platform'a bağlanabilir ve platformla iletişim kurabilir.

MQTT cloud gateway için cihaz kimlik doğrulama ve iletişimi hakkında daha fazla bilgi için bkz. MQTT cloud gateway'lerine genel bakış.

MQTT.fx kullanarak cihaz bağlama (tek taraflı doğrulama)

Adım 1: Cloud gateway ve cihaz oluşturma

MQTT cloud gateway oluşturma. Gateway'i yapılandırırken server.key dosyasının içeriğini Server-side Private Key parametresi için, server.crt dosyasının içeriğini ise Server Certificate parametresi için kullanın.

Diğer parametreleri aşağıdaki gibi yapılandırın: Protocol için MQTT seçin, Custom Port Number değerini varsayılan 1883 olarak bırakın, Authentication Type için one-party verification seçin, Enable Data Parsing için No seçin, Enable Device X.509 Certificate Authentication için No seçin ve Enable OCSP için Do not enable seçin.
Cloud gateway listesinde Gateway URL değerini kopyalayın ve kaydedin.

Cloud gateway listesi; gateway adı, protokol, Gateway URL ve durum gibi bilgileri görüntüler.
Cihazları toplu iş olarak ekleme. Bu eğitim için tek bir cihaz ekleyin. MQTT Username değerini device_01, MQTT Password değerini ise hello123 olarak ayarlayın.

Adım 2: MQTT.fx bağlantısını yapılandırma

MQTT.fx yazılımını açın. Menü çubuğunda Extras öğesine tıklayın ve Edit Connection Profiles seçeneğini belirleyin.

Edit Connection Profiles sayfasında aşağıdaki parametreleri yapılandırın.

Temel bilgileri ayarlayın. Diğer parametreler için varsayılan değerleri kullanın.

Parameter	Description
Profile Name	Özel bir ad girin.
Profile Type	Bağlantı türü olarak MQTT Broker seçin.
Broker Address	Kaydettiğiniz Gateway URL içindeki alan adını girin.
Broker Port	Özel bağlantı noktası numarasını ayarlayın. Varsayılan değer `1883` değeridir.
Client ID	İsteğe bağlıdır. En fazla 64 karakter uzunluğunda özel bir istemci kimliği girin. Kolay tanımlama için cihazın MAC adresini veya seri numarasını (SN) kullanabilirsiniz.

User Credentials sekmesine tıklayın, Use Username/Password onay kutusunu işaretleyin ve User Name ile Password alanlarını doldurun.

User Name ve Password değerleri, eklediğiniz cihazın MQTT Username ve MQTT Password değerleriyle eşleşmelidir.
SSL/TLS sekmesine tıklayın, Enable SSL/TLS onay kutusunu işaretleyin ve Protocol değerini TLSv1.2 olarak ayarlayın.
CA certificate file seçeneğini belirleyin ve ardından root-ca.crt dosyanızın yolunu seçin.

Parametreleri yapılandırdıktan sonra OK düğmesine tıklayın.
Connect düğmesine tıklayın.

Sağ taraftaki yeşil ışık başarılı bir bağlantıyı gösterir. IoT Platform konsolu üzerinde örneğinizin Devices > Devices sayfasına gidin. device_01 cihazının durumu online olarak görünür.

MQTT.fx kullanarak cihaz bağlama (üçüncü taraf doğrulama)

Adım 1: Cihaz kimlik doğrulama işlevi oluşturma

Function Compute konsolu üzerinde oturum açın. Sol gezinme bölmesinde Services & Functions seçeneğine tıklayın.
Üst gezinme çubuğunda China (Shanghai) bölgesini seçin. Services sayfasında Create Service düğmesine tıklayın.
Create Service panelinde Service Name alanına IoT_Service gibi bir ad girin ve ardından OK. düğmesine tıklayın.
Functions sayfasında Create Function düğmesine tıklayın.
Create Function sayfasında aşağıdaki parametreleri yapılandırın ve Create düğmesine tıklayın.

Oluşturma yöntemi olarak Create with Built-in Runtime seçeneğini belirleyin. Function Name alanına three_party_auth yazın. Request Handler Type olarak Event Handler seçin. Runtime olarak Python 3.6 seçin.

Function Details sayfasında örnek kodu aşağıdaki kodla değiştirin ve Deploy Code düğmesine tıklayın.

Kimlik doğrulama işlevi, UserName değerini deviceName olarak döndürür.

# -*- coding: utf-8 -*-
import logging
import json
import time
import enum
import random
import string

class Request:
    def __init__(self, json_str):
        self.clientId = None
        self.username = None
        self.password = None
        self.certificateCommonName = None

        for key, value in json.loads(json_str).items():
            setattr(self, key, value)

class Response:
    def __init__(self):
        self.deviceName = None
        self.result = 'true'
        self.message = 'success'

    def handler(self, request):
        # Verify the validity of the username and password based on your business requirements.
    
        self.deviceName = request.username
        
        
        return json.dumps(self.__dict__)

def handler(event, context):
    request = Request(event)
    return Response().handler(request)

Adım 2: MQTT cloud gateway oluşturma

MQTT cloud gateway oluşturma. Gateway'i yapılandırırken server.key dosyasının içeriğini Server-side Private Key parametresi için, server.crt dosyasının içeriğini ise Server Certificate parametresi için kullanın. Cihaz kimlik doğrulama Function Compute (FC) hizmeti ve işlevi olarak oluşturduğunuz IoT_Service ve three_part_auth seçeneklerini belirleyin.

Diğer parametreleri aşağıdaki gibi yapılandırın: Protocol değerini MQTT olarak ayarlayın, Custom Port Number değerini varsayılan 1883 olarak bırakın, Authentication Type değerini Third-party Verification olarak ayarlayın, Enable Data Parsing değerini No olarak ayarlayın, Enable Device X.509 Certificate Authentication değerini No olarak ayarlayın, Enable OCSP değerini Disabled olarak ayarlayın ve Authorization değerini AliyunIOTAccessingFCRole olarak ayarlayın.
Cloud gateway listesinde Gateway URL değerini kopyalayın ve kaydedin.

Cloud gateway listesi; gateway adı, protokol, Gateway URL ve durum gibi bilgileri görüntüler.

Adım 3: MQTT.fx bağlantısını yapılandırma

MQTT.fx yazılımını açın. Menü çubuğunda Extras öğesine tıklayın ve Edit Connection Profiles seçeneğini belirleyin.

Edit Connection Profiles sayfasında aşağıdaki parametreleri yapılandırın.

Temel bilgileri ayarlayın. Diğer parametreler için varsayılan değerleri kullanın.

Parameter	Description
Profile Name	Özel bir ad girin.
Profile Type	Bağlantı türü olarak MQTT Broker seçin.
Broker Address	Kaydettiğiniz Gateway URL içindeki alan adını girin.
Broker Port	Özel bağlantı noktası numarasını ayarlayın. Varsayılan değer `1883` değeridir.
Client ID	İsteğe bağlıdır. En fazla 64 karakter uzunluğunda özel bir istemci kimliği girin. Kolay tanımlama için cihazın MAC adresini veya seri numarasını (SN) kullanabilirsiniz.

User Credentials sekmesine tıklayın, Use Username/Password onay kutusunu işaretleyin ve User Name (örneğin threeParty_device_001) ile Password alanlarını doldurun.
Not
- User Name: 4 ila 32 karakter uzunluğunda olmalı ve harf, rakam, tire (-), alt çizgi (_), at işareti (@), nokta (.) ve iki nokta üst üste (:) içerebilir. User Name, ürün içinde benzersiz olmalıdır.
- Password: 1 ila 32 karakter uzunluğunda olmalı ve harf, rakam, tire (-), alt çizgi (_), at işareti (@), nokta (.) ve iki nokta üst üste (:) içerebilir.
SSL/TLS sekmesine tıklayın, Enable SSL/TLS onay kutusunu işaretleyin ve Protocol değerini TLSv1.2 olarak ayarlayın.
CA certificate file seçeneğini belirleyin ve ardından root-ca.crt dosyanızın yolunu seçin.

Parametreleri yapılandırdıktan sonra OK düğmesine tıklayın.
Connect düğmesine tıklayın.

Sağ taraftaki yeşil ışık başarılı bir bağlantıyı gösterir. IoT Platform, FC kimlik doğrulama işlevinin döndürdüğü threeParty_device_001 deviceName değerini cihazın DeviceName değeri olarak kullanır. Platform ardından cihazı otomatik olarak oluşturur ve cihaz IoT Platform konsolu üzerindeki Devices > Devices sayfasında online olarak görünür.

Özel konu kullanarak veri gönderme

MQTT.fx'te Publish seçeneğine tıklayın. Publish metin kutusuna özel konuyu girin: /home/garden/fountain.
Yük düzenleyicisine mesaj içeriğini girin ve Publish düğmesine tıklayın.
IoT Platform konsolu üzerinde oturum açın. Örneğinizde Maintenance > Log Service sayfasına giderek Device-to-Cloud Messages günlüklerini görüntüleyin. Daha fazla bilgi için bkz. Cloud tarafı günlüklerini sorgulama. Mesaj ayrıntılarını (Topic, zaman damgası ve yük) görüntülemek için View düğmesine tıklayın.