Back to Home
Charles

Webfinger WordPress Plugin

The reason behind this plugin is a personal one. As someone who uses Tailscale OIDC support, I discovered that it requires Webfinger support to function properly. However, when I searched for a nice plugin to implement this protocol on my own domain, I found none. That’s where the Webfinger Responder plugin comes in.

Installation

Installing the plugin is simple. Follow these steps:

  1. Install the WordPress Webfinger Responder plugin through the WordPress plugin directory (if only it were there, Github URL is below) or by uploading the plugin files.
  2. Activate the plugin via the ‘Plugins’ menu in your WordPress dashboard.
  3. Go to Settings → Webfinger in your WordPress admin panel and configure your RegEx patterns and corresponding responses.

This plugin is not yet available on the WordPress Plugin repository, but you can download it now directly from Github at the following URL: https://github.com/TheCJGCJG/webfinger-responder

RegEx Pattern Configuration

The plugin uses a cumulative matching system for responses, allowing you to set up both broad domain-wide responses and specific responses for individual addresses while combining them when appropriate.

For example:

  • To match any email address under the example.co.uk domain, use: acct:[a-zA-Z0-9._%+-]+@example.co.uk
  • To match a specific email address, use: hello@example.co.uk

Response Behavior

The plugin will check all configured patterns when a resource query is made. If multiple patterns match the queried resource, ALL matching responses will be included in the final output.

See it in action: https://gillham-net.co.uk/.well-known/webfinger?resource=acct:thecjgcjg