From: Christian Ebner <c.ebner@proxmox.com>
To: Proxmox Backup Server development discussion
<pbs-devel@lists.proxmox.com>,
Maximiliano Sandoval <m.sandoval@proxmox.com>
Subject: Re: [pbs-devel] [PATCH backup 4/5] pbs-client: make common helper for getting UTF-8 secrets
Date: Thu, 27 Mar 2025 10:24:55 +0100 [thread overview]
Message-ID: <87465dcb-d972-45d3-9ee5-a2f2d43a3637@proxmox.com> (raw)
In-Reply-To: <20250326142609.399793-5-m.sandoval@proxmox.com>
This patch could be ordered before the change to the reading of the
default repository, so you don not have to remove the hunks introduced
by that patch again here.
Further, I see that the get_secrets_impl and get_encryption_password do
look almost identical now, so latter could maybe be covered by the same
implementation logic as well, doing the UTF-8 string conversion/checking
only after?
On 3/26/25 15:26, Maximiliano Sandoval wrote:
> Now that there are three credentials it makes sense to have a common
> helper.
>
> Signed-off-by: Maximiliano Sandoval <m.sandoval@proxmox.com>
> ---
> pbs-client/src/tools/mod.rs | 61 ++++++++++++++++++-------------------
> 1 file changed, 30 insertions(+), 31 deletions(-)
>
> diff --git a/pbs-client/src/tools/mod.rs b/pbs-client/src/tools/mod.rs
> index 5dd3b6b10..bd553d88b 100644
> --- a/pbs-client/src/tools/mod.rs
> +++ b/pbs-client/src/tools/mod.rs
> @@ -157,6 +157,25 @@ fn get_secret_from_env(base_name: &str) -> Result<Option<String>, Error> {
> Ok(None)
> }
>
> +/// Gets a secret or value from the environment.
> +///
> +/// Checks for an environment variable named `env_variable`, and if missing, it
> +/// checks for a system [credential] named `credential_name`. Assumes the secret
> +/// is UTF-8 encoded.
> +///
> +/// [credential]: https://systemd.io/CREDENTIALS/
> +fn get_secret_impl(env_variable: &str, credential_name: &str) -> Result<Option<String>, Error> {
> + if let Some(password) = get_secret_from_env(env_variable)? {
> + Ok(Some(password))
> + } else if let Some(password) = get_credential(credential_name)? {
> + String::from_utf8(password)
> + .map(Option::Some)
> + .map_err(|_err| format_err!("credential {credential_name} is not utf8 encoded"))
> + } else {
> + Ok(None)
> + }
> +}
> +
> /// Gets the backup server's password.
> ///
> /// Looks for a password in the `PBS_PASSWORD` environment variable, if there
> @@ -167,15 +186,7 @@ fn get_secret_from_env(base_name: &str) -> Result<Option<String>, Error> {
> ///
> /// [credential]: https://systemd.io/CREDENTIALS/
> pub fn get_password() -> Result<Option<String>, Error> {
> - if let Some(password) = get_secret_from_env(ENV_VAR_PBS_PASSWORD)? {
> - Ok(Some(password))
> - } else if let Some(password) = get_credential(CRED_PBS_PASSWORD)? {
> - String::from_utf8(password)
> - .map(Option::Some)
> - .map_err(|_err| format_err!("non-utf8 password credential"))
> - } else {
> - Ok(None)
> - }
> + get_secret_impl(ENV_VAR_PBS_PASSWORD, CRED_PBS_PASSWORD)
> }
>
> /// Gets an encryption password.
> @@ -200,17 +211,11 @@ pub fn get_encryption_password() -> Result<Option<Vec<u8>>, Error> {
> }
>
> pub fn get_default_repository() -> Option<String> {
> - if let Ok(repository) = std::env::var(ENV_VAR_PBS_REPOSITORY) {
> - Some(repository)
> - } else if let Ok(Some(repository)) = get_credential(CRED_PBS_REPOSITORY).inspect_err(|err| {
> - proxmox_log::error!("Could not read credential {CRED_PBS_REPOSITORY}: {err}")
> - }) {
> - String::from_utf8(repository)
> - .inspect_err(|_err| proxmox_log::error!("non-utf8 repository credential"))
> - .ok()
> - } else {
> - None
> - }
> + get_secret_impl(ENV_VAR_PBS_REPOSITORY, CRED_PBS_REPOSITORY)
> + .inspect_err(|err| {
> + proxmox_log::error!("could not read default repository: {err:#}");
> + })
> + .unwrap_or_default()
> }
>
> /// Gets the repository fingerprint.
> @@ -224,17 +229,11 @@ pub fn get_default_repository() -> Option<String> {
> ///
> /// [credential]: https://systemd.io/CREDENTIALS/
> pub fn get_fingerprint() -> Option<String> {
> - if let Ok(fingerprint) = std::env::var(ENV_VAR_PBS_FINGERPRINT) {
> - Some(fingerprint)
> - } else if let Ok(Some(fingerprint)) = get_credential(CRED_PBS_FINGERPRINT).inspect_err(|err| {
> - proxmox_log::error!("Could not read credential {CRED_PBS_FINGERPRINT}: {err}")
> - }) {
> - String::from_utf8(fingerprint)
> - .inspect_err(|_err| proxmox_log::error!("non-utf8 fingerprint credential"))
> - .ok()
> - } else {
> - None
> - }
> + get_secret_impl(ENV_VAR_PBS_FINGERPRINT, CRED_PBS_FINGERPRINT)
> + .inspect_err(|err| {
> + proxmox_log::error!("could not read fingerprint: {err:#}");
> + })
> + .unwrap_or_default()
> }
>
> pub fn remove_repository_from_value(param: &mut Value) -> Result<BackupRepository, Error> {
_______________________________________________
pbs-devel mailing list
pbs-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel
next prev parent reply other threads:[~2025-03-27 9:25 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-03-26 14:26 [pbs-devel] [PATCH backup 0/5] Allow reading more system credentials & add docs Maximiliano Sandoval
2025-03-26 14:26 ` [pbs-devel] [PATCH backup 1/5] pbs-client: use a const for the PBS_REPOSITORY env variable Maximiliano Sandoval
2025-03-26 14:26 ` [pbs-devel] [PATCH backup 2/5] pbs-client: allow reading default repository from system credential Maximiliano Sandoval
2025-03-26 14:26 ` [pbs-devel] [PATCH backup 3/5] pbs-client: allow reading fingerprint " Maximiliano Sandoval
2025-03-26 14:26 ` [pbs-devel] [PATCH backup 4/5] pbs-client: make common helper for getting UTF-8 secrets Maximiliano Sandoval
2025-03-27 9:24 ` Christian Ebner [this message]
2025-03-27 11:00 ` Maximiliano Sandoval
2025-03-26 14:26 ` [pbs-devel] [PATCH backup 5/5] docs: client: add section about system credentials Maximiliano Sandoval
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87465dcb-d972-45d3-9ee5-a2f2d43a3637@proxmox.com \
--to=c.ebner@proxmox.com \
--cc=m.sandoval@proxmox.com \
--cc=pbs-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal