docspell icon indicating copy to clipboard operation
docspell copied to clipboard

Please add the callback URL to OpenID connect docs

Open antifuchs opened this issue 1 year ago • 1 comments

I just set up an OIDC IDP with pocket-id that docspell can use to authenticate, and one thing that had me scratching my head at first was that there's no mention of the "final" URL on the docspell side that the authentication process will redirect to.

While it can be discovered with browser devtools or by reading the source code, I think it's better to just mention it: It's https://<docspell-base-hostname>/api/v1/open/auth/openid/<provider-id>/resume (:

Would you mind adding that to the documentation?

antifuchs avatar Jan 13 '25 18:01 antifuchs

That is definitely a good idea! :)

If very lucky or patient :) there is some hint at the api docs: https://docspell.org/openapi/docspell-openapi.html#tag/Authentication/operation/open-auth-openid-resume

Perhaps that can be linked in the doc page about openid authentication.

eikek avatar Jan 13 '25 23:01 eikek