From e2fbf1ab906d9c7a92537054532d9de11d9d4d41 Mon Sep 17 00:00:00 2001
From: Thijs Kinkhorst <thijs@kinkhorst.com>
Date: Thu, 19 Jan 2023 19:50:50 +0000
Subject: [PATCH] Clarify some frequently encountered issues in config.php.

Clarify https and baseurlpath even more.

Also mention under logging how this relates to loggingdir above.
---
 config/config.php.dist | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/config/config.php.dist b/config/config.php.dist
index a4eaf87a9..b58e3efea 100644
--- a/config/config.php.dist
+++ b/config/config.php.dist
@@ -24,6 +24,8 @@ $config = [
      *
      * The full url format is useful if your SimpleSAMLphp setup is hosted behind
      * a reverse proxy. In that case you can specify the external url here.
+     * Specifying the full URL including https: will let SimpleSAMLphp know
+     * that it runs on HTTPS even if the backend server is plain HTTP.
      *
      * Please note that SimpleSAMLphp will then redirect all queries to the
      * external url, no matter where you come from (direct access or via the
@@ -340,6 +342,9 @@ $config = [
      *
      * Options: [syslog,file,errorlog,stderr]
      *
+     * If you set the handler to 'file', the directory specified in loggingdir above
+     * must exist and be writable for SimpleSAMLphp. If set to something else, set
+     * loggingdir above to 'null'.
      */
     'logging.level' => SimpleSAML\Logger::NOTICE,
     'logging.handler' => 'syslog',
-- 
GitLab