Руководство по интеграции с AWS IoT Core (MQTT-брокер)

Prev Next

Tulip Interface к интеграции с AWS IoT Core — Руководство по консоли AWS

# Tulip Interface к интеграции с AWS IoT Core — Руководство по консоли AWS

Обзор

В этом руководстве показано, как подключить устройство « Tulip Interface » к AWS IoT Core, используя только консоль AWS — командная строка не требуется!

Необходимые условия

  • Доступ к консоли AWS с правами доступа к IoT
  • Доступ к устройству Tulip Interface с поддержкой соединителя MQTT
  • Веб-браузер

Шаг 1: Создание устройства IoT

1.1 Перейдите в консоль AWS IoT

  1. Перейдите в консоль AWS IoT
  2. В левой боковой панели нажмите «Управление » → «Устройства»

1.2 Создание нового устройства

  1. Нажмите «Создать устройства»
  2. Выберите «Создать одно устройство»
  3. Нажмите «Далее»
  4. Введите название объекта: tulip-interface-client
  5. Остальные поля оставьте по умолчанию
  6. Нажмите «Далее»

Шаг 2: Создание сертификата устройства

2.1 Настройка сертификата

  1. Выберите «Автоматически сгенерировать новый сертификат»
  2. Нажмите «Далее»

2.2 Создание политики IoT

  1. Нажмите «Создать политику»
  2. На открывшейся новой вкладке:
  3. Название политики: TulipMQTTPolicy
  4. Документ политики: перейдите на вкладку «JSON» и вставьте: json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:*" ], "Resource": "*" } ] }
  5. Нажмите «Создать»
  6. Вернитесь на предыдущую вкладку

2.3 Привязка политики

  1. Обновите список политик
  2. Выберите «TulipMQTTPolicy»
  3. Нажмите «Создать объект»

Шаг 3: Загрузка файлов сертификатов

3.1 Загрузите необходимые файлы

ВАЖНО: Загрузите эти файлы немедленно (позже их загрузить будет невозможно):

  1. Сертификат устройства → Сохраните как certificate.pem.crt
  2. Файл закрытого ключа → Сохраните как private.pem.key
  3. Amazon Root CA 1 → Сохраните как AmazonRootCA1.pem
  4. Нажмите «Готово»

3.2 Создание файла цепочки сертификатов

  1. Откройте файл certificate.pem.crt в текстовом редакторе
  2. Откройте файл AmazonRootCA1.pem в текстовом редакторе
  3. Создайте новый файл с именем cert_chain.pem
  4. Скопируйте всё содержимое файла certificate.pem.crt в файл cert_chain.pem
  5. Добавьте новую строку в конец файла
  6. Скопируйте всё содержимое файла AmazonRootCA1.pem и добавьте его в конец файла cert_chain.pem
  7. Сохраните файл cert_chain.pem

Шаг 4: Преобразование формата закрытого ключа

4.1 Онлайн-инструмент для преобразования

Поскольку мы стараемся избегать использования командной строки, воспользуйтесь онлайн-инструментом:

  1. Перейдите на сайт SSL Converter или аналогичный инструмент
  2. Выберите «Конвертировать из: частный ключ RSA»
  3. Выберите «Конвертировать в: PKCS#8»
  4. Загрузите файл private.pem.key
  5. Скачайте преобразованный файл с именем private_pkcs8.pem

Примечание по безопасности: для рабочей среды используйте автономные инструменты или командную строку для обеспечения более высокого уровня безопасности.


Шаг 5: Получение конечной точки IoT

5.1 Найдите свой конечный узел

  1. В консоли AWS IoT перейдите в раздел «Настройки» (левая боковая панель)
  2. В разделе «Конечная точка данных устройства» скопируйте URL-адрес конечной точки
  3. Он выглядит следующим образом: a1234567890123-ats.iot.us-west-1.amazonaws.com
  4. Сохраните этот URL — он понадобится вам для настройки Tulip

Шаг 6: Настройте MQTT-коннектор « Tulip Interface »

6.1 Параметры подключения MQTT

В коннекторе MQTT « Tulip Interface » настройте:

  • Хост-сервер MQTT: [Ваш конечный адрес из шага 5]
  • Порт: 8883
  • Протокол: MQTT через TLS или MQTTS
  • Идентификатор клиента: tulip-interface-client

6.2 Настройка сертификата

Загрузите следующие файлы на сайт Tulip Interface:

  1. Файл сертификата: загрузите cert_chain.pem
  2. Файл закрытого ключа: загрузите private_pkcs8.pem
  3. Файл сертификата ЦС: загрузите AmazonRootCA1.pem

6.3 Настройка темы

  • Тема публикации: tulip/data
  • Тема подписки: tulip/commands (необязательно)

Шаг 7: Включение ведения журналов CloudWatch (необязательно)

7.1 Создание роли IAM

  1. Перейдите в консоль IAM
  2. Нажмите «Роли » → «Создать роль»
  3. Выберите сервис AWS → IoT
  4. Нажмите «Далее»
  5. Найдите и выберите «CloudWatchLogsFullAccess»
  6. Нажмите «Далее»
  7. Имя роли: IoTLogsRole
  8. Нажмите «Создать роль»

7.2 Включение ведения журналов IoT

  1. Вернитесь в консоль AWS IoT
  2. Перейдите в раздел «Настройки» (левая боковая панель)
  3. В разделе «Журналы» нажмите «Изменить»
  4. Уровень детализации: «Информация»
  5. Установить роль: выберите «IoTLogsRole»
  6. Нажмите «Обновить»

Шаг 8: Проверка подключения

8.1 Мониторинг в консоли AWS

  1. Перейдите в раздел «Тестирование» → «Тестовый клиент MQTT»
  2. Нажмите «Подписаться на тему»
  3. Фильтр тем: tulip/data
  4. Нажмите «Подписаться»

8.2 Тестирование из Tulip

  1. Отправьте тестовое сообщение из Tulip Interface
  2. Вы должны увидеть, как сообщение появляется в тестовом клиенте AWS MQTT

8.3 Проверка журналов CloudWatch (если включено)

  1. Перейдите в консоль CloudWatch
  2. Нажмите «Журналы » → «Группы журналов»
  3. Найдите AWSIotLogsV2
  4. Щелкните группу журналов, чтобы просмотреть журналы подключений

Устранение неполадок

Распространенные проблемы и способы их устранения с помощью консоли

1. Сертификат не работает

Проблема: Не удается установить соединение из-заошибок сертификата.Решение: - Убедитесь, что вы используете файл cert_chain.pem (а не отдельный сертификат). - Убедитесь, что закрытый ключ имеет формат PKCS#8 (private_pkcs8.pem)

2. Проблемы с политиками

Проблема: вжурналах фиксируются сбои авторизации.Решение: 1. Перейдите в раздел «Безопасность» → «Политики». 2. Выберите TulipMQTTPolicy. 3. Убедитесь, что политика в формате JSON разрешает «iot:*» для ресурсов «*».

3. Неверный конечный пункт

Проблема: Не удаётся подключиться кброкеру. Решение: 1. Перейдите в раздел «Настройки» в консоли IoT. 2. Скопируйте точный URL-адрес конечной точки (включая суффикс -ats ). 3. Используйте порт 8883

4. Сертификат не привязан

Проблема:Ошибки аутентификации. Решение: 1. Перейдите в раз дел «Безопасность» → «Сертификаты». 2. Нажмите на свой сертификат. 3. Проверьте вкладки «Объекты» и «Политики ». 4. Убедитесь, что объект «tulip-interface-client» и политика «TulipMQTTPolicy » привязаны.


Сводка файлов

Для настройки Tulip у вас должны быть следующие файлы:

📁 Загруженные файлы├── certificate.pem.crt      # Исходный сертификат устройства├── private.pem.key          # Исходный закрытый ключ├── AmazonRootCA1.pem        # Корневой центр сертификации Amazon├── cert_chain.pem           # Сертификат + корневой центр сертификации ← Используйте этот файл└── private_pkcs8.pem        # Преобразованный закрытый ключ ← Используйте этот файл

Краткое руководство

Краткое руководство по настройке Tulip MQTT

Параметр Значение
Хост [your-endpoint]-ats.iot.[region].amazonaws.com
Порт 8883
Идентификатор клиента tulip-interface-client
Тема tulip/data
Сертификат cert_chain.pem
Частный ключ private_pkcs8.pem
Сертификат ЦС AmazonRootCA1.pem

Быстрые ссылки консоли AWS


Индикаторы успешного подключения

✅ Подключение успешно

  • Tulip Interface отображается статус «Подключено»
  • Сообщения появляются в тестовом клиенте AWS MQTT при подписке на канал tulip/data
  • В журналах CloudWatch отображаются события успешной публикации (Publish-In)

❌ Подключение не удалось

  • Проверьте, что файлы сертификатов имеют правильный формат
  • Убедитесь, что URL-адрес конечной точки точно соответствует указанному в консоли AWS
  • Убедитесь, что используется порт 8883
  • Убедитесь, что ID клиента точно совпадает с именем устройства

Рекомендации по безопасности

  1. Хранение сертификатов: надежно храните файлы сертификатов в Tulip
  2. Уточнение политик: после тестирования создайте более строгие политики
  3. Мониторинг: включите ведение журналов CloudWatch для мониторинга в производственной среде
  4. Регулярная ротация: запланируйте ротацию сертификатов (срок действия сертификатов истекает в 2049 году)

Ресурсы поддержки

  • Документация AWS IoT: docs.aws.amazon.com/iot
  • Служба поддержки Tulip: обращайтесь в службу поддержки Tulip по вопросам, связанным с коннектором MQTT
  • Служба поддержки AWS: обращайтесь в службу поддержки AWS по вопросам, связанным с IoT Core

Примечание: в данном руководстве используется исключительно консоль AWS. Для автоматизации или написания скриптов обратитесь к руководству по работе с CLI.