IPS_SetRemoteAccessPassword

Benötigt: Symcon >= 9.1

 void IPS_SetRemoteAccessPassword (string $Passwort) 

Parameterliste

Rückgabewert

Keine Rückgabe

Beschreibung

Die Funktion setzt oder ändert das Passwort für den Fernzugriff auf die Verwaltungskonsole. Der Benutzername für den Fernzugriff ist immer die E-Mail-Adresse des Lizenznehmers (siehe IPS_GetLicensee). Daher muss vor dem Aufruf eine gültige Lizenz in Symcon eingerichtet sein (siehe Lizenz ändern). Andernfalls schlägt die Funktion mit "Cannot set the remote access password without a valid license!" fehl.

Wird für Passwort ein leerer String übergeben, wird das Fernzugriffspasswort entfernt. Der Fernzugriff ist dann deaktiviert, bis ein neues Passwort gesetzt wird.

Die Änderung wirkt sofort, ein Neustart von IP-Symcon ist nicht erforderlich. Das Passwort wird unter Windows in der Registrierung und auf allen anderen Plattformen in der Datei .symcon gespeichert, in die es bisher von Hand eingetragen werden musste. Ob ein Passwort gesetzt ist, liefert IPS_HasRemoteAccessPassword; das Passwort selbst kann nicht ausgelesen werden.

Der aktuell angemeldete Benutzer (siehe IPS_GetLoggedInUser) muss Administrator sein, also der Benutzer @admin oder ein Benutzer mit der Rolle @admin. Andernfalls schlägt die Funktion mit "Administrator permissions are required for this action!" fehl. Ohne Anmeldung, z.B. beim Zugriff im lokalen Netzwerk, solange noch kein Fernzugriffspasswort gesetzt ist, ist der Aufruf erlaubt, damit eine neue Installation eingerichtet werden kann.

Beispiel

IPS_SetRemoteAccessPassword('geheim'); // Fernzugriffspasswort setzen
IPS_SetRemoteAccessPassword(''); // Fernzugriffspasswort entfernen, der Fernzugriff ist damit deaktiviert