futucli/cmd/

machine.rs

//! `futucli machine-id`: 打印本机的 machine-id / 指纹（给"跨机器授权"场景用）
//!
//! 两种输出：
//! - 不加 `--for-key`：打印原始 machine-id（便于用户手动确认）
//! - 加 `--for-key <id>`：打印针对该 key_id 计算出的指纹（可复制到另一台发 key 的机器，
//!   用 `--bind-machines` 写进 keys.json）
//!
//! 这样可以在不把"目标机器的 keys.json / 明文 key"拷过去的前提下，让目标机器"被允许"
//! 使用某 key — 签发者只需要目标机器的指纹。

use anyhow::{Context, Result};
use futu_auth::machine;

pub async fn run(for_key: Option<String>) -> Result<()> {
    let raw = machine::raw_machine_id().context("read machine id")?;
    match for_key {
        None => {
            println!("machine-id (raw): {raw}");
            println!();
            println!("To compute a key-specific fingerprint for binding:");
            println!("  futucli machine-id --for-key REPLACE_WITH_KEY_ID");
            println!(
                "  # ⚠️  把 REPLACE_WITH_KEY_ID 换成 `futucli list-keys` 里某把 key 的 id 字段"
            );
        }
        Some(id) => {
            let fp = machine::fingerprint_from_raw(&id, &raw);
            println!("fingerprint (for key_id={id:?}):");
            println!("  {fp}");
            println!();
            println!("To bind this machine when generating a key elsewhere:");
            println!("  futucli gen-key --id {id} --scopes SCOPE1,SCOPE2 --bind-machines {fp}");
            println!(
                "  # ⚠️  --scopes 按需替换为真实 scope 列表（qot:read / acc:read / trade:unlock / trade:real / admin）"
            );
        }
    }
    Ok(())
}