From 0565be3db19f3582665d2806f4cd12f9582869b1 Mon Sep 17 00:00:00 2001 From: James Elliott Date: Mon, 6 Mar 2023 11:32:06 +1100 Subject: [PATCH] docs: faq (#5032) --- .../openid-connect/specific-information.md | 17 +++++++++++++++++ .../guides/frequently-asked-questions.md | 17 +++++++++++++++++ 2 files changed, 34 insertions(+) create mode 100644 docs/content/en/reference/guides/frequently-asked-questions.md diff --git a/docs/content/en/integration/openid-connect/specific-information.md b/docs/content/en/integration/openid-connect/specific-information.md index 81d35a99f..b13069cb2 100644 --- a/docs/content/en/integration/openid-connect/specific-information.md +++ b/docs/content/en/integration/openid-connect/specific-information.md @@ -53,3 +53,20 @@ deprecated__* and we instead recommended that users remove this from their confi Plaintext is either denoted by the `$plaintext$` prefix where everything after the prefix is the secret. In addition if the secret does not start with the `$` character it's considered as a plaintext secret for the time being but is deprecated as is the `$plaintext$` prefix. + +## Frequently Asked Questions + +### Why isn't my application able to retrieve the token even though I've consented? + +The most common cause for this issue is when the affected application can not make requests to the Token [Endpoint]. +This becomes obvious when the log level is set to `debug` or `trace` and a presence of requests to the Authorization +[Endpoint] without errors but an absence of requests made to the Token [Endpoint]. + +These requests can be identified by looking at the `path` field in the logs, or by messages prefixed with +`Authorization Request` indicating a request to the Authorization [Endpoint] and `Access Request` indicating a request +to the Token [Endpoint]. + +All causes should be clearly logged by the client application, and all errors that do not match this scenario are +clearly logged by Authelia. It's not possible for us to log requests that never occur however. + +[Endpoint]: ./introduction.md#discoverable-endpoints diff --git a/docs/content/en/reference/guides/frequently-asked-questions.md b/docs/content/en/reference/guides/frequently-asked-questions.md new file mode 100644 index 000000000..128a04536 --- /dev/null +++ b/docs/content/en/reference/guides/frequently-asked-questions.md @@ -0,0 +1,17 @@ +--- +title: "Frequently Asked Questions" +description: "This guide shows a list of other frequently asked question documents as well as some general ones" +lead: "This guide shows a list of other frequently asked question documents as well as some general ones." +date: 2023-03-06T11:04:10+11:00 +draft: false +images: [] +menu: + reference: + parent: "guides" +weight: 220 +toc: true +--- + +## Identity Providers + +- [OpenID Connect 1.0 Integration](../../integration/openid-connect/specific-information.md#frequently-asked-questions)