Skip to content

Commit 8ff2e5c

Browse files
committed
restructure content, modify images, update tooptip text
1 parent 1cc5655 commit 8ff2e5c

File tree

5 files changed

+19
-64
lines changed

5 files changed

+19
-64
lines changed
-47.1 KB
Loading
7.47 KB
Loading
-169 KB
Binary file not shown.
221 KB
Loading

source/adminguide/accounts.rst

Lines changed: 19 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -902,7 +902,7 @@ password for a user:
902902
:align: center
903903

904904
Enforce Password Change for Users
905-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
905+
---------------------------------
906906

907907
Since version 4.23.0, CloudStack provides a security feature that allows administrators to
908908
**enforce a password change on the next login** for a User. This feature
@@ -921,7 +921,7 @@ When password change enforcement is enabled for a User:
921921
- Until the password is changed, no other UI actions or API operations are permitted.
922922

923923
Ways to Enforce Password Change
924-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
924+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
925925

926926
Password change enforcement can be applied in the following ways.
927927

@@ -931,12 +931,6 @@ Password change enforcement can be applied in the following ways.
931931
When creating a new User, administrators can choose to **enforce a
932932
password change on the User’s first login**.
933933

934-
This is particularly useful when:
935-
936-
- Initial passwords are set by administrators
937-
- Accounts are created in bulk
938-
- Temporary passwords are issued to new Users
939-
940934
**UI Flow:**
941935

942936
#. Navigate to **Accounts → Users**.
@@ -948,9 +942,11 @@ This is particularly useful when:
948942
.. figure:: /_static/images/enforce-password-change-on-create.png
949943
:align: center
950944
:alt: Enforce password change during user creation
945+
:width: 400px
951946

952-
Upon first login, the User must change their password before accessing
953-
any resources.
947+
.. raw:: html
948+
949+
<br>
954950

955951
2. Enforce Password Change When Changing a User Password
956952
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""
@@ -959,51 +955,44 @@ When an administrator changes a User’s password, CloudStack allows the
959955
administrator to **require the User to change the password on their next
960956
login**.
961957

962-
This ensures that:
963-
964-
- Administrators do not permanently know User passwords.
965-
- Temporary or reset passwords are only valid for a single login.
966-
967958
**UI Flow:**
968959

969960
#. Navigate to **Accounts → Users**.
970961
#. Open the required User details page.
971962
#. Select **Change Password**.
972963
#. Enable **User must change password at next login**.
973-
#. Save the changes.
964+
#. Change the password.
974965

975966
.. figure:: /_static/images/enforce-password-change-on-update.png
976967
:align: center
977968
:alt: Enforce password change when updating user password
969+
:width: 400px
970+
971+
.. raw:: html
978972

979-
At the next login, the User must immediately choose a new password.
973+
<br>
980974

981975
3. Enforce Password Change Without Changing the Password (Quick Action)
982976
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
983977

984978
Administrators can enforce a password change **without modifying the
985-
current password**. This is useful when enforcing security policies such
986-
as:
987-
988-
- Periodic password rotation
989-
- Organization-wide password policy updates
990-
- Suspected credential exposure
991-
979+
current password**.
992980
A **Quick Action** is available directly from the User details page.
993981

994982
**UI Flow:**
995983

996984
#. Navigate to **Accounts → Users**.
997985
#. Open the required User details page.
998-
#. Click **Enforce Password Change** from the actions menu.
986+
#. Click **Force password reset** from the actions menu.
999987
#. Confirm the action.
1000988

1001-
.. figure:: /_static/images/enforce-password-change-quick-action.png
989+
.. figure:: /_static/images/force-password-reset-quick-action.png
1002990
:align: center
1003-
:alt: Enforce password change using quick action
991+
:alt: Force password reset using quick action
992+
993+
.. raw:: html
1004994

1005-
The User will be forced to change their password on the next successful
1006-
login, even though their current password remains valid for authentication.
995+
<br>
1007996

1008997
User Login Experience
1009998
^^^^^^^^^^^^^^^^^^^^^
@@ -1020,41 +1009,7 @@ When enforcement is active, the User login flow is as follows:
10201009
.. figure:: /_static/images/force-password-change-login.png
10211010
:align: center
10221011
:alt: User prompted to change password after login
1023-
1024-
Permissions and Scope
1025-
^^^^^^^^^^^^^^^^^^^^^
1026-
1027-
- **Root Administrators** and **Domain Administrators** can enforce password changes for any User in the system.
1028-
- Regular Users cannot enforce password changes for themselves or others.
1029-
1030-
API Support
1031-
^^^^^^^^^^^
1032-
1033-
Password change enforcement can also be managed using CloudStack APIs when
1034-
updating a User.
1035-
Refer to the API documentation for the ``createUser`` and ``updateUser``
1036-
commands for details on password change enforcement parameters.
1037-
1038-
Notes and Limitations
1039-
^^^^^^^^^^^^^^^^^^^^^
1040-
1041-
.. note::
1042-
1043-
- This feature applies only to **CloudStack-managed username/password
1044-
authentication**.
1045-
- Enforcement of password change is not supported for Users authenticated via **LDAP, SAML, or OAuth2**.
1046-
- API key and secret key-based authentication is not affected by
1047-
password change enforcement.
1048-
1049-
Security Benefits
1050-
^^^^^^^^^^^^^^^^^
1051-
1052-
Enforcing password changes helps administrators:
1053-
1054-
- Reduce the risk of credential reuse
1055-
- Comply with organizational security standards
1056-
- Safely assist Users during account recovery
1057-
- Enforce password rotation policies without service disruption
1012+
:width: 400px
10581013

10591014
Using API Key and Secret Key based Authentication
10601015
-------------------------------------------------

0 commit comments

Comments
 (0)