<< Back to the Curl POST Basic Authentication example
What is Curl?
Curl (stands for Client URL) is popular command-line tool developers use to send requests to the server, upload files, and submit web forms. Curl supports all modern protocols, including HTTP, HTTPS, SFTP, FTP, and has built-in support for SSL, user authentication, and HTTP Cookies. Curl works on Linux, Mac, Windows.
What is HTTP POST?
POST is one of the nine standard methods of the HTTP protocol. The HTTP POST method requests the webserver to receive and process the data contained in the body of the POST message. POST method is often used to submit login or contact forms and upload files and images to the server.
Curl POST Request Syntax
The general form of a Curl command for making a POST request is as follows:
- -X, --request: HTTP method to use when communicating with the server
- -H, --header: HTTP headers to send to the server with a POST request
- -d, --data: Data to be sent to the server using a POST request
What is Basic Authentication?
Basic Authentication is a client authentication method built into the HTTP protocol that allows a client to provide a username and password to the server when accessing secure resources over HTTP. When requesting a protected resource, the client sends HTTP requests with an Authorization header that contains the word Basic followed by a space and a base64 encoded username: password string. Basic Authentication is not the most secure method because other protocol sniffers can easily decrypt base64 encoded user credentials. For security reasons, the Basic Authentication method should only be used over secure HTTPS/SSL connections.
How do I post Basic Authentication data using Curl?
To post a Curl request with Basic Authorization credentials, you can use the -u (or --user) command line parameter: --user username: password.
Curl automatically converts the provided login: password pair into a Base64-encoded string and adds an appropriate HTTP header to the request:
Example of Basic user Authentication using Curl POST request
The general form of a Curl command for making a POST request with Basic Authentication is as follows:
- -X: HTTP method to use when communicating with the server.
- -H: HTTP header to send to the server with a POST request.
- -d: Data to be sent to the server using a POST request.
- --user: Provide the username and password that will be used to authenticate the server.