Merge pull request #95 from netwrix/kim/passwordreset-3.23-sidebar

Kim/passwordreset 3.23 sidebar

Author: kim-horvatin-netwrix

docs/passwordreset/3.23/administration/configuring_password_reset.md

@@ -6,7 +6,7 @@ sidebar_position: 40
 
 # Configuring Password Reset
 
-Click **Start** > **ANIXIS Password Reset** > **APR Configuration Console**on the Password Reset
+Click **Start** > **ANIXIS Password Reset** > **APR Configuration Console** on the Password Reset
 Server computer to open the Configuration Console.
 
 ## General Tab
@@ -33,9 +33,12 @@ Follow the steps below to add a domain to the list.
 
 **Step 3 –** Click **OK**, and then click **Apply**.
 
-**NOTE:** The most frequently used domain should be first in the list as it will be the default. You
+:::note
+The most frequently used domain should be first in the list as it will be the default. You
 can rearrange the domains by dragging them to another position. You can also click Sort to sort them
 alphabetically.
+:::
+
 
 Remove a Domain from the list
 
@@ -87,7 +90,7 @@ Password Reset is a configurable password filter that enforces granular password
 advanced features. Password Reset can integrate with Password Policy Enforcer to help users choose a
 compliant password.
 
-![configuring_apr_1](/img/product_docs/passwordreset/3.23/evaluation/configuring_apr_1.webp)
+![configuring_apr_1](/img/product_docs/passwordreset/3.23/administration/change.webp)
 
 Password Reset displays the Password Policy Enforcer policy message when users are prompted for
 their new password, and the Password Policy Enforcer rejection message if the new password does not
@@ -105,13 +108,14 @@ more detailed Rejection message when this registry value is set. Users may also
 policy, or no policy enforced if the queried server is not a domain controller in the user's
 domain.  
 Queries to the Password Policy Server are sent to UDP port 1333 by default. You may need to create
