Skip to content

Commit e8533ed

Browse files
committed
docs: add a section about NTLM-over-SPNEGO
Add a section to the NTLM docs explaining the risks of NTLM over SPNEGO, and include a workaround about how to disable NTLM across all of Windows. Signed-off-by: Matthew John Cheetham <mjcheetham@outlook.com>
1 parent bffb1aa commit e8533ed

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

docs/ntlm-kerberos.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,30 @@ server to agree on which authentication protocol to use (Kerberos or NTLM) based
4949
on their capabilities. Typically Kerberos is preferred if both the client and
5050
server support it, with NTLM acting as a fallback.
5151

52+
#### NTLM-over-SPNEGO
53+
54+
> [!CAUTION]
55+
> When using SPNEGO negotiation if either the client or server does not support
56+
> Kerberos, or if there is an issue with Kerberos authentication, _NTLM may be
57+
> selected as a fallback authentication protocol_.
58+
>
59+
> **This can expose you to all the security risks associated with NTLM.**
60+
61+
Currently the only way to prevent NTLM from being used as a fallback when SPNEGO
62+
negotiation is in use on Windows is to set the following registry key on your
63+
client system to the value `2` (type `DWORD`) to disable NTLM support
64+
system-wide:
65+
66+
```text
67+
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0\RestrictSendingNTLMTraffic
68+
```
69+
70+
> [!WARNING]
71+
> Disabling NTLM support system-wide can have unintended consequences.
72+
>
73+
> NTLM is still often used in various legacy applications and services, and
74+
> disabling it may cause authentication failures in those applications.
75+
5276
## Built-in Support in Git
5377

5478
Git provides built-in support for NTLM and Kerberos authentication through the

0 commit comments

Comments
 (0)