用户通过提供文件加密的接收者或文件解密的身份与age客户端交互。当提供插件接收者或身份时，age客户端将搜索对应插件名称的二进制文件所在的PATH。

接收者段落类型不需要与特定插件名称相关联。在解密时，age客户端将传递所有接收者段落到每个连接的插件。插件必须忽略他们不知道的段落。

插件二进制可以通过在多个名称下出现在PATH中来处理多个收件人或身份类型。这可以通过到规范二进制的符号链接或别名来实现。

多个插件二进制可以支持相同的收件人和身份类型；age客户端将使用在PATH中找到的第一个二进制文件。一些Unix操作系统支持"alternatives"，插件二进制如果提供对常见收件人或身份类型的支持，应利用这一功能。

请注意，用户指定的身份不需要指向特定的解密密钥，或者实际上不包含任何密钥材料。它只需要包含足够的信息，以便插件能够定位必要的密钥材料。

标准age密钥

插件可以支持解密加密为本地age收件人的文件，通过包括对x25519收件人段落的支持。此类插件将选择自己的名称，用户将使用包含指定该插件名称的身份文件。

示例插件二进制

以下示例使用clap来解析命令行参数，但任何可以检测到--age-plugin=STATE_MACHINE标志的参数解析逻辑都将有效。

use age_core::format::{FileKey, Stanza};
use age_plugin::{
    identity::{self, IdentityPluginV1},
    print_new_identity,
    recipient::{self, RecipientPluginV1},
    Callbacks, run_state_machine,
};
use clap::Parser;

use std::collections::HashMap;
use std::io;

struct RecipientPlugin;

impl RecipientPluginV1 for RecipientPlugin {
    fn add_recipient(
        &mut self,
        index: usize,
        plugin_name: &str,
        bytes: &[u8],
    ) -> Result<(), recipient::Error> {
        todo!()
    }

    fn add_identity(
        &mut self,
        index: usize,
        plugin_name: &str,
        bytes: &[u8]
    ) -> Result<(), recipient::Error> {
        todo!()
    }

    fn wrap_file_keys(
        &mut self,
        file_keys: Vec<FileKey>,
        mut callbacks: impl Callbacks<recipient::Error>,
    ) -> io::Result<Result<Vec<Vec<Stanza>>, Vec<recipient::Error>>> {
        todo!()
    }
}

struct IdentityPlugin;

impl IdentityPluginV1 for IdentityPlugin {
    fn add_identity(
        &mut self,
        index: usize,
        plugin_name: &str,
        bytes: &[u8]
    ) -> Result<(), identity::Error> {
        todo!()
    }

    fn unwrap_file_keys(
        &mut self,
        files: Vec<Vec<Stanza>>,
        mut callbacks: impl Callbacks<identity::Error>,
    ) -> io::Result<HashMap<usize, Result<FileKey, Vec<identity::Error>>>> {
        todo!()
    }
}

#[derive(Debug, Parser)]
struct PluginOptions {
    #[arg(help = "run the given age plugin state machine", long)]
    age_plugin: Option<String>,
}

fn main() -> io::Result<()> {
    let opts = PluginOptions::parse();

    if let Some(state_machine) = opts.age_plugin {
        // The plugin was started by an age client; run the state machine.
        run_state_machine(
            &state_machine,
            Some(|| RecipientPlugin),
            Some(|| IdentityPlugin),
        )?;
        return Ok(());
    }

    // Here you can assume the binary is being run directly by a user,
    // and perform administrative tasks like generating keys.

    Ok(())
}

许可证

根据您的选择，许可协议为：

• Apache License，版本2.0，（LICENSE-APACHE或http://www.apache.org/licenses/LICENSE-2.0）
• MIT许可证（LICENSE-MIT或http://opensource.org/licenses/MIT）

任选其一。

贡献

除非您明确声明，否则根据Apache-2.0许可证定义，您提交的任何有意包含在工作中的贡献都将按照上述方式双许可，无需任何附加条款或条件。