Remote-RED

Erste Schritte für Partner

Diese Anleitung richtet sich an neue Partner und führt durch die ersten Schritte: vom Partner-Konto im Partner-Portal bis zur Einrichtung der ersten Remote-RED Instanzen.

1. Was ist das Remote-RED Partner-Programm?

Mit dem Partner-Programm kannst Du Remote-RED (Fernzugriff, Push-Notifications und Geofencing für Node-RED) in Deine eigenen Produkte und Projekte einbetten, ohne selbst eine App entwickeln zu müssen.

Der zentrale Unterschied zur normalen Nutzung: Instanzen, die Du mit Deinen Partner-Zugangsdaten (CustomerHash und CustomerKey) anlegst, hängen an Deinem Partner-Konto und werden über Dich abgerechnet. Deine Endkunden benötigen in der App keine InApp-Käufe und zahlen nichts an uns. Alle freigeschalteten Funktionen stehen ihnen direkt zur Verfügung.

Die Abrechnung erfolgt nachträglich (Post-Paid) nach der tatsächlich genutzten Instanzzahl, wahlweise monatlich oder jährlich. Es gelten Staffelpreise, die mit steigender Instanzzahl sinken. Bezahlt wird per Kreditkarte oder SEPA-Lastschrift über Stripe, Rechnungen erhältst Du als E-Rechnung im ZUGFeRD-Format.

Darüber hinaus gibt es zwei optionale Erweiterungen:

  • Eigener Server: Deine Instanzen laufen auf einem eigenen, exklusiv für Dich betriebenen Remote-RED Server.
  • App mit eigenem Branding: Eine eigene Variante der Remote-RED App mit Deinen Farben, Deinem Logo und Deinen Texten.

Beide Erweiterungen werden nach initialem Einrichtungsaufwand plus monatlicher bzw. jährlicher Wartungsgebühr berechnet. Die aktuellen Preise dafür und für die Instanzen findest Du unter portal.remote-red.com/price.

Das Programm ist gedacht für:

  • IoT-Projekt-Entwickler, die ihren Node-RED-Projekten eine App mit Fernzugriff und Push-Benachrichtigungen mitgeben wollen
  • Smart-Home-Installateure, die Kundensysteme aufbauen und Remote-RED für ihre Kunden bereitstellen wollen
  • Hersteller und Plattformen, die eine White-Label-Lösung mit eigenem Branding suchen

Mehr Informationen findest Du auf der Partner-Seite.

2. Das Partner-Portal

Das Partner-Portal erreichst Du unter portal.remote-red.com. Es ist Self-Service: Registrierung, Kontingent, Zahlungsmethode und Rechnungen verwaltest Du selbst.

Registrieren und Anmelden

  1. Registriere Dich auf der öffentlichen Registrierungsseite. Dort siehst Du die Preise, wählst die gewünschten Funktionen (Fernzugriff, Notifications, GeoFencing) und gibst Deine Stammdaten an. Das Programm richtet sich an Geschäftskunden.
  2. Bestätige Deine E-Mail-Adresse (Double-Opt-in). Dein Konto ist danach sofort mit einem Start-Kontingent aktiv.
  3. Die Anmeldung ist passwortlos: Du gibst Deine E-Mail-Adresse ein und erhältst einen Link zum Einloggen.
  4. Optional kannst Du 2FA über Authenticator Apps nutzen, was wir auch empfehlen.

Die wichtigsten Bereiche

  • Dashboard: Überblick über Deine aktuelle Nutzung und Dein Instanz-Kontingent. Hier kannst Du das Kontingent auch selbst erhöhen, wenn Du wächst.
  • Konto: Hier findest Du Deinen CustomerHash und Deinen CustomerKey. Diese beiden Werte brauchst Du, um Instanzen Deinem Partner-Konto zuzuordnen (siehe Kapitel 3 und 4).
  • Instanzen: Liste aller Instanzen Deines Kontos, inklusive der optionalen Kunden-Referenz. Nicht mehr benötigte Instanzen kannst Du hier selbst deaktivieren.
  • Funktionen: Fernzugriff, Notifications und GeoFencing selbst an- und abschalten. Abgerechnet wird der Stand zum Rechnungszeitpunkt.
  • Preise: Deine Staffelpreise je Funktion und Instanz. Alle Preise sind Jahrespreise netto zuzüglich Umsatzsteuer, bei monatlicher Abrechnung gilt 1/12.
  • Zahlung: Zahlungsmethode bei Stripe hinterlegen (Kreditkarte oder SEPA-Lastschrift).
  • Rechnungen: Alle Rechnungen als PDF, zusätzlich automatischer Versand per E-Mail.

