summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/index.markdown1
-rw-r--r--doc/solving-session-issue-windows-iis-ie.markdown19
2 files changed, 20 insertions, 0 deletions
diff --git a/doc/index.markdown b/doc/index.markdown
index 234b6b79..09b39d9f 100644
--- a/doc/index.markdown
+++ b/doc/index.markdown
@@ -89,6 +89,7 @@ Using Kanboard
- [Solving database migration issues](solving-database-migration-issues.markdown)
- [Blank page after upgrading](solving-blank-page-issue.markdown)
+- [Unable to open a session on Windows IIS and Internet Explorer](solving-session-issue-windows-iis-ie.markdown)
- [Performances](performances.markdown)
Technical details
diff --git a/doc/solving-session-issue-windows-iis-ie.markdown b/doc/solving-session-issue-windows-iis-ie.markdown
new file mode 100644
index 00000000..1ad3124b
--- /dev/null
+++ b/doc/solving-session-issue-windows-iis-ie.markdown
@@ -0,0 +1,19 @@
+I'm not able to login with Internet Explorer and Microsoft IIS
+==============================================================
+
+If you are not able to login and always get the error **"Username or password required"** even if you have entered the right credentials,
+that means there is a problem with the session.
+
+For example, this is a known issue if you meet these criteria:
+
+- You are using a domain name with an underscore: `kanboard_something.mycompany.tld`
+- You are using Microsoft Windows Server and IIS
+- Your browser is Internet Explorer
+
+Solution: **Do not use underscore in the domain name because this is not a valid domain name**.
+
+Explanation: Internet Explorer doesn't accept cookies with a domain name with underscores because it's not valid.
+
+Reference:
+
+- https://support.microsoft.com/en-us/kb/316112