sshauth：一个基于SSH密钥的身份验证令牌库

sshauth库可以生成并验证由SSH私钥签署的临时携带令牌，无论是直接还是通过SSH代理。这些令牌适用于客户端对服务器的身份验证；例如，使用HTTP Authorization头。

示例

在客户端，选择一个SSH密钥（在SSH术语中称为“身份”），无论是通过读取密钥文件还是查询代理（有关密钥管理的更多信息，请参阅ssh-agent(1)和ssh-add(1)）

let authsock = env::var("SSH_AUTH_SOCK")
    .expect("SSH_AUTH_SOCK is unset or invalid");
let public_key: ssh_key::public::PublicKey =
    sshauth::agent::list_keys(&authsock)
    .await?
    .into_iter()
    .find(|key| {
        /*
         * Choose key of interest by type, fingerprint, comment, etc.
         */
        ...
    })
    .expect("can't find a suitable SSH identity");

拥有密钥后，客户端可以生成、签名并编码令牌

let signer = sshauth::TokenSigner::using_authsock(authsock)?
    .key(key)
    .include_fingerprint(true)
    .build()?;
let token: String = signer
    .sign_for()
    .sign()
    .await?
    .encode();

然后，假设公钥已在服务器上预先注册并存储（例如，在数据库或文件系统中），服务器中的身份验证代码可以查看未经验证的令牌中的指纹，检索相应的公钥，并验证令牌的签名

/*
 * Get the token; e.g., from the "Authorization" header of a HTTP request:
 */
let raw_token: String = "...";
let unverified_token = sshauth::UnverifiedToken::try_from(raw_token.as_str())?;
let fingerprint = unverified_token
    .untrusted_fingerprint()
    .expect("token must include fingerprint");
/*
 * Fetch the registered public key matching the fingerprint and verify the
 * signature:
 */
let public_key = your_database.key_for_fingerprint(&fingerprint)?;
let verified_token = unverified_token.verify_for().with_key(&public_key)?;

时钟要求

为了限制令牌的有效寿命，当前日期和时间被包含在签署的blob中，以便可以在服务器上验证。默认情况下，客户端和服务器时钟必须在60秒的时间差内达成一致。建议客户端和服务器都配置NTP以避免问题。

如果您的系统提供更宽松的时间保证，或者您想能够更长时间地重用令牌，则可以放宽此要求 - 这将相应地降低面对泄露或截获的令牌时的安全性。在验证令牌时使用.max_skew_seconds(seconds)，范围更广。目前无法完全禁用时间戳生成或验证。

请注意，虽然客户端正在签名时间戳，但这并不意味着客户端在指定的时间产生了签名。客户端时钟受客户端控制，在产生签名时可以任意调整或倒退。如果您需要一个可验证的时间戳，则需要某种其他机制来实现这一点；例如，一组独立的时间戳签名服务器，这些服务器可以使用SSH令牌进行身份验证。

操作

为了减少重放攻击的范围，签名块可以包含一个任意动作列表，描述为字符串键值对。应用程序应将希望验证的任何内容包含在动作列表中，例如附加令牌的请求的HTTP方法、授权、查询字符串和POST主体的摘要，这将使攻击者更难重新使用截获的令牌来发出不同的请求。

为了保持令牌大小可管理，动作列表不包括在令牌本身中。令牌签名者和验证者必须事先同意动作列表的顺序和精确内容。任何不匹配都将导致验证失败。

魔法前缀

为了使跨协议攻击更加困难，库支持使用.magic_prefix([u8; 8])函数在签名者和验证者中进行签名。使用不同魔法前缀的两个系统将生成彼此无法验证的签名。客户端和服务器必须在它们相互同意的应用协议级别上就一个常数前缀值达成一致。