Empfohlene erste Schritte im Portal

  1. 2FA per Authenticator App aktivieren
  2. Zahlungsmethode hinterlegen
  3. CustomerHash und CustomerKey aus dem Bereich Konto kopieren
  4. Erste Instanz anlegen (siehe unten)

3. Instanzen über die Node-RED Nodes einrichten

Die Remote-RED Nodes installierst Du in Node-RED über die Palette, das Paket heißt node-red-contrib-remote.

So legst Du eine Instanz an, die Deinem Partner-Konto zugeordnet ist:

  1. Ziehe einen Remote Access Node in einen Flow und erstelle für diese eine Konfigurations-Node.
  2. Aktiviere die Checkbox “Ich bin Teilnehmer am Remote-RED Partner Programm”. Es öffnet sich der Partner-Bereich.
  3. Trage Deinen CustomerHash und Deinen CustomerKey ein.
  4. Optional: Trage eine Kunden-Referenz ein, zum Beispiel eine Seriennummer oder Endkunden-Nummer (maximal 100 Zeichen). Sie dient der Zuordnung der Instanz im Partner-Portal und ist nachträglich nicht mehr änderbar.
  5. Wähle die Server-Region (us, de oder sg) und schließe die Registrierung der Instanz wie gewohnt über den Registrierungs-Button ab.

Wichtig: Der CustomerKey wird nur einmalig bei der Registrierung verwendet und nicht in Node-RED gespeichert. Die Zuordnung zum Partner-Konto passiert beim Anlegen der Instanz und kann nachträglich nicht geändert werden.

Danach funktioniert alles wie bei einer normalen Instanz: QR-Code mit der App scannen, fertig. Der Unterschied ist nur, dass die Instanz auf Deinem Partner-Konto läuft und Deine freigeschalteten Funktionen ohne InApp-Käufe nutzbar sind.

4. Instanzen über die CLI einrichten

Für die automatisierte Einrichtung, zum Beispiel in der Fertigung von IoT-Geräten, gibt es die Remote-RED CLI. Sie legt den Remote Access Node samt Konfigurations-Node direkt über die Admin-API von Node-RED an und aktiviert die Instanz gegen die Remote-RED Server.

Voraussetzungen: node-red-contrib-remote ist im Ziel-Node-RED installiert und die HTTP Admin API von Node-RED ist erreichbar.

Installation:

npm i -g node-red-contrib-remote-cli

Instanz mit Partner-Zuordnung anlegen:

node-red-contrib-remote-cli configure \
  --flowname RemoteAccess \
  --name RemoteAccess \
  --region de \
  --customerhash <DEIN_CUSTOMERHASH> \
  --customerkey <DEIN_CUSTOMERKEY> \
  --customerreference SN-12345

Hinweise:

  • --customerreference ist optional und funktioniert wie im Node: maximal 100 Zeichen, nachträglich nicht änderbar, dient der Zuordnung im Partner-Portal.
  • --region akzeptiert us, de und sg. Alternativ kann mit --server ein Server direkt angegeben werden.
  • Mit --url gibst Du die Basis-URL von Node-RED an (Standard: http://localhost:1880).
  • Mit --jsonoutput true liefert die CLI alle Daten als JSON, praktisch für Skripte in Fertigungsprozessen.
  • Die CLI erzeugt einen QR-Code und einen Deeplink zum Verbinden der App. Für bestehende Instanzen erstellt der Befehl registerapp weitere App-Install-QR-Codes.

Die vollständige Hilfe gibt es mit node-red-contrib-remote-cli --help und node-red-contrib-remote-cli configure --help.

5. Ausblick: Der Remote-RED Agent

Neben Node-RED und Home Assistant entsteht aktuell eine dritte Möglichkeit, Remote-RED zu nutzen: der Remote-RED Agent, ein einzelnes Binary (remotered) für Linux-Systeme wie Server, NAS, Raspberry Pi oder IoT-Geräte. Er kann zwei Dinge:

  • Fernzugriff auf eine beliebige lokale Web-UI (zum Beispiel Grafana, Cockpit oder OctoPrint) über die Remote-RED Apps, mit derselben Technik wie bei Node-RED.
  • Push-Notifications aus Skripten: remotered notify --title "Backup" --body "Fertig" schickt eine Nachricht aufs Handy, ideal für Cronjobs und Monitoring.

Das Partner-Programm wird dabei genauso unterstützt wie in den Nodes und der CLI: Agent-Instanzen lassen sich per CustomerHash und CustomerKey Deinem Konto zuordnen und laufen über die normale Instanzabrechnung. Der Agent ist noch in Entwicklung.

Fragen?

Bei Fragen erreichst Du uns per E-Mail unter info@remote-red.com.