runneridentity

package
v0.9.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 16, 2026 License: Apache-2.0 Imports: 13 Imported by: 0

Documentation

Overview

Package runneridentity holds the local runner key and its organisation binding.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func DefaultDir

func DefaultDir() (string, error)

DefaultDir is shared by runnerd and the owner's local claim command.

func Generate

func Generate(stateDir string) (ed25519.PrivateKey, error)

Generate persists a new key before it can be submitted for registration. Existing keys are never overwritten, including identities a server revoked.

func Save

func Save(stateDir string, id Identity) error

Save records the server's registration while preserving the generated key.

Types

type Identity

type Identity struct {
	RunnerID     uuid.UUID          `json:"runner_id"`
	PrivateKey   ed25519.PrivateKey `json:"-"`
	Fingerprint  string             `json:"key_fingerprint"`
	OrgURLSHA256 string             `json:"org_url_sha256"`
	// ProxyImage is the proxy image the organisation named for this runner's architecture at
	// registration; empty when it named none or named the release image. runner.json is decoded
	// strictly, so a 0.9.0 wardyn-runnerd cannot load an identity that carries this field: a
	// downgrade means registering again.
	ProxyImage string `json:"proxy_image,omitempty"`
}

Identity never serializes its private key or a person's identity.

func Load

func Load(stateDir, orgURL string) (Identity, error)

Load validates the organisation before returning a key that could sign a connection.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL