vaultrs 0.8.0

An asynchronous Rust client library for the Hashicorp Vault API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

use super::responses::{GetSecretResponse, ListSecretResponse};

use rustify_derive::Endpoint;
use std::fmt::Debug;

/// ## Read Secret
/// This endpoint retrieves the secret at the specified location.
///
/// * Path: {self.mount}/{self.path}
/// * Method: GET
/// * Response: GetSecretResponse
/// * Reference: <https://developer.hashicorp.com/vault/api-docs/secret/cubbyhole#read-secret>
#[derive(Builder, Debug, Endpoint)]
#[endpoint(
    path = "{self.mount}/{self.path}",
    response = "GetSecretResponse",
    builder = "true"
)]
#[builder(setter(into))]
pub struct GetSecretRequest {
    #[endpoint(skip)]
    pub mount: String,
    #[endpoint(skip)]
    pub path: String,
}

/// ## Set Secret
/// This endpoint set or update a secret at the specified location.
///
/// * Path: {self.mount}/{self.path}
/// * Method: POST
/// * Response: N/A
/// * Reference: <https://developer.hashicorp.com/vault/api-docs/secret/cubbyhole#create-update-secret>
#[derive(Builder, Debug, Endpoint)]
#[endpoint(path = "{self.mount}/{self.path}", method = "POST", builder = "true")]
#[builder(setter(into))]
pub struct SetSecretRequest {
    #[endpoint(skip)]
    pub mount: String,
    #[endpoint(skip)]
    pub path: String,

    // key/value pairs to pass Vault
    // Must be as raw, otherwise payload would be sent as
    // { data: { key: value, key2: value2 } } rather than plain { key: value, key2: value2 }
    // Result in a secret with key "data" and erroneous value
    #[endpoint(raw)]
    pub data: Vec<u8>,
}

/// ## List secret keys
/// This endpoint list secrets at given location
///
/// * Path: {self.mount}/{self.path}
/// * Method: LIST
/// * Response: ListSecretResponse
/// * Reference: <https://developer.hashicorp.com/vault/api-docs/secret/cubbyhole#list-secrets>
#[derive(Builder, Debug, Endpoint)]
#[endpoint(
    path = "{self.mount}/{self.path}",
    method = "LIST",
    builder = "true",
    response = "ListSecretResponse"
)]
#[builder(setter(into))]
pub struct ListSecretRequest {
    #[endpoint(skip)]
    pub mount: String,
    #[endpoint(skip)]
    pub path: String,
}

/// ## Delete secret
/// This endpoint delete a secret at given location
///
/// * Path: {self.mount}/{self.path}
/// * Method: DELETE
/// * Response: N/A
/// * Reference: <https://developer.hashicorp.com/vault/api-docs/secret/cubbyhole#delete-secret>
#[derive(Builder, Debug, Endpoint)]
#[endpoint(path = "{self.mount}/{self.path}", method = "DELETE", builder = "true")]
#[builder(setter(into))]
pub struct DeleteSecretRequest {
    #[endpoint(skip)]
    pub mount: String,
    #[endpoint(skip)]
    pub path: String,
}