Home Operation and Maintenance Nginx How to use Nginx to implement HTTP basic authentication

How to use Nginx to implement HTTP basic authentication

Jun 10, 2023 am 10:36 AM
web server nginx http authentication

Nginx is a high-performance, reliable web server and reverse proxy server. In addition to its powerful load balancing and caching capabilities, Nginx also supports HTTP basic authentication. HTTP basic authentication is a simple authentication method that verifies the user's identity by adding a username and password in the request header. In this article, we will learn how to implement HTTP basic authentication using Nginx.

1. Set username and password

First, we need to create a password file. We can use the htpasswd command to create this file. htpasswd is a command line tool for managing HTTP basic authentication passwords.

We can use the following command in the terminal to create a password file:

htpasswd -c /etc/nginx/.htpasswd username
Copy after login

Among them, -c means to create a new password file, /etc/nginx/.htpasswd is the path to the password file , username is the username we want to add. After running this command, you will be prompted for your password. After entering the password, htpasswd will hash the password and store it in the password file.

If you want to add additional users to the password file, use the following command:

htpasswd /etc/nginx/.htpasswd username2
Copy after login

This command does not have the -c option because our password file already exists. After entering the command, you will be prompted for your password. Once entered, htpasswd hashes and adds the username and password to a password file.

2. Apply basic authentication in Nginx

Now, we have created a password file containing username and password hashes. Next, we need to apply HTTP basic authentication in Nginx.

We need to add the following directives in the server block or location block:

auth_basic "Restricted";
auth_basic_user_file /etc/nginx/.htpasswd;
Copy after login

The first directive tells Nginx to perform basic authentication on the request and display "Restricted" in the pop-up login box as Description.

The second directive tells Nginx to use the /usr/share/nginx/.htpasswd file to authenticate the user.

For example, we can add the following code in Nginx's default server block:

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    root /var/www/html;
    index index.html index.htm index.nginx-debian.html;
    auth_basic "Restricted";
    auth_basic_user_file /etc/nginx/.htpasswd;
}
Copy after login

Now, we have successfully added basic authentication to our Nginx server.

3. Test HTTP basic authentication

Now let’s test the authentication function we just set up. We can use curl or Firefox and other tools to test.

Test using curl:

curl -I http://localhost
Copy after login

The command line will prompt you for your username and password. After entering the correct username and password, you can see the following code included in the HTTP response header:

HTTP/1.1 200 OK
Server: nginx/1.14.0 (Ubuntu)
...
Copy after login

Test with Firefox:

Enter the server address http://localhost in Firefox. Firefox will pop up a window with the word "Restricted" and a description, prompting you to enter your username and password. After entering the correct username and password, you will be redirected to your server default web page.

Summary

This article introduces how to use Nginx to implement HTTP basic authentication. HTTP Basic Authentication is a simple but effective authentication method that can be used to protect sensitive resources of a web server. We can easily add HTTP Basic Authentication to our Nginx server by first creating a password file using the htpasswd command and then applying the Basic Authentication directive in the Nginx configuration.

The above is the detailed content of How to use Nginx to implement HTTP basic authentication. For more information, please follow other related articles on the PHP Chinese website!

Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

Video Face Swap

Video Face Swap

Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Tools

Notepad++7.3.1

Notepad++7.3.1

Easy-to-use and free code editor

SublimeText3 Chinese version

SublimeText3 Chinese version

Chinese version, very easy to use

Zend Studio 13.0.1

Zend Studio 13.0.1

Powerful PHP integrated development environment

Dreamweaver CS6

Dreamweaver CS6

Visual web development tools

SublimeText3 Mac version

SublimeText3 Mac version

God-level code editing software (SublimeText3)

How to configure cloud server domain name in nginx How to configure cloud server domain name in nginx Apr 14, 2025 pm 12:18 PM

How to configure an Nginx domain name on a cloud server: Create an A record pointing to the public IP address of the cloud server. Add virtual host blocks in the Nginx configuration file, specifying the listening port, domain name, and website root directory. Restart Nginx to apply the changes. Access the domain name test configuration. Other notes: Install the SSL certificate to enable HTTPS, ensure that the firewall allows port 80 traffic, and wait for DNS resolution to take effect.

How to check whether nginx is started How to check whether nginx is started Apr 14, 2025 pm 01:03 PM

How to confirm whether Nginx is started: 1. Use the command line: systemctl status nginx (Linux/Unix), netstat -ano | findstr 80 (Windows); 2. Check whether port 80 is open; 3. Check the Nginx startup message in the system log; 4. Use third-party tools, such as Nagios, Zabbix, and Icinga.

How to check nginx version How to check nginx version Apr 14, 2025 am 11:57 AM

The methods that can query the Nginx version are: use the nginx -v command; view the version directive in the nginx.conf file; open the Nginx error page and view the page title.

How to create a mirror in docker How to create a mirror in docker Apr 15, 2025 am 11:27 AM

Steps to create a Docker image: Write a Dockerfile that contains the build instructions. Build the image in the terminal, using the docker build command. Tag the image and assign names and tags using the docker tag command.

How to start nginx server How to start nginx server Apr 14, 2025 pm 12:27 PM

Starting an Nginx server requires different steps according to different operating systems: Linux/Unix system: Install the Nginx package (for example, using apt-get or yum). Use systemctl to start an Nginx service (for example, sudo systemctl start nginx). Windows system: Download and install Windows binary files. Start Nginx using the nginx.exe executable (for example, nginx.exe -c conf\nginx.conf). No matter which operating system you use, you can access the server IP

How to run nginx apache How to run nginx apache Apr 14, 2025 pm 12:33 PM

To get Nginx to run Apache, you need to: 1. Install Nginx and Apache; 2. Configure the Nginx agent; 3. Start Nginx and Apache; 4. Test the configuration to ensure that you can see Apache content after accessing the domain name. In addition, you need to pay attention to other matters such as port number matching, virtual host configuration, and SSL/TLS settings.

How to check the name of the docker container How to check the name of the docker container Apr 15, 2025 pm 12:21 PM

You can query the Docker container name by following the steps: List all containers (docker ps). Filter the container list (using the grep command). Gets the container name (located in the "NAMES" column).

How to check whether nginx is started? How to check whether nginx is started? Apr 14, 2025 pm 12:48 PM

In Linux, use the following command to check whether Nginx is started: systemctl status nginx judges based on the command output: If "Active: active (running)" is displayed, Nginx is started. If "Active: inactive (dead)" is displayed, Nginx is stopped.

See all articles