Neu: Die KI-Firewall überwacht jedes Modul und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Berechtigungsreferenz

Jede IoT-Berechtigungs-ID mit ihrer Mindestrolle und dem, was sie erlaubt, die wichtigsten Plattformberechtigungen, nur für Eigentümer verfügbare Berechtigungen und die IoT-Gruppenvorlagen.

Jede Aktion in Hermetry ist durch eine Berechtigung geschützt. Diese Seite listet die Berechtigungen der IoT-Module und die Plattformberechtigungen auf, denen IoT-Administratoren am häufigsten begegnen, jeweils mit ihrer minimalen Rolle und dem, was sie erlauben. Wie Rollen, Gruppen und die Matrix Zugriffsrechte zusammenwirken, wird unter Gruppen und Berechtigungen erklärt; Zugriffsrichtlinien, die den Zugriff weiter einschränken, finden Sie unter Zugriffsrichtlinien.

So lesen Sie die Tabellen

SpalteBedeutung
BerechtigungDie ID, wie sie unter Zugriffsrechte (Suche nach ID) und unter API-Schlüssel Modulberechtigungen angezeigt wird
Was sie erlaubtDer Name der Berechtigung, wie die Konsole ihn anzeigt, leicht gekürzt
Minimale RolleDie niedrigste integrierte Rolle, die sie halten kann. Benutzer bedeutet jedes Mitglied standardmäßig, Admin bedeutet Administratoren und Eigentümer, Eigentümer bedeutet nur Eigentümer.

Regeln, die für jede Zeile gelten:

  • Ein Mitglied hat eine Berechtigung, wenn seine Rolle mindestens der minimalen Rolle entspricht und die Matrix der Organisation diese Rolle damit ausstattet, oder wenn eine seiner aktiven Gruppen sie gewährt und die minimale Rolle Benutzer oder Admin ist.
  • Eine Gruppe kann ein Mitglied über eine minimale Rolle Admin heben, niemals über eine minimale Rolle Eigentümer.
  • Eine Berechtigung eines Moduls, das Ihr Tarif nicht enthält, existiert für Ihre Organisation nicht.
  • Ein API-Schlüssel hält nur die Berechtigungen, die Sie ihm geben, und niemals mehr als sein Inhaber; Berechtigungen nur für Eigentümer werden von API-Schlüsseln nie gehalten.
  • Einige Berechtigungen gehören zu Funktionen, die sich in Entwicklung befinden; sie sind entsprechend gekennzeichnet. Ihre Vergabe hat keine Wirkung, bis die Funktion veröffentlicht wird. Siehe In Entwicklung.

IoT-Berechtigungen

Geräte

BerechtigungWas sie erlaubtMinimale Rolle
iot_device.devices.readGeräte anzeigenBenutzer
iot_device.devices.createGeräte anlegenAdmin
iot_device.devices.updateGeräte bearbeiten und deaktivierenAdmin
iot_device.devices.deleteGeräte löschenAdmin
iot_device.credentials.manageGerätezugangsdaten verwaltenAdmin
iot_device.attributes.readGeräteattribute anzeigenBenutzer
iot_device.attributes.writeServer- und gemeinsame Geräteattribute schreibenAdmin
iot_device.bindings.readMesswertzuordnungen anzeigenBenutzer
iot_device.bindings.manageMesswertzuordnungen verwalten (mit der eigenen Verwaltungsberechtigung des Zieldatensatzes)Admin

Gerätprofile

BerechtigungWas sie erlaubtMinimale Rolle
iot_device_profile.profiles.readGeräteprofile anzeigenBenutzer
iot_device_profile.profiles.writeGeräteprofile anlegen, bearbeiten und löschenAdmin
iot_device_profile.provisioning.manageBereitstellungseinstellungen und Schlüssel von Geräteprofilen verwaltenAdmin
iot_device_profile.templates.manageDie Profilvorlagen der Plattform verwalten. Nur Plattformbetreiber.Admin

Befehle

BerechtigungWas sie erlaubtMinimale Rolle
iot_rpc.readBefehlsverlauf und Befehlskataloge anzeigenBenutzer
iot_rpc.send.basicEinfache (nur lesende) Befehle an Geräte sendenBenutzer
iot_rpc.send.privilegedKonfigurationsbefehle an Geräte sendenAdmin
iot_rpc.send.criticalBefehle mit hoher Auswirkung an Geräte senden (Neustart)Admin
iot_rpc.send.rawRohbefehle senden (Methoden außerhalb des Katalogs)Eigentümer
iot_rpc.commands.manageDie Befehlskataloge von Geräteprofilen verwaltenAdmin

