Skip to content

Commit 5687c1c

Browse files
committed
docs: add workaround for Kerberos-off-by-default bug
Add a section to the Kerberos/NTLM docs about an issue in Git that prevents Negotiate authentication from being performed in 'auto' mode. The `http.emptyAuth` setting must be explicitly set to `true`. Signed-off-by: Matthew John Cheetham <mjcheetham@outlook.com>
1 parent e8533ed commit 5687c1c

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

docs/ntlm-kerberos.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,18 @@ On Windows, Git can use the native Windows [SSPI][sspi-wiki] (Security Support
8585
Provider Interface) to perform NTLM and Kerberos authentication. This allows Git
8686
to integrate seamlessly with the Windows authentication infrastructure.
8787

88+
> [!IMPORTANT]
89+
> Kerberos authentication is not enabled by default in Git due to a known bug.
90+
>
91+
> To workaround this bug and enable Kerberos authentication, you must set the
92+
> `http.<url>.emptyAuth` configuration option to `true` for your remote URL.
93+
>
94+
> For example:
95+
>
96+
> ```shell
97+
> git config --global http.https://example.com.emptyAuth true
98+
> ```
99+
88100
> [!NOTE]
89101
> As of Git for Windows version 2.53.0.2, **NTLM support is disabled by
90102
> default**.

0 commit comments

Comments
 (0)