Усі посібники

Як зробити · 5 хв

Видати й відкликати облікові дані

Облікові дані конектора дають вашому пристрою або шлюзу вхід на брокер Lab і власні топіки. Тут — як їх видати, безпечно зберегти, замінити і відкликати.

OBSERVE і CONTROL

МожливістьЩо дозволяє і хто видає
OBSERVEПублікувати state, telemetry і hello. Видають власник, адміністратор або розробник. Обирається типово.
CONTROLЩе й публікувати receipt і отримувати команди зі свого топіка commands. Видають лише власник або адміністратор з явним підтвердженням.

Облікові дані CONTROL самі по собі не вмикають запис. Для команд ще потрібні локальний дозвіл на запис і окремий дозвіл власник чи адміністратор в Lab.

Видати облікові дані

  1. Відкрийте джерело

    На сторінці MQTT- або Home Assistant-джерела перейдіть до розділу «Конектор», панель «Облікові дані конектора». Для симулятора облікові дані не потрібні.

  2. Оберіть можливість

    У полі «Можливість» залиште OBSERVE, якщо потрібна лише телеметрія. Для CONTROL позначте «Надаю цьому конектору право отримувати обмежені Lab-команди».

  3. Задайте термін дії

    «Термін дії, секунд» — від 60 до 604800 (сім днів). Типово 86400, тобто доба. Коротший строк безпечніший.

  4. Видайте дані

    Натисніть «Видати дані один раз». З’явиться блок «Збережіть приватний файл зараз» із паролем і топіками.

  5. Збережіть файл

    Натисніть «Завантажити приватний файл» (lab-credential.json). На POSIX дайте йому права 0600, у Windows — приватний ACL. Потім натисніть «Закрити та очистити секрет».

Пароль показується лише один раз. Lab зберігає тільки його хеш SHA-256 і не може показати його знову. Не вставляйте пароль у профіль, тікет чи чат. Якщо файл загубився, видайте нові дані з ротацією.

Ротація

Поки є активні облікові дані, нові без ротації не видаються. Щоб замінити їх, позначте «Замінити наявні активні дані та відкликати попередні» і натисніть «Видати дані один раз».

Lab спершу закриває доступ старих даних і роз’єднує їхню сесію, а потім створює нові. Нові дані мають новий ідентифікатор, ім’я користувача, пароль і топіки. Оновіть файл у конекторі й перезапустіть його.

Відкликання

  1. Натисніть «Відкликати»

    Кнопка є біля даних у стані ACTIVE, PENDING або REVOKING. Відкликати можуть лише власник і адміністратор.

  2. Підтвердьте

    Натисніть «Підтвердити відкликання». Якщо стан лишився REVOKING, відкликання можна безпечно повторити.

Відкликання закриває доступ конектора й запитує відновлення активної команди. Воно не підтверджує виміряне відновлення: дивіться хронологію доказів.

Lab також відкликає дані сам: коли минає строк дії, коли в того, хто їх видав, забрали роль чи запрошення. Щоб прив’язати нову версію профілю до джерела, живих облікових даних бути не повинно.

Стани облікових даних

СтанЩо означає
PENDINGВидача триває. Якщо її перервано, Lab вимикає дані, а не активує їх.
ACTIVEДані діють до вказаного строку.
REVOKINGДоступ у Lab уже закрито, але брокер ще не підтвердив очищення.
REVOKEDВідкликано й підтверджено. Знову активувати не можна.
EXPIREDСтрок дії минув.

Типові проблеми

ПовідомленняЩо робити
active credential exists; explicitly rotate itПозначте ротацію або спершу відкличте активні дані.
explicit bounded-control credential consent requiredДля CONTROL позначте підтвердження під формою.
credential provisioning/revocation must reconcile firstПопередня видача чи відкликання ще не завершилися. Оновіть сторінку трохи згодом.
isolated Lab broker is not configuredБрокер Lab не налаштований. Зверніться до адміністратора Lab.
CONTROLНемає такого варіанта — у вас роль розробника. Попросіть власника або адміністратора.