Struct JoinRequest 

pub struct JoinRequest {
    pub hostname: String,
    pub auth: Option<AuthResponse>,
    pub invite_token: Option<String>,
    pub csr: Option<String>,
    pub sans: Vec<String>,
}

Client request to join the mesh.

The joining machine must identify itself by hostname so the CA issues a certificate with the correct subject (not the CA’s own hostname).

Fields

hostname: String

Hostname of the machine requesting to join.

auth: Option<AuthResponse>

Auth response (TOTP code). Absent when enrolling with an invite token.

invite_token: Option<String>

Single-use, hostname-bound enrollment invite token (ADR-015 F2). Mutually exclusive with auth; when present it is the join credential.

csr: Option<String>

PKCS#10 CSR (PEM) generated by the joining member (ADR-015 F1).

The member generates its own keypair and sends only this CSR — the CA signs it and never sees the private key. Required for remote enrollment; the CA refuses to generate member keys server-side.

sans: Vec<String>

Optional extra SANs the joiner wants (IP addresses, aliases). The server always includes [hostname, hostname.local].

Trait Implementations

impl ComposeSchema for JoinRequest

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Debug for JoinRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JoinRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for JoinRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToSchema for JoinRequest

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference utoipa::openapi::schema::Schemas for this type.