<p>.htaccess files are commonly used to restrict access to files on a web server. One of the features of .htaccess files is the ability to password protect specific (or all) directories. If setup correctly, a password is required to access the files.</p>
<p>The usage of .htaccess files requires three basic steps:</p>
<ol>
<li>
<ahref="#enable-htaccess">Enable .htaccess</a>
</li>
<li>
<ahref="#create-a-htpasswd-file">Create a .htpasswd file</a>
</li>
<li>
<ahref="#create-a-htaccess-file">Create a .htaccess file</a>
<p>This process depends on the server you are using. Some providers may require you to change some settings, or place/change some file. Here are some helpful links for your server (please add your own if missing :sparkling_heart:)</p>
<h3><aid="create-a-htpasswd-file"href="#create-a-htpasswd-file"class="Permalink"aria-hidden="true"title="Permalink">#</a>Create a .htpasswd file</h3>
<p>The <code>.htpasswd</code> file contains the user name and password used for login to your web server. Please notice that the password is stored in encrypted form, which requires you to encrypt your password before creating the <code>.htpasswd</code> file!</p>
<p>Here are three ways of creating your own <code>.htpasswd</code> file:</p>
<p>You can create your own <code>.htpasswd</code> file online using a <code>.htpasswd</code> generator like this: <ahref="https://www.htaccesstools.com/htpasswd-generator/"class="Link--external"rel="noopener noreferrer">https://www.htaccesstools.com/htpasswd-generator/</a></p>
<p><strong>WARNING!</strong></p>
<ul>
<li>Never insert real passwords to an online generator!</li>
</ul>
<p><strong>3) Generate your own password</strong></p>
<p>Another way to create your own <code>.htpasswd</code> file is to run this script on your server (it’ll output the data for you, you just have to paste it int a <code>.htpasswd</code> file):</p>
<h3><aid="create-a-htaccess-file"href="#create-a-htaccess-file"class="Permalink"aria-hidden="true"title="Permalink">#</a>Create a .htaccess file</h3>
<p>The <code>.htaccess</code> file is used to specify which directories are password protected. For that purpose you should place the file in whatever directory you want to restrict access. If you want to restrict access to RSS-Bridge in general, you should place the file in the root directory (where <code>index.php</code> is located).</p>
<p>Two parameters must be specified in the <code>.htaccess</code> file:</p>
<ul>
<li>AuthName</li>
<li>AuthUserFile</li>
</ul>
<p><code>AuthName</code> specifies the name of the authentication (i.e. “RSS-Bridge”). <code>AuthUserFile</code> defines the <strong>absolute</strong> path to a <code>.htpasswd</code> file.</p>
<p>Here are two ways of creating your own <code>.htaccess</code> file:</p>
<p>Notice: You must change the <code>AuthUserFile</code> location to fit your own server (i.e. <code>/var/www/html/rss-bridge/.htpasswd</code>)</p>
<p><strong>2) Online generator</strong></p>
<p>You can use an online generator to create the file for you and copy-paste it to your <code>.htaccess</code> file: <ahref="https://www.htaccesstools.com/htaccess-authentication/"class="Link--external"rel="noopener noreferrer">https://www.htaccesstools.com/htaccess-authentication/</a></p>
<p>RSS-Bridge ships with an authentication module designed for single user environments. You can enable authentication and specify the username & password in the <ahref="Custom_Configuration.html#authentication">configuration file</a>.</p>
<p>Please notice that the password is stored in plain text and thus is readable to anyone who can access the file. Make sure to restrict access to the file, so that it cannot be read remotely!</p>
window.searchTranslation = {"Search_one_result":"1 result","Search_results":"!count results","Search_no_results":"Nothing found","Search_common_words_ignored":"Common words are largely ignored","Search_too_short":"Search too short","Search_one_character_or_more":"Should be one character or more","Search_should_be_x_or_more":"Should be !min characters or more","Link_previous":"Previous","Link_next":"Next"};
