> For the complete documentation index, see [llms.txt](https://docs.enlyze.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enlyze.com/integrations/opc-ua-server.md).

# OPC-UA-Server

OPC-UA-Client mit dem OPC-UA-Server des Edge Device verbinden.

Das Edge Device kann die Live-Werte seiner Datenquellen über einen eigenen OPC-UA-Server bereitstellen. In dieser Anleitung richtest du den OPC-UA-Server auf dem ENLYZE Edge Device ein und liest die Daten mit einem OPC-UA-Client aus. Beispielsweise mit einem MES System, zur Demo mit UaExpert etc.

Der OPC-UA-Server läuft direkt auf dem Edge Device und ist im lokalen Netzwerk erreichbar. Er liefert die aktuellen Werte aller Variablen, die das Edge Device ausliest, aber keine Historie und keinen Produktionskontext. Für gespeicherte Zeitreihen, Aufträge oder OEE nutze die [Schnellstart](https://docs.enlyze.com/enlyze-api/schnellstart.md).

In der ENLYZE Platform richtest du den Server als **Datensenke** ein. Eine Datensenke legt fest, wohin ein Edge Device seine Daten weitergibt. Jedes Edge Device hat eine Datensenke für die ENLYZE Platform, die ENLYZE verwaltet.

## Voraussetzungen

* Das Edge Device ist online und liest Daten aus mindestens einer Datenquelle aus.
* Der Rechner mit dem OPC-UA-Client erreicht das Edge Device im Netzwerk.
* Du kannst in der ENLYZE Platform die Datensenken des Edge Device bearbeiten.

## OPC-UA-Server anlegen

1. Öffne in der Seitenleiste **Edge Devices** und wähle das Edge Device aus.
2. Öffne den Tab **Datensenken** und klicke auf **Datensenke anlegen**.
3. Wähle als **Typ** **OPC UA**.
4. Prüfe die Einstellungen (siehe Tabelle unten) und lege mindestens einen Benutzer an.
5. Klicke auf **Speichern**.

Das Edge Device übernimmt die Konfiguration automatisch und startet den Server.

| Einstellung                                | Standard                         | Bedeutung                                                                      |
| ------------------------------------------ | -------------------------------- | ------------------------------------------------------------------------------ |
| **Anwendungsname**                         | `ENLYZE OPC UA @ <Edge Device>`  | Name, unter dem der Server im Client erscheint                                 |
| **Port**                                   | `4840`                           | TCP-Port des Servers                                                           |
| **Minimale Transportsicherheit**           | SHA-256-Richtlinien oder stärker | Schwächste Security Policy, die der Server anbietet                            |
| **Sign & Encrypt erfordern**               | An                               | Erlaubt nur verschlüsselte Verbindungen, keine rein signierten                 |
| **Minimale Sicherheit für Passwort-Token** | SHA-256-Richtlinien oder stärker | Schwächste Security Policy, mit der ein Client das Passwort verschlüsseln darf |
| **Anonyme Anmeldung erlauben**             | Aus                              | Anmeldung ohne Benutzername und Passwort                                       |
| **Benutzer**                               | keine                            | Benutzername und Passwort (mindestens 6 Zeichen) für die Anmeldung             |

Ein Edge Device hat höchstens einen OPC-UA-Server. Den Typ einer Datensenke kannst du nachträglich nicht ändern. Bearbeiten oder löschen kannst du den Server über das Menü in seiner Zeile im Tab **Datensenken**.

Passwörter speichert ENLYZE nur als Hash. Ein vergessenes Passwort kannst du deshalb nicht nachschlagen: Entferne den Benutzer und füge ihn mit einem neuen Passwort wieder hinzu.

## Server-URL zusammensetzen

Die Server-URL hat das Format:

```
opc.tcp://<IP-Adresse des Edge Device>:<Port>
```

1. Öffne den Tab **Übersicht** des Edge Device. Unter **Netzwerkkarten** siehst du die IP-Adressen des Edge Device.
2. Wähle die IP-Adresse der Netzwerkkarte, die im selben Netzwerk wie der OPC-UA-Client liegt.
3. Den Port findest du im Tab **Datensenken** in der Spalte **Port** (Standard `4840`).

Beispiel: Die Netzwerkkarte zur Maschine hat die IP-Adresse `192.168.10.25`, der Port ist `4840`. Die Server-URL lautet `opc.tcp://192.168.10.25:4840`.

{% hint style="warning" %}
Steht in der Spalte **Vergabe** einer Netzwerkkarte **Dynamisch via DHCP**, kann sich ihre IP-Adresse ändern. Für eine dauerhafte Verbindung sollte das Edge Device in diesem Netzwerk eine feste IP-Adresse haben, entweder statisch über [Netzwerk konfigurieren](https://docs.enlyze.com/connect/edge-device/enlyze-edge/netzwerk-konfigurieren.md) oder über eine DHCP-Reservierung.
{% endhint %}

Die angezeigten IP-Adressen meldet das Edge Device selbst. Ist es offline, zeigt die ENLYZE Platform den Stand der letzten Verbindung an.

## OPC-UA-Client verbinden

### Server-URL direkt eintragen

Trage die Server-URL im Client als **Endpoint URL** (oder **Server URL**) ein.

{% hint style="warning" %}
Nutze nicht die automatische Suche des Clients (zum Beispiel **Discovery** oder **Get Endpoints**). Der Server meldet dort die Adresse `opc.tcp://0.0.0.0:4840`, über die keine Verbindung möglich ist. Falls dein Client nur über die Suche verbindet, ersetze in der gefundenen Adresse `0.0.0.0` durch die IP-Adresse des Edge Device.
{% endhint %}

### Security Policy und Security Mode wählen

Welche Kombinationen der Server annimmt, hängt von den Einstellungen des OPC-UA-Servers ab:

| Minimale Transportsicherheit                         | Security Policies                                                 |
| ---------------------------------------------------- | ----------------------------------------------------------------- |
| SHA-256-Richtlinien oder stärker                     | `Basic256Sha256`, `Aes128_Sha256_RsaOaep`, `Aes256_Sha256_RsaPss` |
| SHA-1-Richtlinien oder stärker (veraltet)            | zusätzlich `Basic256` und `Basic128Rsa15`                         |
| Keine (bietet auch einen unverschlüsselten Endpunkt) | zusätzlich `None`                                                 |

Als **Security Mode** wählst du **Sign & Encrypt**. **Sign** funktioniert nur, wenn **Sign & Encrypt erfordern** ausgeschaltet ist. Dasselbe gilt für die Policy `None` mit dem Mode **None**: Ist **Sign & Encrypt erfordern** eingeschaltet, lehnt der Server solche Verbindungen ab, auch wenn er den unverschlüsselten Endpunkt anbietet.

Empfohlen ist `Basic256Sha256` mit **Sign & Encrypt**.

### Anmelden

* **Benutzername und Passwort**: Melde dich mit einem der Benutzer des OPC-UA-Servers an.
* **Anonym**: Nur möglich, wenn **Anonyme Anmeldung erlauben** eingeschaltet ist.

Eine Anmeldung per Client-Zertifikat unterstützt der Server nicht.

### Zertifikate

Das Edge Device erzeugt das Zertifikat des Servers beim ersten Start selbst. Wenn dein Client fragt, ob er dem Server-Zertifikat vertrauen soll, bestätige das. Der Fingerabdruck des Zertifikats wird in der ENLYZE Platform derzeit nicht angezeigt.

Das Client-Zertifikat musst du nicht auf dem Edge Device hinterlegen. Der Server akzeptiert das Zertifikat jedes Clients, die Zugriffskontrolle erfolgt über die Anmeldung.

## Daten im Adressraum finden

Unter **Objects** liegt für jede Datenquelle des Edge Device ein Objekt mit dem Namen der Datenquelle. Darin findest du ihre Variablen unter ihrem Display-Namen.

| Knoten      | NodeId                          |
| ----------- | ------------------------------- |
| Datenquelle | `ns=1;g=<UUID der Datenquelle>` |
| Variable    | `ns=1;g=<UUID der Variable>`    |

Die NodeIds bleiben stabil, solange die Datenquelle und die Variable bestehen. Clients, die Datenpunkte über die NodeId zuordnen, verlieren die Zuordnung also nicht, wenn du einen Display-Namen änderst. Die UUIDs liefert auch die [Schnellstart](https://docs.enlyze.com/enlyze-api/schnellstart.md).

Für die Werte gilt:

* Jede Variable zeigt ihren aktuellsten Wert, mit angewendetem Skalierungsfaktor.
* Liefert eine Variable 10 Sekunden lang keinen neuen Wert, ist ihr Wert leer.
* Die Variablen sind nur lesbar. Schreibzugriffe lehnt der Server mit `BadNotWritable` ab.

## Verbindung prüfen

Die Verbindung steht, wenn der Client unter **Objects** die Datenquellen des Edge Device anzeigt und sich die Werte der Variablen aktualisieren.

## Troubleshooting

| Problem                                   | Mögliche Ursache und Lösung                                                                                                                                   |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Keine Verbindung, Timeout                 | Der Client erreicht das Edge Device nicht. Prüfe, ob IP-Adresse und Port stimmen, ob beide im selben Netzwerk liegen und ob eine Firewall den Port blockiert. |
| Verbindung zu `0.0.0.0` schlägt fehl      | Der Client nutzt die Adresse aus der automatischen Suche. Trage die Server-URL direkt ein (siehe oben).                                                       |
| Server lehnt Verbindung oder Anmeldung ab | Security Policy oder Security Mode passen nicht zu den Einstellungen des Servers, oder Benutzername und Passwort stimmen nicht.                               |
| Datenquelle oder Variable fehlt           | Der Server zeigt nur Datenquellen und Variablen, die das Edge Device ausliest. Neue Variablen erscheinen, sobald das Edge Device sie ausliest.                |
| Werte sind leer                           | Die Variable hat seit mehr als 10 Sekunden keinen neuen Wert geliefert. Prüfe die Verbindung des Edge Device zur Datenquelle.                                 |

## Nächste Schritte

* [Sicherheit](https://docs.enlyze.com/connect/sicherheit.md): In welchen Netzwerken der OPC-UA-Server erreichbar ist