-firewall rules to open this port. See the
-[Creating Firewall Rules for the PPC](/docs/passwordreset/3.23/password_policy_enforcer/administration/password_policy_client.md#creating-firewall-rules-for-the-ppc)
-topic for more information.
+firewall rules to open this port. 
 
-**NOTE:** Password Policy Enforcer is not included with Password Reset. Go to
+:::note
+Password Policy Enforcer is not included with Password Reset. Go to
 [www.netwrix.com/password_policy_enforcer](https://www.netwrix.com/password_policy_enforcer.html) to
 learn more about Password Policy Enforcer.
+:::
+
 
 ## Enroll Tab
 
@@ -148,10 +152,13 @@ Follow the steps below to remove a question from the list.
 
 **Step 4 –** Click **Apply**.
 
-**NOTE:** You can rearrange questions by dragging them. You can also replace question lists with
+:::note
+You can rearrange questions by dragging them. You can also replace question lists with
 text boxes so users can enter their own questions. See the
 [Editing the HTML Templates](/docs/passwordreset/3.23/administration/editing_the_html_templates.md)
 document for more information
+:::
+
 
 ### Options
 
@@ -184,8 +191,11 @@ Select the **Save e-mail to a pickup folder** option if APR should save e-mails
 delivery by a mail server. Click **Browse...** to select a folder. The mail server must monitor this
 folder for new e-mail.
 
-**NOTE:** Saving e-mail to a pickup folder is the fastest and most reliable delivery method. Use
+:::note
+Saving e-mail to a pickup folder is the fastest and most reliable delivery method. Use
 this option if your mail server supports pickup folders.
+:::
+
 
 ### Triggers
 
@@ -209,9 +219,12 @@ use these macros.
 | [AD_OR_APR_EMAIL] | The e-mail address in AD, or the e-mail address in Password Resetif the AD address is blank   |
 | [APR_OR_AD_EMAIL] | The e-mail address in APR, or the e-mail address in AD if the Password Reset address is blank |
 
-**NOTE:** Use [APR_OR_AD_EMAIL] with caution as Password Reset does not check the validity of e-mail
+:::note
+Use [APR_OR_AD_EMAIL] with caution as Password Reset does not check the validity of e-mail
 addresses. If the e-mail address in Password Reset's database is no longer valid, then the alert is
 only sent to the invalid address.
+:::
+
 
 Type additional recipient e-mail addresses in the **Bcc** text box if you want to send any blind
 carbon copies. Separate multiple recipients with a semicolon.
@@ -241,13 +254,16 @@ understand their e-mail alerts.
 
 ![configuring_apr_5](/img/product_docs/passwordpolicyenforcer/10.2/password_reset/administration/configuring_npr_5.webp)
 
-**CAUTION:** An attacker may choose a specific language to avoid detection. E-mail alerts are sent
+:::warning
+An attacker may choose a specific language to avoid detection. E-mail alerts are sent
 in the Web Interface language chosen by the attacker if the target user has not enrolled or changed
 their password with Password Reset. The target user will receive the e-mail alerts, but they may not
 understand them. Use the Rest API to remind new users to enroll so their preferred language is known
 to Password Reset. See the
 [Enabling the API](/docs/passwordreset/3.23/administration/persuading_users_to_enroll.md#enabling-the-api)
 topic for additional information.
+:::
+
 
 ## Verification Tab
 
@@ -356,10 +372,13 @@ The user's Active Directory mobile phone number is read from the mobile attribut
 **AD Attribute** if you want to use a phone number from a different attribute. Type the name of the
 attribute, and then click **OK**.
 
-**NOTE:** Use a script to perform additional processing before sending the SMS. For example, a
+:::note
+Use a script to perform additional processing before sending the SMS. For example, a
 script could read the user's phone number from a database, or send a language-specific SMS based on
 the value of the [LANG] macro. Put the path of the scripting engine executable in the **Command**
 text box, and the path to the script file and other parameters in the **Parameters** text box.
+:::
+
 
 ![configuring_apr_7](/img/product_docs/passwordpolicyenforcer/10.2/password_reset/administration/configuring_npr_7.webp)
 
@@ -398,12 +417,15 @@ them from resetting a recently changed password.
 Users whose passwords are set to never expire in Active Directory will not be forced to change their
 password during logon, even if this check box is selected.
 
-**NOTE:** Password Policy Enforcer's History rule is enforced for password resets if the **Enforce
+:::note
+Password Policy Enforcer's History rule is enforced for password resets if the **Enforce
 policy when password is reset** check box is selected in the PPS properties page, and if the
 **Enforce this rule when a password is reset** check box is selected in the History rule's
 properties page. Netwrix Password Policy Enforcer does not enforce the Minimum Age rule for password
 resets. See the [Netwrix Password Policy Enforcer](#netwrix-password-policy-enforcer) topic for
 additional information.
+:::
+
 
 Users may try to evade the password history policy by resetting their password several times in
 quick succession to push a password off the password history list. Select a value from the
@@ -426,9 +448,12 @@ the lockout feature. Incorrect verification codes are counted as incorrect answe
 users if they enter too many incorrect verification codes** check box is selected on the
 **Verification** tab.
 
-**NOTE:** Locked out users must re-enroll before they can use Password Reset to reset their password
+:::note
+Locked out users must re-enroll before they can use Password Reset to reset their password
 or unlock their account. The incorrect answer count is reset when a user enrolls, or answers all
 questions during a reset or unlock.
+:::
+
 
 ## Permissions Tab
 
@@ -466,6 +491,9 @@ key.
 To install a new license key, copy the entire license e-mail to the clipboard, and then click Get
 license from clipboard.
 
-**NOTE:** Password Reset includes a 30-day evaluation license for up to 50 users. Please contact
+:::note
+Password Reset includes a 30-day evaluation license for up to 50 users. Please contact
 Netwrix support[ ](mailto:support@anixis.com)if you would like to evaluate Password Reset with more
 than 50 users.
+
+:::

docs/passwordreset/3.23/administration/editing_the_html_templates.md

@@ -30,11 +30,14 @@ code. The files for the US English language are:
 The formatting information is in `apr.css`, and the image files are in the images folder. These
 files are installed into the `\Inetpub\wwwroot\pwreset\` folder by default.
 
-**NOTE:** Always backup the user interface files before and after editing them. Your changes may be
+:::note
+Always backup the user interface files before and after editing them. Your changes may be
 overwritten when Password Reset is upgraded, and some changes could stop Password Reset from working
 correctly. Having a backup allows you to quickly revert to a working setup.  
 Web browsers display pages differently, so test your changes with several versions of the most
 popular browsers to ensure compatibility.
+:::
+
 
 ### Ranges and Fields
 
@@ -78,8 +81,11 @@ text_short and text_long classes are used to display different content depending
 text_short elements are shown on small screens (up to 420 pixels wide). text_long elements are shown
 on larger screens.
 
-**CAUTION:** You may rebrand the Password Reset user interface, but it is a violation of the License
+:::warning
+You may rebrand the Password Reset user interface, but it is a violation of the License
 Agreement to modify, remove or obscure any copyright notice.
+:::
+
 
 ## Examples
 
@@ -222,8 +228,11 @@ Change the three question numbers on each line so they match the original number
 Password Reset will not work correctly. You should also edit the validation error messages in
 `en_enroll.htm` as some of them make reference to selecting questions from a list.
 
-**NOTE:** Users may not choose appropriate security questions, so it is advisable to leave the
+:::note
+Users may not choose appropriate security questions, so it is advisable to leave the
 question lists for some of the enrollment questions.
+:::
+
 
 ### Change Font Sizes and Colors
 
@@ -256,6 +265,9 @@ Replace the hexadecimal color code with your desired color code. You can use a c
 this one to generate the color code:
 [https://www.w3schools.com/colors/colors_picker.asp](https://www.w3schools.com/colors/colors_picker.asp)
 
-**NOTE:** Some old web browsers with basic HTML5 support cannot display SVG images. Password Reset
+:::note
+Some old web browsers with basic HTML5 support cannot display SVG images. Password Reset
 works with these browsers, but the SVG images are not shown. You can convert the icons to GIF or PNG
 format if you want them shown on these older browsers.
+
+:::

docs/passwordreset/3.23/administration/installation.md

@@ -38,12 +38,15 @@ the credentials are valid.
 
 ![installing_apr](/img/product_docs/passwordreset/3.23/evaluation/installing_apr_1.webp)
 
-**NOTE:** Microsoft SQL Server Compact is installed with the Password Reset Server. SQL Server
+:::note
+Microsoft SQL Server Compact is installed with the Password Reset Server. SQL Server
 Compact is free to use, and should only be removed if you move the database to SQL Server. SQL
 Server Compact is an embedded database. Unlike SQL Server, you do not need to configure or manage
 it. See the
 [Working with the Database](/docs/passwordreset/3.23/administration/working_with_the_database.md)
 topic for additional information.
+:::
+
 
 ## Installation Types
 
@@ -60,9 +63,12 @@ the two servers to communicate.
 
 You choose the installation type when installing Password Reset, but you can change it later.
 
-**NOTE:** An Password Reset Server can accept requests from more than one Web Interface. Having
+:::note
+An Password Reset Server can accept requests from more than one Web Interface. Having
 multiple Web Interfaces allows for load balancing and failover, but you should only consider this
 option if you already have redundant web servers. Most organizations only need one Web Interface.
+:::
+
 
 Password Reset can share server resources with other applications. It is normally not necessary to
 dedicate a server exclusively to Password Reset. The Web Interface can be installed on an existing
@@ -90,26 +96,35 @@ then click **Next** if you accept all the terms.
 **Step 7 –** Enter a **User Name**, **Domain**, and **Password** for the Password Reset service
 account. The account will be created and added to the Domain Admins group if it does not exist.
 
-**NOTE:** You can remove the account from the Domain Admins group later. If using an existing
+:::note
+You can remove the account from the Domain Admins group later. If using an existing
 account, make sure it has the required permissions. See the
 [Securing Password Reset](/docs/passwordreset/3.23/administration/securing_password_reset.md)
 topic for additional information.
+:::
+
 
 **Step 8 –** Click **Next**.
 
 **Step 9 –** Select an **IIS Web Site** from the drop-down list, and optionally change the default
 **Virtual Directory** for the Web Interface.
 
-**NOTE:** The Web Interface should be installed in its own virtual directory.
+:::note
+The Web Interface should be installed in its own virtual directory.
+:::
+
 
 **Step 10 –** Click **Next** twice.
 
 **Step 11 –** Wait for Password Reset to install, and then click **Finish**.
 
-**NOTE:** The Password Reset Setup wizard installs the Password Reset Server and associated files
+:::note
+The Password Reset Setup wizard installs the Password Reset Server and associated files
 into the `\Program Files\ANIXIS Password Reset\` folder by default. Use the SERVERDIR parameter to
 install the Password Reset Server to a different folder. For example, APR323.exe
 SERVERDIR="D:\Programs\APR\"
+:::
+
 
 ### Multiple Server Installation
 
@@ -154,23 +169,29 @@ then click **Next** if you accept all the terms.
 **Step 6 –** Type a **User Name**, **Domain**, and **Password** for the Password Reset service
 account. The account will be created and added to the Domain Admins group if it does not exist.
 
-**NOTE:** You can remove the account from the Domain Admins group later. If using an existing
+:::note
+You can remove the account from the Domain Admins group later. If using an existing
 account, make sure it has the required permissions. See the
 [Securing Password Reset](/docs/passwordreset/3.23/administration/securing_password_reset.md)
 topic for additional information.
+:::
+
 
 **Step 7 –** Make sure the **Create Windows Firewall Exception for the APR Server service** check
 box is selected, and then click **Next** twice.
 
 **Step 8 –** Wait for the Password Reset Server to install, and then click **Finish**.
 
-**NOTE:** Open UDP port 5100 on the Password Reset Server computer if a host-based firewall other
+:::note
+Open UDP port 5100 on the Password Reset Server computer if a host-based firewall other
 than the Windows Firewall is installed. This is needed in addition to the DMZ firewall rules
 above.  
 The Password Reset Setup wizard installs the Password Reset Server and associated files into the
 `\Program Files\ANIXIS Password Reset\` folder by default. Use the SERVERDIR parameter to install
 the Password Reset Server to a different folder. For example, APR323.exe
 SERVERDIR="D:\Programs\APR\"
+:::
+
 
 Install Web Interface Server in DMZ
 
@@ -206,7 +227,7 @@ Reset**, and **3.0** registry keys.
 **Step 12 –** Set the **ServerIP** registry value to the IP address of the computer that you
 installed the Password Reset Server onto.
 
-![installing_apr_1](/img/product_docs/passwordreset/3.23/evaluation/installing_apr_1.webp)
+![RegistryEditor](/img/product_docs/passwordreset/3.23/administration/registryeditor.webp)
 
 The Password Reset Setup wizard only installs one Web Interface on each server, but you can copy the
 files to another directory and publish several Web Interfaces from one server. This allows you to
@@ -247,9 +268,12 @@ topic for additional information.
 Interface files before upgrading**. The Web Interface files are installed in the
 `\Inetpub\wwwroot\pwreset\` folder by default.
 
-**NOTE:** A full backup of the APR server(s) is recommended. This allows you to roll back to the
+:::note
+A full backup of the APR server(s) is recommended. This allows you to roll back to the
 previous version if the upgrade cannot be completed.  
 You may need to restart Windows after upgrading.
+:::
+
 
 If Password Reset was originally installed by someone else and you do not have their installation
 notes, then read this Installation topic before you begin. Also make sure you know the password for
@@ -283,7 +307,8 @@ the
 [Editing the HTML Templates](/docs/passwordreset/3.23/administration/editing_the_html_templates.md)
 topic for additional information.
 
-**CAUTION:** APR V3.23 is only compatible with Password Policy Enforcer V7.0 and later. Upgrade PPE
+:::warning
+APR V3.23 is only compatible with Password Policy Enforcer V7.0 and later. Upgrade PPE
 to a compatible version if you have enabled Password Policy Enforcer integration. See the
 [Configuring Password Reset](/docs/passwordreset/3.23/administration/configuring_password_reset.md)
 topic for additional information.  
@@ -297,6 +322,8 @@ the Password Reset Client on Windows XP and Server 2003. Send an e-mail to
 [support@netwrix.com ](mailto:support@anixis.com)before upgrading if you still have computers
 running Internet Explorer 8.  
 APR V3.23 server components have not been tested on, and are not supported on Windows 2003.
+:::
+
 
 ### Before You Begin