Alarme

BerechtigungWas sie erlaubtMinimale Rolle
iot_alarm.readAlarme und Alarmregeln anzeigenBenutzer
iot_alarm.rules.manageDie Alarmregeln von Geräteprofilen bearbeitenAdmin
iot_alarm.muteDie Alarme eines Geräts stummschaltenAdmin
iot_alarm.acknowledgeAlarme quittieren und Notizen hinzufügenBenutzer
iot_alarm.resolveAlarme von Hand auflösen (löschen)Admin

Regelkarte

BerechtigungWas sie erlaubtMinimale Rolle
iot_rules.readDie Regeln von Standorten und Geräten sowie deren Läufe anzeigenBenutzer
iot_rules.runEine Regel jetzt ausführenBenutzer
iot_rules.modeEinen Standort zwischen Manuell und Automatisch umschaltenBenutzer
iot_rules.manageRegeln hinzufügen, ändern, ein- oder ausschalten und löschenAdmin

Standorte und Anlagen

BerechtigungWas sie erlaubtMinimale Rolle
iot_asset.assets.readIoT-Standorte und Anlagen anzeigenBenutzer
iot_asset.assets.manageIoT-Standorte und Anlagen anlegen, bearbeiten, verschieben und löschenAdmin
iot_asset.relations.manageBeziehungen und Gerätezuordnung verwaltenAdmin

Telemetrie

BerechtigungWas sie erlaubtMinimale Rolle
telemetry.readTelemetriemesswerte lesen (von den Geräten, die Sie sehen dürfen)Benutzer
telemetry.admin.readDie Einstellungen des Telemetriespeichers anzeigen (Arten, Aufbewahrung, Schlüssel)Admin
telemetry.admin.manageDen Telemetriespeicher verwaltenAdmin

IoT-Telemetrieeinstellungen

BerechtigungWas sie erlaubtMinimale Rolle
iot_telemetry.settings.readIoT-Telemetrieeinstellungen anzeigenAdmin
iot_telemetry.settings.updateIoT-Telemetrieeinstellungen ändernAdmin

Firmware-Updates

BerechtigungWas sie erlaubtMinimale Rolle
iot_ota.readFirmware-Pakete, Zuweisungen und Update-Zustände der Geräte anzeigenBenutzer
iot_ota.packages.manageFirmware-Pakete hochladen, als veraltet markieren, widerrufen und löschenAdmin
iot_ota.assignFirmware zuweisen, OTA-Einstellungen ändern und Updates wiederholenAdmin
iot_ota.keys.manageÖffentliche Schlüssel zur Firmware-Signatur registrieren und widerrufenEigentümer

Gerätеeinstellungen aus der Ferne

BerechtigungWas sie erlaubtMinimale Rolle
iot_device_settings.manifests.readDen Katalog der Gerätesettings-Manifeste anzeigenAdmin
iot_device_settings.manifests.manageGerätesettings-Manifeste in den Katalog hochladenAdmin
iot_device_settings.readDie Einstellungen eines Geräts anzeigenAdmin
iot_device_settings.operateDie Betriebseinstellungen eines Geräts ändern (die niedrigste Klasse; zusammen mit Lesen vergeben)Admin
iot_device_settings.writeDie Konfigurationseinstellungen eines Geräts ändern (Netzwerk, WLAN, Firewall; umfasst Betriebseinstellungen; zusammen mit Betrieb vergeben)Admin
iot_device_settings.baselines.manageGerätesettings-Basislinien anlegen, ändern und löschen (benannte Teilabschnittswerte für viele Geräte)Admin
iot_device_settings.jobs.manageSettings-Aufträge starten, pausieren, fortsetzen und abbrechen, die eine Basislinie oder eine einzelne Änderung in Wellen auf viele Geräte anwenden (was ein Auftrag ändern darf, dürfen Sie ebenfalls ändern)Admin
iot_device_settings.dangerous.writeDie gefährlichen Einstellungen eines Geräts ändern (was die Verbindung zum Gerät unterbrechen kann; zusammen mit Schreiben vergeben)Eigentümer

Bereitstellung und Beanspruchung

