Categorygithub.com/writeas/go-webfinger
modulepackage
1.1.0
Repository: https://github.com/writeas/go-webfinger.git
Documentation: pkg.go.dev

# README

GoDoc

go-webfinger

go-webfinger is a golang webfinger server implementation. See v1.0 for the latest stable version, and our Code.as repo for the Write.as-specific implementation.

Past v1.0, this fork was made especially for federation support on Write.as, which includes users across write.as, *.writeas.com, and custom domains we host. The master branch contains changes specific to our implementation, and will change without notification.

Usage

webfinger.Service is implemented as a net/http handler, which means usage is simply registering the object with your http service.

Using the webfinger service as the main ServeHTTP:

myResolver = ...
wf := webfinger.Default(myResolver{})
wf.NotFoundHandler = // the rest of your app
http.ListenAndService(":8080", wf)

Using the webfinger service as a route on an existing HTTP router:

myResolver = ...
wf := webfinger.Default(myResolver{})
http.Handle(webfinger.WebFingerPath, http.HandlerFunc(wf.Webfinger))
http.ListenAndService(":8080", nil)

Defaults

The webfinger service is installed with a few defaults. Some of these defaults ensure we stick closely to the webfinger specification (tls-only, CORS, Content-Type) and other defaults are simply useful for development (no-cache)

The full list of defaults can be found in the godoc for webfinger.Service. They are exposed as public variables which can be overriden.

PreHandlers are the list of preflight HTTP handlers to run. You can add your own via wf.PreHandlers["my-custom-name"] = ..., however, execution order is not guaranteed.

TLS-Only

Handler which routes to the TLS version of the page. Disable via wf.NoTLSHandler = nil.

No-Cache

A PreFlight handler which sets no-cache headers on anything under /.well-known/webfinger. Disable or override via wf.PreHandlers[webfinger.NoCacheMiddleware]

Content Type as application/jrd+json

A PreFlight handler which sets the Content-Type to application/jrd+json. Disable or override via wf.PreHandlers[webfinger.ContentTypeMiddleware].

CORS

A PreFlight handler which adds the CORS headers. Disable or override via wf.PreHandlers[webfinger.CorsMiddleware].

# Functions

Default creates a new service with the default registered handlers.
ErrorFromContext gets the error from the context.

# Constants

Middleware constant keys.
Middleware constant keys.
Middleware constant keys.
WebFingerPath defines the default path of the webfinger handler.

# Variables

ErrorKey is the key for the context error.

# Structs

A Link is a series of user details.
A Resource is the top-level JRD resource object.
Service is the webfinger service containing the required HTTP handlers and defaults for webfinger implementations.

# Interfaces

The Resolver is how the webfinger service looks up a user or resource.

# Type aliases

ErrorKeyType is the type for the context error key.
Rel allows referencing a subset of the users details.