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
- Перейдите в консоль AWS IoT
- В левой боковой панели нажмите «Управление » → «Устройства»
1.2 Создание нового устройства
- Нажмите «Создать устройства»
- Выберите «Создать одно устройство»
- Нажмите «Далее»
- Введите название объекта:
tulip-interface-client - Остальные поля оставьте по умолчанию
- Нажмите «Далее»
Шаг 2: Создание сертификата устройства
2.1 Настройка сертификата
- Выберите «Автоматически сгенерировать новый сертификат»
- Нажмите «Далее»
2.2 Создание политики IoT
- Нажмите «Создать политику»
- На открывшейся новой вкладке:
- Название политики:
TulipMQTTPolicy - Документ политики: перейдите на вкладку «JSON» и вставьте:
json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:*" ], "Resource": "*" } ] } - Нажмите «Создать»
- Вернитесь на предыдущую вкладку
2.3 Привязка политики
- Обновите список политик
- Выберите «TulipMQTTPolicy»
- Нажмите «Создать объект»
Шаг 3: Загрузка файлов сертификатов
3.1 Загрузите необходимые файлы
ВАЖНО: Загрузите эти файлы немедленно (позже их загрузить будет невозможно):
- Сертификат устройства → Сохраните как
certificate.pem.crt - Файл закрытого ключа → Сохраните как
private.pem.key - Amazon Root CA 1 → Сохраните как
AmazonRootCA1.pem - Нажмите «Готово»
3.2 Создание файла цепочки сертификатов
- Откройте файл
certificate.pem.crtв текстовом редакторе - Откройте файл
AmazonRootCA1.pemв текстовом редакторе - Создайте новый файл с именем
cert_chain.pem - Скопируйте всё содержимое файла
certificate.pem.crtв файлcert_chain.pem - Добавьте новую строку в конец файла
- Скопируйте всё содержимое файла
AmazonRootCA1.pemи добавьте его в конец файлаcert_chain.pem - Сохраните файл
cert_chain.pem
Шаг 4: Преобразование формата закрытого ключа
4.1 Онлайн-инструмент для преобразования
Поскольку мы стараемся избегать использования командной строки, воспользуйтесь онлайн-инструментом:
- Перейдите на сайт SSL Converter или аналогичный инструмент
- Выберите «Конвертировать из: частный ключ RSA»
- Выберите «Конвертировать в: PKCS#8»
- Загрузите файл
private.pem.key - Скачайте преобразованный файл с именем
private_pkcs8.pem
Примечание по безопасности: для рабочей среды используйте автономные инструменты или командную строку для обеспечения более высокого уровня безопасности.
Шаг 5: Получение конечной точки IoT
5.1 Найдите свой конечный узел
- В консоли AWS IoT перейдите в раздел «Настройки» (левая боковая панель)
- В разделе «Конечная точка данных устройства» скопируйте URL-адрес конечной точки
- Он выглядит следующим образом:
a1234567890123-ats.iot.us-west-1.amazonaws.com - Сохраните этот 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:
- Файл сертификата: загрузите
cert_chain.pem - Файл закрытого ключа: загрузите
private_pkcs8.pem - Файл сертификата ЦС: загрузите
AmazonRootCA1.pem
6.3 Настройка темы
- Тема публикации:
tulip/data - Тема подписки:
tulip/commands(необязательно)
Шаг 7: Включение ведения журналов CloudWatch (необязательно)
7.1 Создание роли IAM
- Перейдите в консоль IAM
- Нажмите «Роли » → «Создать роль»
- Выберите сервис AWS → IoT
- Нажмите «Далее»
- Найдите и выберите «CloudWatchLogsFullAccess»
- Нажмите «Далее»
- Имя роли:
IoTLogsRole - Нажмите «Создать роль»
7.2 Включение ведения журналов IoT
- Вернитесь в консоль AWS IoT
- Перейдите в раздел «Настройки» (левая боковая панель)
- В разделе «Журналы» нажмите «Изменить»
- Уровень детализации: «Информация»
- Установить роль: выберите
«IoTLogsRole» - Нажмите «Обновить»
Шаг 8: Проверка подключения
8.1 Мониторинг в консоли AWS
- Перейдите в раздел «Тестирование» → «Тестовый клиент MQTT»
- Нажмите «Подписаться на тему»
- Фильтр тем:
tulip/data - Нажмите «Подписаться»
8.2 Тестирование из Tulip
- Отправьте тестовое сообщение из Tulip Interface
- Вы должны увидеть, как сообщение появляется в тестовом клиенте AWS MQTT
8.3 Проверка журналов CloudWatch (если включено)
- Перейдите в консоль CloudWatch
- Нажмите «Журналы » → «Группы журналов»
- Найдите AWSIotLogsV2
- Щелкните группу журналов, чтобы просмотреть журналы подключений
Устранение неполадок
Распространенные проблемы и способы их устранения с помощью консоли
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
- Консоль IoT — Главное управление IoT
- Тестовый клиент MQTT — тестирование сообщений
- Журналы CloudWatch — просмотр журналов подключений
- Консоль IAM — управление ролями и политиками
Индикаторы успешного подключения
✅ Подключение успешно
- Tulip Interface отображается статус «Подключено»
- Сообщения появляются в тестовом клиенте AWS MQTT при подписке на
канал tulip/data - В журналах CloudWatch отображаются события успешной
публикации (Publish-In)
❌ Подключение не удалось
- Проверьте, что файлы сертификатов имеют правильный формат
- Убедитесь, что URL-адрес конечной точки точно соответствует указанному в консоли AWS
- Убедитесь, что используется порт 8883
- Убедитесь, что ID клиента точно совпадает с именем устройства
Рекомендации по безопасности
- Хранение сертификатов: надежно храните файлы сертификатов в Tulip
- Уточнение политик: после тестирования создайте более строгие политики
- Мониторинг: включите ведение журналов CloudWatch для мониторинга в производственной среде
- Регулярная ротация: запланируйте ротацию сертификатов (срок действия сертификатов истекает в 2049 году)
Ресурсы поддержки
- Документация AWS IoT: docs.aws.amazon.com/iot
- Служба поддержки Tulip: обращайтесь в службу поддержки Tulip по вопросам, связанным с коннектором MQTT
- Служба поддержки AWS: обращайтесь в службу поддержки AWS по вопросам, связанным с IoT Core
Примечание: в данном руководстве используется исключительно консоль AWS. Для автоматизации или написания скриптов обратитесь к руководству по работе с CLI.