BerechtigungWas sie erlaubtMinimale Rolle
iot_provisioning.claimGeräte beanspruchenAdmin
iot_provisioning.releaseGeräte freigebenAdmin
iot_provisioning.release.forceGeräte erzwungen freigeben. Nur Plattformbetreiber.Admin
iot_provisioning.quarantine.activateIn Quarantäne gesetzte Geräte aktivierenAdmin
iot_provisioning.pool.readDen Werkspool lizenzierter Geräte anzeigen. Nur Plattformbetreiber.Admin
iot_provisioning.pool.manageDen Werkspool verwalten. Nur Plattformbetreiber.Admin

Gerätezertifikate

BerechtigungWas sie erlaubtMinimale Rolle
iot_pki.certificates.readGerätezertifikate anzeigenAdmin
iot_pki.certificates.revokeGerätezertifikate widerrufenAdmin
iot_pki.recovery.approveZertifikatswiederherstellung genehmigenAdmin
iot_pki.ca.manageDie Zertifizierungsstellen der Plattform anzeigen und verwalten. Nur Plattformbetreiber.Admin
iot_pki.settings.updateEinstellungen für Gerätezertifikate ändernAdmin

Protokoll-Endpunkte

BerechtigungWas sie erlaubtMinimale Rolle
iot_gateway.endpoints.readProtokoll-Endpunkte und die Verbindung abgefragter Geräte anzeigenBenutzer
iot_gateway.endpoints.manageProtokoll-Endpunkte anlegen, bearbeiten, testen und löschen; abgefragte Geräte suchen und verbindenAdmin

Kamera-Protokollaktionen

BerechtigungWas sie erlaubtMinimale Rolle
iot_gateway_isapi.actions.manageDas Keyframe-Intervall einer unterstützten Kamera ändern (Auf 2 Sekunden setzen) und es wiederherstellenAdmin

Kameras

BerechtigungWas sie erlaubtMinimale Rolle
iot_camera.cameras.readKameras, ihre Streams und Einstellungen der Live-Ansicht anzeigenBenutzer
iot_camera.cameras.manageEine Vorrichtung als Kamera verwenden, Live-Ansicht ein- und ausschalten, deren Streams neu einlesen, die Kamera entfernenAdmin
iot_camera.view_liveDas Live-Bild einer Kamera ansehenBenutzer
iot_camera.snapshots.readDie Schnappschüsse der Kameras und die Speicherwerte der Kameras ansehen (in Entwicklung)Benutzer
iot_camera.snapshots.manageJetzt einen Schnappschuss einer Kamera erstellen und Schnappschüsse löschen (in Entwicklung)Admin
iot_camera.disk.readEinsehen, was eine Kamera auf ihrer eigenen Speicherkarte ablegt (in Entwicklung)Admin
iot_camera.disk.downloadAufnahmen und Bilder von der eigenen Speicherkarte einer Kamera herunterladen (in Entwicklung)Admin
iot_camera.recordings.readDie Zeitleiste der Aufnahmen ansehen, Aufnahmen abspielen und Ereignisclips auflisten (in Entwicklung)Benutzer
iot_camera.recordings.manageAufzeichnung ein- und ausschalten, Aufzeichnungseinstellungen ändern, Clips speichern, löschen und exportieren (in Entwicklung)Admin

LoRaWAN

BerechtigungWas sie erlaubtMindestrolle
iot_lorawan.gateways.readLoRaWAN-Gateways ansehenBenutzer
iot_lorawan.gateways.manageLoRaWAN-Gateways hinzufügen, bearbeiten, deaktivieren und löschen sowie deren Token erneuernAdmin
iot_lorawan.devices.readLoRaWAN-Geräte ansehenBenutzer
iot_lorawan.devices.manageLoRaWAN-Geräte hinzufügen, bearbeiten und löschen sowie deren AppKey festlegenAdmin
iot_lorawan.keys.readDen AppKey eines LoRaWAN-Geräts anzeigenAdmin
iot_lorawan.frames.readDie Live-LoRaWAN-Frames ansehenBenutzer

LoRaWAN-Codecs

BerechtigungWas sie erlaubtMindestrolle
iot_lorawan_codecs.readLoRaWAN-Codecs ansehen und den Codec-Testprüfstand ausführenBenutzer
iot_lorawan_codecs.manageEigene LoRaWAN-Codecs hinzufügen, ändern und löschenAdmin
iot_lorawan_codecs.library.manageCodecs der Plattformbibliothek zurückziehen und wiederherstellenAdmin

Router-Panels (Fernzugriff)

BerechtigungWas sie erlaubtMindestrolle
iot_remote_access.panel.openDas Web-Panel eines beanspruchten Routers öffnen, betreten und schließenAdmin
iot_remote_access.sessions.readDie Panel-Sitzungen der Organisation ansehenAdmin

