Differences

This shows you the differences between two versions of the page.

--- litespeed_wiki:config:authenticate [2018/06/15 16:17]
Eric Leu
+++ litespeed_wiki:config:authenticate [2020/09/16 17:42] (current)
Lisa Clarke Added permissions line
@@ Line 1: / Line 1: @@
-===== How to set Access site Authentication =====
+====== How to Set Site Authentication ======
-==== Method 1. Through realm====
+Authentication is the process of confirming a user's identity, and it provides a way to ensure that only legitimate users can create content on your site. The steps in the methods below (Web GUI and By Hand) are interchangeable. You can manually create a database file and then load it via the WebConsole, or vice versa.
-=== Step 1.Create Authorization Realms DB ===
+=====Method 1. Set up by Web GUI =====
-We will create a new one as example
+==== Step 1.Create Authorization Realms DB ====
+We will create a new one as an example.
 {{:litespeed_wiki:config:realm-1.png?800|}}
-Choose DB type as Password File
+Set **DB Type** to ''Password File''.
 {{:litespeed_wiki:config:realm-2.png?|}}
 Set:
-  - Realm name, e.g. TEST
+  - **Realm name**, e.g. ''TEST''
-  - DB Location, e.g. $VH_ROOT/conf/TESTDB
+  - **DB Location**, e.g. ''$VH_ROOT/conf/TESTDB''
 {{:litespeed_wiki:config:realm-7.png?800|}}
-=== Step 2.Create Auth user ===
+==== Step 2.Create Auth User ====
-Set e.g. User/Password TEST/TEST
+Set **User**/**Password**, e.g. ''TEST''/''TEST''
 {{:litespeed_wiki:config:realm-6.png?|}}
-===Step 3. Create Context ===
+==== Step 3. Add Access Require by Context====
-Select type as ''Static''
+Add a Context and select type as ''Static''
 Set:
-  - URI ''/''
+  - **URI** ''/''
-  - Set Location ''$VH_ROOT/html/''
+  - **Location** ''$VH_ROOT/html/''
-  - Accessible ''Yes''
+  - **Accessible** ''Yes''
-  - Realm ''TEST''
+  - **Realm** ''TEST''
-  - Access Allowed ''*''
+  - **Access Allowed** ''*''
 {{:litespeed_wiki:config:realm-8.png?|}}
 {{:litespeed_wiki:config:realm-9.png?|}}
-==== How to Verify ====
+=====Method 2. Set up By Hand =====
-Access the site will require auth login
+====Step1. Create Account Through htpasswd ====
+Run the following command to generate ''TESTDB'' file from console, making sure this file and its parent directory are both readable for the web server user (typically ''nobody'' or ''apache''):
+<code>htpasswd -c /PATH_YOU_WANT/TESTDB TEST</code>
+Then enter the password (e.g.''TEST'') two times.
+==== Step 2. Add Access Require by htaccess====
+Add the following rules into your .htaccess file.
+<code>
+AuthType Basic
+AuthName "My Protected Area"
+AuthUserFile /path/to/.htpasswd
+Require valid-user
+</code>
+  * ''AuthName'' can be set to anything, e.g. ''TEST''
+  * ''AuthUserFile'' needs a valid file, e.g.''/usr/local/lsws/DEFAULT/conf/TESTDB''
+===== How to Verify =====
+Access the site. It will require an authorized login.
 {{:litespeed_wiki:config:realm-10.png?|}}