transip

这个库crate可用于调用Transip Api端点的函数。仅实现了API的一部分。编写此库的主要原因是能够对特定域的DNS记录进行CRUD。此功能可用于响应来自Let's Encrypt服务器的DNS01挑战。这种挑战类型是获取通配符证书所需的。

示例

use transip::{configuration_from_environment, Client, api::general::GeneralApi};

let mut client = configuration_from_environment()
    .and_then(Client::try_from)
    .expect("No cliënt");

let pong = client.api_test().expect("api test failed");
assert_eq!(pong.as_str(), "pong");

环境变量

应设置以下环境变量！。

TRANSIP_API_USERNAME

这是用于认证的用户名

示例

export TRANSIP_API_USERNAME=paulusminus

TRANSIP_API_PRIVATE_KEY

这是包含用于认证的pem编码私钥的文件名

示例

export TRANSIP_API_PRIVATE_KEY=/etc/transip/private.pem

TRANSIP_API_READONLY

可以是 'true' 或 'false'。如果你想防止意外修改，请将其设置为 'true'。

示例

export TRANSIP_API_READONLY=false

TRANSIP_API_IPV6ONLY

可以是 'true' 或 'false'。如果你在一个仅ipv6（虚拟）机器上，请使用 true。

示例

export TRANSIP_API_IPV6ONLY=false

TRANSIP_API_WHITELISTED_ONLY

可以是 'true' 或 'false'。如果你想通过白名单IP地址访问API，请将其设置为 'true'。

TRANSIP_API_TOKEN_EXPIRATION

认证意味着接收一个令牌。可以控制接收的令牌的过期间隔。

示例 1

export TRANSIP_API_TOKEN_EXPIRATION=5 minutes

示例 2

export TRANSIP_API_TOKEN_EXPIRATION=55 seconds

示例 3

export TRANSIP_API_TOKEN_EXPIRATION=1 hour

TRANSIP_API_LOG_DIR

旋转日志文件写入的目录。

示例

export TRANSIP_API_LOG_DIR=/var/log/transip

TRANSIP_API_TOKEN_PATH

从端点接收的认证令牌将被写入的文件名。

示例

export TRANSIP_API_TOKEN_PATH=/root/.token.txt