eSIM

BerechtigungWas sie erlaubtMindestrolle
iot_esim.readDen eSIM-Chip, die Profile und die Vorgänge eines Routers ansehen (in Entwicklung)Admin
iot_esim.manageeSIM-Profile eines Routers herunterladen, wechseln, ausschalten, umbenennen und löschen (in Entwicklung)Inhaber

Dashboards

BerechtigungWas sie erlaubtMindestrolle
dashboard.home.viewDie Startseite öffnenBenutzer
dashboard.boards.readDashboards ansehenBenutzer
dashboard.boards.writeEigene Dashboards erstellen und anordnenBenutzer
dashboard.boards.manageGemeinsame Dashboards verwaltenAdmin
dashboard.widgets.author_privateEigene private Widgets erstellen und bearbeitenBenutzer
dashboard.widgets.authorWidgets erstellen und bearbeitenAdmin
dashboard.widgets.publishWidget-Versionen veröffentlichenAdmin
dashboard.query.executeWidget-Datenabfragen ausführenBenutzer
dashboard.commands.executeWidget-Befehle ausführenBenutzer
dashboard.display.viewEin Dashboard über einen Anzeigelink öffnenJeder mit einem Anzeigelink
dashboard.settings.readDashboard-Einstellungen ansehenAdmin
dashboard.settings.updateDashboard-Einstellungen ändernAdmin

Prozessbilder (SCADA)

BerechtigungWas sie erlaubtMindestrolle
dashboard_scada.commands.authorBefehle für Symbole in Prozessbildern erstellenAdmin
dashboard_scada.diagrams.readProzessbilder ansehenBenutzer
dashboard_scada.diagrams.writeProzessbilder erstellen, bearbeiten und löschenAdmin

3D-Entwürfe

BerechtigungWas sie erlaubtMindestrolle
dashboard_viewer.designs.read3D-Entwürfe ansehenBenutzer
dashboard_viewer.designs.write3D-Entwürfe erstellen, bearbeiten und löschenAdmin

Automatisierung (Flows)

BerechtigungWas sie erlaubtMindestrolle
automation.readFlows und den Block-Katalog ansehenAdmin
automation.manageFlows erstellen, bearbeiten und bereitstellenAdmin
automation.manage_privilegedFlows mit Blöcken der Steuerungsebene (Befehle, Einstellungen) bereitstellenAdmin
automation.debugNachrichten einspeisen, Nachrichteninhalte und fehlgeschlagene Nachrichten ansehenAdmin
automation.hooks.callWebhooks bereitgestellter Flows aus einer angemeldeten Sitzung aufrufen (Dashboard-Widgets, App-Seiten)Benutzer

Plattformberechtigungen, die häufig mit IoT verwendet werden

