diff --git a/book/src/integrations/oauth2.md b/book/src/integrations/oauth2.md index 6aaac2f26..c991222ab 100644 --- a/book/src/integrations/oauth2.md +++ b/book/src/integrations/oauth2.md @@ -70,31 +70,22 @@ anything special for Kanidm (or another provider). **Note:** some apps automatically append `/.well-known/openid-configuration` to the end of an OIDC Discovery URL, so you may need to omit that. +
-
-
[Webfinger](https://datatracker.ietf.org/doc/html/rfc7033) URL
+[WebFinger](https://datatracker.ietf.org/doc/html/rfc7033) URL + +
`https://idm.example.com/oauth2/openid/:client_id:/.well-known/webfinger` -The webfinger URL is implemented for each OpenID client, under its specific endpoint, giving full control to the administrator regarding which to use. +The WebFinger URL is implemented for each OpenID client, under its specific endpoint, giving full control to the administrator regarding which to use. To make this compliant with the standard, it must be made available under the correct [well-known endpoint](https://datatracker.ietf.org/doc/html/rfc7033#section-10.1) (e.g `example.com/.well-known/webfinger`), typically via a reverse proxy or similar. Kanidm doesn't currently provide a mechanism for this URI rewrite. One example would be dedicating one client as the "primary" or "default" and redirecting all requests to that. Alternatively, source IP or other request metadata could be used to decide which client to forward the request to. -### Caddy -`Caddyfile` -```caddy -# assuming a kanidm service with domain "example.com" -example.com { - redir /.well-known/webfinger https://idm.example.com/oauth2/openid/:client_id:{uri} 307 -} -``` -**Note:** the `{uri}` is important as it preserves the original request past the redirect. - -