Webfinger
This service implements the WebFinger protocol, which allows remote services to discover local users.
#
Features- Automatically find ActivityPub actors through their username
- Returns a 404 error if the actor doesn't exist
#
Dependencies- ApiGateway
- ActivityPub ActorService
#
Install#
Usage#
SettingsProperty | Type | Default | Description |
---|---|---|---|
baseUrl | String | Base URL of the server. Used to find the domain name if it is not set. | |
domainName | String | Domain name used for the user@domain webfinger identifier. If not set, the domain name will be guessed from the users' container. |
#
Discovering an user with WebfingerIn the Webfinger protocol, users are identified by their username and the domain name where they are hosted: username@domain
. This is similar to email addresses, except services like Mastodon add a @
at the beginning.
To find an user, a simple GET is enough:
If the user exists locally, it will return a JSON like this: