Zugriff auf Webserver und OPC UA-Benutzerverwaltung - TIAPortal

TIA Portal Openness: API für die Automatisierung von Engineering-Workflows
ft:publication_title
TIA Portal Openness: API für die Automatisierung von Engineering-Workflows
Product
TIAPortal
Version
V20
Publication date
01/2025
Language
de-DE
Zugriff auf Webserver und OPC UA-Benutzerverwaltung

Voraussetzung

Anwendung

Sie können mit TIA Portal Openness auf den Webserver und das OPC UA-Submodul von PLCs zugreifen. Es ist möglich, einen Benutzer bis zur Höchstzahl am Webserver und am OPC UA-Submodul von PLCs hinzuzufügen. Dieser Benutzer hat einen Benutzernamen und ein Passwort.

Benutzerverwaltung am Webserver

Sie können die folgenden Vorgänge wie z. B. das Hinzufügen eines Benutzers, das Löschen eines Benutzers und das Festlegen des Passworts am Webserver für alle unterstützten Geräte nur dann durchführen, wenn der Webserver am Modul aktiviert ist.

Wenn der Webserver nicht aktiviert ist, wird durch das Hinzufügen und Löschen von Benutzern und das Festlegen des Passworts eine EngineeringTargetInvocationException ausgelöst. Die Lesevorgänge sind trotzdem verfügbar.

Der Dienst WebServerUserManagement ist für die PLC-Instanz nur der unterstützten Geräte verfügbar. Für alle nicht unterstützten Geräte lautet der Dienst null.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

WebServerUserManagement

{

Navigators WebServerUsers

{

WebServerUserComposition

}

}

Der Dienst stellt einen Navigator namens WebServerUsers zur Verfügung, mit dessen Hilfe eine WebServerUserComposition bezogen werden kann, die die Instanzen von WebServerUser verwaltet.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

WebServerUserComposition

{

WebServerUser Find(string username);

void Create(string username, WebserverUserPermissions permissions,SecureString password);

}

WebServerUser

{

string UserName{get;}

WebserverUserPermissions Permissions {get;set;}

void Delete();

void SetPassword(SecureString password);

}

Programmcode: Aktionen an der WebServerUserComposition

Ändern Sie das folgende Programm, um einen Webserver-Benutzer zu suchen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

WebServerUserComposition webServerUserComposition = WebServerUserManagement.WebServerUsers;

WebServerUser user1 = webServerUserComposition.Find("user1");

Ändern Sie folgenden Programmcode, um einen neuen Webserver-Benutzer mit Berechtigungen für Webserver-Benutzer zu erstellen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

WebServerUserComposition webServerUserComposition = WebServerUserManagement.WebServerUsers;

WebServerUser user1 = webServerUserComposition.Create("user1", WebserverUserPermissions.ReadTagStatus, someSecureString);

Ändern Sie folgenden Programmcode, um den Webserver-Benutzer zu löschen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

WebServerUserComposition webServerUserComposition = WebServerUserManagement.WebServerUsers;

WebServerUser user1 = webServerUserComposition.Find("user1");

user1.Delete();

Ändern Sie folgenden Programmcode, um das aktuelle Passwort des Benutzers durch das neue Passwort zu ersetzen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

WebServerUserComposition webServerUserComposition = WebServerUserManagement.WebServerUsers;

WebServerUser user1 = webServerUserComposition.Find("user1");

user1.SetPassword(someSecureString);

Benutzerverwaltung am OPC UA-Server

Sie können die folgenden Vorgänge wie z. B. das Hinzufügen eines Benutzers, das Löschen eines Benutzers und das Festlegen des Passworts am OPC UA-Server nur dann durchführen, wenn der OPC UA-Server aktiviert ist und der Benutzername und die Passwort-Authentifizierung aktiviert sind.

Wenn diese Voraussetzungen nicht erfüllt sind, wird durch den Vorgang eine EngineeringTargetInvocationException ausgelöst, deren Fehlerdetails besagen, dass die Authentifizierung aktiviert werden muss.

Der Dienst OpcUaUserManagement ist nur am OPC UA-Submodul der PLC verfügbar. Der Dienst ist für alle unterstützten Geräte verfügbar, bei denen das OPC UA-Submodul für das Geräteelement verfügbar ist. Andernfalls wird der Dienst mit dem Wert null zurückgegeben.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

OpcUaUserManagement

{

Navigators OpcUaUsers

{

OpcUaUserComposition

}

}

Der Dienst stellt einen Navigator namens OpcUaUsers zur Verfügung, mit dessen Hilfe eine OpcUaUserComposition bezogen werden kann. Die Zusammensetzung verwaltet die Instanzen von OpcUaUser:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

OpcUaUserComposition

{

OpcUaUser Find(string username);

void Create(string username, SecureString password);

}

OpcUaUser

{

string UserName{get;}

void Delete();

void SetPassword(SecureString password);

}

Programmcode: Aktionen an der OpcUaUserComposition

Ändern Sie folgenden Programmcode, um einen OpcUaUser zu suchen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

OpcUaUserComposition opcUaUserComposition = opcUaUserManagement.OpcUaUsers;

OpcUaUser user1 = opcUaUserComposition.Find("user1");

Ändern Sie folgenden Programmcode, um einen neuen OpcUaUser zu erstellen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

OpcUaUserComposition opcUaUserComposition = opcUaUserManagement.OpcUaUsers;

opcUaUserComposition.Create("user1", someSecureString);

Ändern Sie folgenden Programmcode, um den OpcUaUser zu löschen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

OpcUaUserComposition opcUaUserComposition = opcUaUserManagement.OpcUaUsers;

OpcUaUser user = opcUaUserComposition.Find("user1");

user.Delete();

Ändern und verwenden Sie folgenden Programmcode, um das aktuelle Passwort durch ein bereitgestelltes zu ersetzen:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

OpcUaUserComposition opcUaUserComposition = opcUaUserManagement.OpcUaUsers;

OpcUaUser user = opcUaUserComposition.Find("user1");

user.SetPassword(someSecureString);