A simple, Flask-based webfinger handler.
Simple Webfinger was created to provide an OIDC href from a basic YAML configuration file. Ideally for use with Tailscale and Authentik.
simple_webfinger is a basic Flask application and can be configured via environment variables.
| Environment Variable | Description |
|---|---|
SIMPLE_WEBFINGER_CONFIG_FILE |
Path to the YAML configuration file |
The examples/example-config.yaml file has the basic layout of the YAML configuratio, The path to the file should be provided in the environment variable SIMPLE_WEBFINGER_CONFIG_FILE.
| Key | Value Example | Description |
|---|---|---|
domain |
doofnet.uk |
The domain to respond to, it'll return 404s for anything else |
oidc_href |
https://id.doofnet.uk/... |
The href to return for OIDC rels |
Accounts can be defined under the accounts key, and a key for each user, for example:
accounts:
nikdoof:
mastodon: nikdoof@mastodon.incognitus.net
aliases: []
properties: []
links: []The app will only reply to accounts listed in the configuration, otherwise, it'll return a 404.
| Key | Value Example | Description |
|---|---|---|
mastodon |
nikdoof@mastodon.incognitus.net |
A Mastodon account to generate the related links/properties for |
aliases |
[] |
A list of aliases to include in the response for the account |
links |
[] |
A list of dicts to include in the response |
properties |
[] |
A list of dicts to include in the response |