Pierre-Olivier Mercier
7c7706fe3f
Adds a happyDomain checker that probes STUN/TURN servers end-to-end:
DNS/SRV discovery, UDP/TCP/TLS/DTLS dial, STUN binding + reflexive-addr
sanity, open-relay detection, authenticated TURN Allocate (long-term
creds or REST-API HMAC), public-relay check, CreatePermission + Send
round-trip through the relay, and optional ChannelBind.
Failing sub-tests carry a remediation string (`Fix`) that the HTML
report surfaces as a yellow headline callout and inline next to each
row. Mapping covers the most common coturn misconfigurations
(external-ip, relay-ip, lt-cred-mech, min-port/max-port, cert issues,
401 nonce drift, 441/442/486/508 allocation errors).
Implements sdk.EndpointDiscoverer (checker/discovery.go): every
stuns:/turns:/DTLS endpoint observed during Collect is published as a
DiscoveredEndpoint{Type: "tls"|"dtls"} so a downstream TLS checker can
verify certificates without re-parsing the observation.
Backed by pion/stun/v3 + pion/turn/v4 + pion/dtls/v3; SDK pinned to a
local replace until the EndpointDiscoverer interface ships in a tagged
release.
19 lines
636 B
Go
19 lines
636 B
Go
// Command plugin is the happyDomain plugin entrypoint for the STUN/TURN checker.
|
|
//
|
|
// It is built as a Go plugin (`go build -buildmode=plugin`) and loaded at
|
|
// runtime by happyDomain.
|
|
package main
|
|
|
|
import (
|
|
sdk "git.happydns.org/checker-sdk-go/checker"
|
|
stunturn "git.happydns.org/checker-stun-turn/checker"
|
|
)
|
|
|
|
var Version = "custom-build"
|
|
|
|
// NewCheckerPlugin is the symbol resolved by happyDomain when loading the .so.
|
|
func NewCheckerPlugin() (*sdk.CheckerDefinition, sdk.ObservationProvider, error) {
|
|
stunturn.Version = Version
|
|
prvd := stunturn.Provider()
|
|
return prvd.(sdk.CheckerDefinitionProvider).Definition(), prvd, nil
|
|
}
|