From 166d185f61afc414d4ca8cea5878cc0e136a493c Mon Sep 17 00:00:00 2001
From: Jan Ulrich Hasecke <jan.ulrich@hasecke.com>
Date: Fri, 16 Apr 2021 13:27:06 +0200
Subject: [PATCH] Passwort E-Mail-Benutzer ändern

---
 source/mail/index.rst              |   68 ++++++++++++++++++++++++++++++++++
 source/referenz/benutzer/index.rst |    2 +
 2 files changed, 70 insertions(+), 0 deletions(-)

diff --git a/source/mail/index.rst b/source/mail/index.rst
index 2f2ca92..4f81df0 100644
--- a/source/mail/index.rst
+++ b/source/mail/index.rst
@@ -165,3 +165,71 @@
    Hostsharing unterstützt verschlüsselte Verbindungen über STARTTLS
    und SSL/TLS auf unterschiedlichen Ports. Lesen Sie dazu
    :numref:`kap-ref-maileingang` und :numref:`kap-ref-mailausgang`.
+
+E-Mail-Passwort ändern
+======================
+
+E-Mail-Benutzer können ihr Passwort über HSAdmin und teilweise auch per SSH ändern.
+Falls dem E-Mail-Benutzer vom Paket-Admin als Shell das Programm :program:`/bin/false` zugeteilt wurde, lässt sich das Passwort nur über HSAdmin ändern.
+Hat der E-Mail-Benutzer dagegen als Shell das Programm :program:`/usr/bin/passwd`, so kann er sein Passwort auch per SSH ändern.
+Die Hintergründe werden in :numref:`kap-benutzerrechte` erklärt.
+
+E-Mail-Passwort in HSAdmin ändern
+---------------------------------
+
+Der Benutzer meldet sich mit seinem E-Mail-Benutzername in HSAdmin an.
+Anschließend klickt er oben rechts auf seinen Benutzernamen.
+Es öffnet sich ein Menü, in dem ein neues Passwort eingetragen werden kann.
+Die Prozedur wurde bereits in :numref:`kap-erstes-einloggen` beschrieben.
+
+..
+   .. only:: html
+
+      .. raw:: html
+
+         <video width="786" height="590" controls src="https://media.hostsharing.net/Passwort-fuer-E-Mail-Benutzer-via-HSAdmin-aendern.webm"></video>
+
+
+E-Mail-Passwort per SSH ändern
+------------------------------
+
+Der Benutzer meldet per SSH im Webpaket an und ändert mit dem Programm :program:`passwd` sein Passwort.
+Falls der E-Mail-Benutzer eine interaktive Shell hat, muss er dazu das Programm eigens aufrufen.
+Wurde ihm jedoch lediglich das Programm :program:`/usr/bin/passwd` zugewiesen, öffnet sich statt einer interaktiven Sitzung sofort das Programm :program:`passwd`:
+
+.. code-block:: text
+
+  $ ssh xyz00-mail@xyz00.hostsharing.net
+  xyz00-mail@xyz00.hostsharing.net's password:
+
+Nach Eingabe des aktuellen Passworts wird sofort :program:`passwd` gestartet und erneut das aktuelle Passwort abgefragt:
+
+.. code-block:: text
+                
+  Changing password for xyz00-mail.
+  Current password: 
+
+Nach einer erneuten Eingabe des aktuellen Passworts kann der Benutzer zweimal ein neues eingeben.
+Anschließend erscheint eine Erfolgsmeldung und die Verbindung wird geschlossen:
+
+.. code-block:: text
+                
+  New password: 
+  Retype new password: 
+  passwd: password updated successfully
+  Connection to xyz00.hostsharing.net closed.
+
+Damit ist das neue Passwort gesetzt.
+
+.. attention::
+
+   Bitte vergessen Sie nicht das neue Passwort in Ihr E-Mail-Programm einzutragen.
+
+..
+   .. only:: html
+
+      .. raw:: html
+
+         <video width="786" height="590" controls src="https://media.hostsharing.net/Passwort-fuer-E-Mail-Benutzer-via-SSH-aendern.webm"></video>
+
+
diff --git a/source/referenz/benutzer/index.rst b/source/referenz/benutzer/index.rst
index b656ee7..1e4b371 100644
--- a/source/referenz/benutzer/index.rst
+++ b/source/referenz/benutzer/index.rst
@@ -140,6 +140,8 @@
      
    Weitere Informationen zum Domain-Bestell-System unter :doc:`Domainverwaltung<../domain/domainverwaltung>`.
 
+.. _kap-benutzerrechte:
+   
 ==============
 Benutzerrechte
 ==============

--
Gitblit v1.9.3