Crate transip

transip

This library crate can be used for calling functions on the Transip Api endpoint. Only part of the api is implemented. The main reason for writing this library is the ability to CRUD dns records for a particular domain. This functionality can be used to respond to DNS01 challenges from the Let's Encrypt servers. This type of challenge is needed to get wildcard certificates.

Example

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

fn main() {
    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");
}

Environment variables

The following environment variables should be set!.

TRANSIP_API_USERNAME

This is the username used in authentication

Example

export TRANSIP_API_USERNAME=paulusminus

TRANSIP_API_PRIVATE_KEY

This is the name of the file that holds the pem encoded private key used in authentication

Example

export TRANSIP_API_PRIVATE_KEY=/etc/transip/private.pem

TRANSIP_API_READONLY

Can be ‘true’ or ‘false’. If you wan’t to prevent accidental modifications set this to ‘true’.

Example

export TRANSIP_API_READONLY=false

TRANSIP_API_WHITELISTED_ONLY

Can be ‘true’ or ‘false’. If you wan’t to access the api on a whitelisted ipaddress set this to ‘true’.

TRANSIP_API_TOKEN_EXPIRATION

Authentication means receiving a token. The interval in which the received will expired can be controlled.

Example 1

export TRANSIP_API_TOKEN_EXPIRATION=5 minutes

Example 2

export TRANSIP_API_TOKEN_EXPIRATION=55 seconds

Example 3

export TRANSIP_API_TOKEN_EXPIRATION=1 hour

TRANSIP_API_LOG_DIR

Directory where the rotating log files are written.

Example

export TRANSIP_API_LOG_DIR=/var/log/transip

TRANSIP_API_TOKEN_PATH

Name of the file where the authentication token received from the endpoint will be written to.

Example

export TRANSIP_API_TOKEN_PATH=/root/.token.txt

Modules

• api
  See api specification

Structs

• Client
  Client is the main entry for this library. Creation is done by using Client::try_from(configuration). After creation of a client, this client can be used to call a Transip API call. Each call starts with a check to see if we have a valid JWT token If the token is expired or non existant then the Transip API call for requesting a new token is called Tokens are persisted to disk on exit and reused if not expired on application startup

Enums

• Error
  All failable functions in this crate should use this Error

Traits

• Configuration
• HasName
• HasNames

Functions

• configuration_from_environment
  get configuration from environment variables

Type Aliases

• Result