13 releases
0.3.5 | Jul 28, 2024 |
---|---|
0.3.4 | Jul 28, 2024 |
0.3.3 | Mar 30, 2022 |
0.3.1 | Aug 15, 2021 |
0.1.0 | Aug 30, 2020 |
#61 in Authentication
20,479 downloads per month
Used in 5 crates
28KB
189 lines
http-auth-basic
HTTP Basic Authentication Scheme (RFC 7617 and RFC 2617 compilant, base64-encoded credentials) for Rust applications
Description
The "Basic" Hypertext Transfer Protocol (HTTP) authentication scheme, transmits credentials as user-id/password pairs, encoded using Base64.
The server will gather the credentials from the base64 encoded header value, and will validate them to authenticate the user in question.
This crate covers the credentials encoding and decoding. The Credentials
struct provides two fields
user_id
and password
, these are filled with they raw values.
Usage
Decoding a basic authorization value and creating a Credentials
struct
from it
use http_auth_basic::Credentials;
let auth_header_value = String::from("Basic dXNlcm5hbWU6cGFzc3dvcmQ=");
let credentials = Credentials::from_header(auth_header_value).unwrap();
assert_eq!(credentials.user_id, String::from("username"));
assert_eq!(credentials.password, String::from("password"));
Encoding Credentials
into a basic authorization header value.
use http_auth_basic::Credentials;
let credentials = Credentials::new("username", "password");
let credentials = credentials.as_http_header();
assert_eq!(String::from("Basic dXNlcm5hbWU6cGFzc3dvcmQ="), credentials);
Release
git tag -a v0.1.0 -m "Release Message"
git push origin main --follow-tags
Contributing
Every contribution to this project is welcome! Feel free to open a pull request or an issue.
References
License
Distributed under the terms of both the MIT license and the Apache License (Version 2.0)
Dependencies
~235KB