BerechtigungWas sie erlaubtMindestrolle
members.viewMitglieder ansehenBenutzer
members.invite, tenant_invitation.invitations.inviteMitglieder einladen, Einladungen versendenAdmin
members.edit_role, members.suspend, members.removeRolle oder Status eines Mitglieds ändern, sperren, entfernenAdmin
members.manage_ownerInhaber ändern oder entfernenInhaber
members.transfer_ownershipInhaberschaft übertragenInhaber
api_key.keys.read, .create, .update, .deleteAPI-Schlüssel ansehen, erstellen, aktualisieren und widerrufenAdmin
api_key.keys.rotate, api_key.keys.revoke_allAPI-Schlüssel rotieren, alle API-Schlüssel widerrufenInhaber
webhook.endpoints.read, .create, .update, .delete, .test, .triggerWebhook-Endpunkte verwalten, Test- und manuelle Ereignisse sendenAdmin
webhook.endpoints.rotate_secretEin Webhook-Signaturgeheimnis rotierenInhaber
webhook.deliveries.read, .redeliver, .replayZustellungen ansehen, erneut zustellen, fehlgeschlagene erneut abspielenAdmin
audit_log.logs.read, .export, .verifyDas Audit-Protokoll ansehen, exportieren und prüfenAdmin
audit_log.logs.anonymize, audit_log.logs.purgeEinen Akteur anonymisieren (Löschung), abgelaufene Einträge bereinigenInhaber
tenant_usage.metrics.readNutzungsmetriken und Kontingente ansehenAdmin
tenant_usage.settings.updateEinstellungen für Nutzungswarnungen ändernAdmin
tenant_setting.config.read, .updateOrganisationseinstellungen ansehen und ändernAdmin
tenant_session.settings.read, .updateDie Anmelderichtlinie ansehen und ändernAdmin
auth_abac.policies.read, .write, auth_abac.simulate, auth_abac.decisions.readZugriffsrichtlinien, der Simulator und das EntscheidungsprotokollInhaber
auth_saml.config.read, .update, .deleteSAML-Single-Sign-on konfigurierenInhaber
auth_sso.settings.read, .updateSingle-Sign-on-Einstellungen ansehen und ändernAdmin
tenant_domain.domains.create, tenant_domain.domains.deleteEigene Domains hinzufügen und entfernenInhaber
tenant_domain.domains.read, .verifyDomains ansehen, Inhaberschaft prüfenAdmin
tenant_export.data.exportAlle Daten der Organisation exportierenInhaber
tenant_branding.branding.updateBranding ändernAdmin
notification_mail.settings.update, notification_sms.settings.update, notification_push.settings.update, notification_inapp.settings.updateE-Mail-, SMS-, Push- und In-App-Benachrichtigungen ändernAdmin
notification_external.link.manageEigene Chat-Konten verknüpfen oder trennenBenutzer
notification_external.provider.manageChat-Plattformen der Organisation verbinden oder trennenAdmin
ai_firewall.incidents.read, .manage, ai_firewall.settings.manageKI-Firewall-Vorfälle und -Einstellungen ansehen und verwaltenAdmin
mcp_server.connectKI-Assistenten (MCP-Clients) verbindenBenutzer
mcp_server.settings.manageMCP-Einstellungen verwaltenAdmin

Nur-Inhaber-Aktionen

Diese bleiben unabhängig von den Gruppen bei den Inhabern:

AktionBerechtigung
Inhaberschaft übertragen; Inhaber ändern oder entfernenmembers.transfer_ownership, members.manage_owner
SAML-Single-Sign-on konfigurierenauth_saml.config.*
Zugriffsrichtlinienauth_abac.*
Eigene Domains hinzufügen und entfernentenant_domain.domains.create, tenant_domain.domains.delete
Alle Daten exportierentenant_export.data.export
Alle API-Schlüssel rotieren und widerrufenapi_key.keys.rotate, api_key.keys.revoke_all
Webhook-Signaturgeheimnis rotierenwebhook.endpoints.rotate_secret
Rohbefehle sendeniot_rpc.send.raw
Firmware-Signaturschlüssel registrieren und widerrufeniot_ota.keys.manage
Gefährliche Einstellungen eines Geräts änderniot_device_settings.dangerous.write

Die IoT-Gruppenvorlagen

Einstellungen > Zugriffskontrolle > Gruppen > Aus Vorlage… fügt diese Gruppen hinzu. Jede listet nur die Berechtigungen der Module auf, die Ihre Organisation nutzt.

VorlageBerechtigungen
IoT-Operatoriot_device.devices.read, iot_device.devices.update, iot_device.attributes.write
IoT-Betrachteriot_device.devices.read, iot_device.attributes.read, iot_device.bindings.read, iot_device_profile.profiles.read, iot_alarm.read, iot_asset.assets.read, iot_rules.read, iot_rpc.read, iot_ota.read, iot_pki.certificates.read, iot_device_settings.read, iot_gateway.endpoints.read, iot_lorawan.gateways.read, iot_lorawan.devices.read, iot_lorawan.frames.read, iot_lorawan_codecs.read, iot_camera.cameras.read, iot_camera.view_live, iot_camera.snapshots.read, iot_camera.recordings.read

Mitglieder sind standardmäßig User, daher ergänzt eine IoT-Betrachter-Gruppe vor allem die Leseberechtigungen, deren Mindestrolle Admin ist (Gerätoeinstellungen, Zertifikate). Ein IoT-Operator kann Geräte bearbeiten und deren Attribute schreiben, aber keine Zugangsdaten verwalten und keine Geräte anlegen oder löschen.

Keine der beiden Vorlagen erlaubt es einem Mitglied, Befehle über das hinaus zu senden, was seine Rolle zulässt: Basis-Befehle benötigen iot_rpc.send.basic, das jeder User standardmäßig hat. Um zu verhindern, dass Betrachter Board-Steuerungen auslösen, entfernen Sie diese Berechtigung in Zugriffsrechte aus der User-Rolle oder geben Betrachtern eine Rolle und Gruppen ohne sie.

Verwandte Themen