Možnosti gradnje in konfiguracija

Ta stran navaja vse funkcije Cargo, okoljske spremenljivke, stikala ukazne vrstice in konfiguracijska polja obeh izvedb ter za vsako pove, ali danes sploh kaj učinkuje.

Izvedba L4Re: funkcije Cargo

Funkcija	Privzeto	Učinek
`openssl-vendored`	vklopljeno	zgradi OpenSSL iz izvorne kode paketa `openssl-src`, trenutno OpenSSL 3.5.4; potrebuje Perl in prevajalnik C
`openssl-system`	izklopljeno	poveže obstoječi OpenSSL, ki ga najde `OPENSSL_DIR` ali sistemsko iskanje
`openssl-local`	izklopljeno	kot `openssl-system`; namenjeno vnaprej zgrajenim knjižnicam pri navzkrižnem prevajanju
`chacha20`	izklopljeno	omogoči vrsti zahtev `0x03` in `0x04`; ni odobreno po FIPS 140-3
`pqc`	vklopljeno	brez učinka; postkvantni algoritmi so vedno vgrajeni
`fips`	izklopljeno	brez učinka; način FIPS ni izveden
`l4re`, `demo`, `bindgen`	izklopljeno	brez učinka

Vklopljena mora biti ena od treh funkcij openssl-*; če je med njimi openssl-vendored, ima prednost. Če želite povezati lasten OpenSSL 3.6, gradite z --no-default-features --features pqc,openssl-system; glejte Uporaba lastne gradnje OpenSSL.

Izvedba L4Re: okoljske spremenljivke

Spremenljivka	Učinek
`OPENSSL_DIR`	mapa OpenSSL za povezovanje z `include/` in `lib/` oz. `lib64/`; ima prednost pred vsemi drugimi navedbami
`L4RE_OPENSSL_DIR`	koren vnaprej zgrajenih knjižnic po arhitekturah, pričakuje `<koren>/x86_64` oz. `<koren>/aarch64`
`OPENSSL_STATIC`	`1` OpenSSL poveže statično; `l4re/.cargo/config.toml` to nastavi za aarch64
`RUST_LOG`	raven dnevnika storitve, npr. `debug`; privzeto `info`

Za cilje Linux l4re/.cargo/config.toml doda poti do knjižnic z računalnika, na katerem so nastali dobavljeni paketi. Če jih ni, to ne škodi; nastavljena OPENSSL_DIR ima prednost.

Datoteka določa še tri okrajšave:

Ukaz	Pomen
`cargo build-all`	gradnja za `x86_64-unknown-linux-gnu` in `aarch64-unknown-linux-gnu`
`cargo test-native`	le testi knjižnice
`cargo lint`	Clippy, vsako opozorilo kot napaka

Izvedba Windows: gradnja

Nastavitev	Učinek
`OPENSSL_DIR`	mapa vnaprej zgrajenega OpenSSL z `include\`, `lib\libcrypto.lib`, `lib\libssl.lib`; brez nje velja pot iz `win/.cargo/config.toml`
`OPENSSL_STATIC`	`1` OpenSSL poveže statično; potrebno, če `lib\` vsebuje le statične knjižnice
funkcija `chacha20`	brez učinka; izvedba Windows nima operacije ChaCha20

Izvedba Windows: ukazna vrstica

wvds_crypto_service [--config <pot>] [--no-tui] [--single] [--help]

Stikalo	Učinek
`--config`, `-c`	naloži konfiguracijo iz navedene datoteke; če je ni mogoče prebrati, veljajo privzete vrednosti
`--no-tui`, `-n`, `--headless`	brez besedilnega vmesnika, dnevnik v konzolo
`--single`, `-s`	le ena cev, `\\.\pipe\wvds_crypto`
`--help`, `-h`	pomoč

Brez --config storitev v trenutni mapi po vrsti išče wvds_crypto.json, config/wvds_crypto.json in config.json. Če ne najde nobene, odpre cevi wvds_crypto_gw1, wvds_crypto_gw2, wvds_crypto_gw3 in wvds_crypto.

Izvedba Windows: konfiguracijska datoteka

{
  "name": "WvdS Post-Quantum Crypto Service",
  "max_keys": 1024,
  "tui_enabled": true,
  "log_level": "info",
  "gateways": [
    { "id": "default", "name": "Default Gateway", "pipe_name": "\\\\.\\pipe\\wvds_crypto", "enabled": true }
  ]
}

Polje	Privzeto	Učinek
`name`	`WvdS Post-Quantum Crypto Service`	le prikaz
`version`	–	brez učinka
`max_keys`	`1024`	največje število hkrati hranjenih ključev
`tui_enabled`	`true`	besedilni vmesnik; `--no-tui` ima prednost
`log_level`	`info`	`trace`, `debug`, `info`, `warn`, `error`; velja le brez besedilnega vmesnika
`gateways`	obvezno	seznam cevi
`gateways[].id`	obvezno	identifikator v dnevniku in statistiki
`gateways[].name`	obvezno	le prikaz
`gateways[].pipe_name`	obvezno	polno ime cevi, v JSON s podvojenimi poševnicami nazaj
`gateways[].enabled`	`true`	`false` cevi ne odpre
`gateways[].priority`, `scenario_groups`, `description`	–	brez učinka
`gateways[].rate_limit`	–	brez učinka; za vso storitev velja stalna omejitev 60.000 zahtev v 60 sekundah

Vzorčni datoteki win/wvds_crypto.json in win/config/wvds_crypto_demo.json za predstavitev odpreta več cevi.