xref: /linux/fs/smb/client/ntlmssp.h (revision 4b132aacb0768ac1e652cf517097ea6f237214b9)
1 /* SPDX-License-Identifier: LGPL-2.1 */
2 /*
3  *
4  *   Copyright (c) International Business Machines  Corp., 2002,2007
5  *   Author(s): Steve French (sfrench@us.ibm.com)
6  *
7  */
8 
9 #define NTLMSSP_SIGNATURE "NTLMSSP"
10 /* Message Types */
11 #define NtLmNegotiate     cpu_to_le32(1)
12 #define NtLmChallenge     cpu_to_le32(2)
13 #define NtLmAuthenticate  cpu_to_le32(3)
14 #define UnknownMessage    cpu_to_le32(8)
15 
16 /* Negotiate Flags */
17 #define NTLMSSP_NEGOTIATE_UNICODE         0x01 /* Text strings are unicode */
18 #define NTLMSSP_NEGOTIATE_OEM             0x02 /* Text strings are in OEM */
19 #define NTLMSSP_REQUEST_TARGET            0x04 /* Srv returns its auth realm */
20 /* define reserved9                       0x08 */
21 #define NTLMSSP_NEGOTIATE_SIGN          0x0010 /* Request signing capability */
22 #define NTLMSSP_NEGOTIATE_SEAL          0x0020 /* Request confidentiality */
23 #define NTLMSSP_NEGOTIATE_DGRAM         0x0040
24 #define NTLMSSP_NEGOTIATE_LM_KEY        0x0080 /* Use LM session key */
25 /* defined reserved 8                   0x0100 */
26 #define NTLMSSP_NEGOTIATE_NTLM          0x0200 /* NTLM authentication */
27 #define NTLMSSP_NEGOTIATE_NT_ONLY       0x0400 /* Lanman not allowed */
28 #define NTLMSSP_ANONYMOUS               0x0800
29 #define NTLMSSP_NEGOTIATE_DOMAIN_SUPPLIED 0x1000 /* reserved6 */
30 #define NTLMSSP_NEGOTIATE_WORKSTATION_SUPPLIED 0x2000
31 #define NTLMSSP_NEGOTIATE_LOCAL_CALL    0x4000 /* client/server same machine */
32 #define NTLMSSP_NEGOTIATE_ALWAYS_SIGN   0x8000 /* Sign. All security levels  */
33 #define NTLMSSP_TARGET_TYPE_DOMAIN     0x10000
34 #define NTLMSSP_TARGET_TYPE_SERVER     0x20000
35 #define NTLMSSP_TARGET_TYPE_SHARE      0x40000
36 #define NTLMSSP_NEGOTIATE_EXTENDED_SEC 0x80000 /* NB:not related to NTLMv2 pwd*/
37 /* #define NTLMSSP_REQUEST_INIT_RESP     0x100000 */
38 #define NTLMSSP_NEGOTIATE_IDENTIFY    0x100000
39 #define NTLMSSP_REQUEST_ACCEPT_RESP   0x200000 /* reserved5 */
40 #define NTLMSSP_REQUEST_NON_NT_KEY    0x400000
41 #define NTLMSSP_NEGOTIATE_TARGET_INFO 0x800000
42 /* #define reserved4                 0x1000000 */
43 #define NTLMSSP_NEGOTIATE_VERSION    0x2000000 /* we only set for SMB2+ */
44 /* #define reserved3                 0x4000000 */
45 /* #define reserved2                 0x8000000 */
46 /* #define reserved1                0x10000000 */
47 #define NTLMSSP_NEGOTIATE_128       0x20000000
48 #define NTLMSSP_NEGOTIATE_KEY_XCH   0x40000000
49 #define NTLMSSP_NEGOTIATE_56        0x80000000
50 
51 /* Define AV Pair Field IDs */
52 enum av_field_type {
53 	NTLMSSP_AV_EOL = 0,
54 	NTLMSSP_AV_NB_COMPUTER_NAME,
55 	NTLMSSP_AV_NB_DOMAIN_NAME,
56 	NTLMSSP_AV_DNS_COMPUTER_NAME,
57 	NTLMSSP_AV_DNS_DOMAIN_NAME,
58 	NTLMSSP_AV_DNS_TREE_NAME,
59 	NTLMSSP_AV_FLAGS,
60 	NTLMSSP_AV_TIMESTAMP,
61 	NTLMSSP_AV_RESTRICTION,
62 	NTLMSSP_AV_TARGET_NAME,
63 	NTLMSSP_AV_CHANNEL_BINDINGS
64 };
65 
66 /* Although typedefs are not commonly used for structure definitions */
67 /* in the Linux kernel, in this particular case they are useful      */
68 /* to more closely match the standards document for NTLMSSP from     */
69 /* OpenGroup and to make the code more closely match the standard in */
70 /* appearance */
71 
72 typedef struct _SECURITY_BUFFER {
73 	__le16 Length;
74 	__le16 MaximumLength;
75 	__le32 BufferOffset;	/* offset to buffer */
76 } __attribute__((packed)) SECURITY_BUFFER;
77 
78 typedef struct _NEGOTIATE_MESSAGE {
79 	__u8 Signature[sizeof(NTLMSSP_SIGNATURE)];
80 	__le32 MessageType;     /* NtLmNegotiate = 1 */
81 	__le32 NegotiateFlags;
82 	SECURITY_BUFFER DomainName;	/* RFC 1001 style and ASCII */
83 	SECURITY_BUFFER WorkstationName;	/* RFC 1001 and ASCII */
84 	/* SECURITY_BUFFER for version info not present since we
85 	   do not set the version is present flag */
86 	char DomainString[];
87 	/* followed by WorkstationString */
88 } __attribute__((packed)) NEGOTIATE_MESSAGE, *PNEGOTIATE_MESSAGE;
89 
90 #define NTLMSSP_REVISION_W2K3 0x0F
91 
92 /* See MS-NLMP section 2.2.2.10 */
93 struct ntlmssp_version {
94 	__u8	ProductMajorVersion;
95 	__u8	ProductMinorVersion;
96 	__le16	ProductBuild; /* we send the cifs.ko module version here */
97 	__u8	Reserved[3];
98 	__u8	NTLMRevisionCurrent; /* currently 0x0F */
99 } __packed;
100 
101 /* see MS-NLMP section 2.2.1.1 */
102 struct negotiate_message {
103 	__u8 Signature[sizeof(NTLMSSP_SIGNATURE)];
104 	__le32 MessageType;     /* NtLmNegotiate = 1 */
105 	__le32 NegotiateFlags;
106 	SECURITY_BUFFER DomainName;	/* RFC 1001 style and ASCII */
107 	SECURITY_BUFFER WorkstationName;	/* RFC 1001 and ASCII */
108 	struct	ntlmssp_version Version;
109 	/* SECURITY_BUFFER */
110 	char DomainString[];
111 	/* followed by WorkstationString */
112 } __packed;
113 
114 typedef struct _CHALLENGE_MESSAGE {
115 	__u8 Signature[sizeof(NTLMSSP_SIGNATURE)];
116 	__le32 MessageType;   /* NtLmChallenge = 2 */
117 	SECURITY_BUFFER TargetName;
118 	__le32 NegotiateFlags;
119 	__u8 Challenge[CIFS_CRYPTO_KEY_SIZE];
120 	__u8 Reserved[8];
121 	SECURITY_BUFFER TargetInfoArray;
122 	/* SECURITY_BUFFER for version info not present since we
123 	   do not set the version is present flag */
124 } __attribute__((packed)) CHALLENGE_MESSAGE, *PCHALLENGE_MESSAGE;
125 
126 typedef struct _AUTHENTICATE_MESSAGE {
127 	__u8 Signature[sizeof(NTLMSSP_SIGNATURE)];
128 	__le32 MessageType;  /* NtLmsAuthenticate = 3 */
129 	SECURITY_BUFFER LmChallengeResponse;
130 	SECURITY_BUFFER NtChallengeResponse;
131 	SECURITY_BUFFER DomainName;
132 	SECURITY_BUFFER UserName;
133 	SECURITY_BUFFER WorkstationName;
134 	SECURITY_BUFFER SessionKey;
135 	__le32 NegotiateFlags;
136 	struct	ntlmssp_version Version;
137 	/* SECURITY_BUFFER */
138 	char UserString[];
139 } __attribute__((packed)) AUTHENTICATE_MESSAGE, *PAUTHENTICATE_MESSAGE;
140 
141 /*
142  * Size of the session key (crypto key encrypted with the password
143  */
144 
145 int decode_ntlmssp_challenge(char *bcc_ptr, int blob_len, struct cifs_ses *ses);
146 int build_ntlmssp_negotiate_blob(unsigned char **pbuffer, u16 *buflen,
147 				 struct cifs_ses *ses,
148 				 struct TCP_Server_Info *server,
149 				 const struct nls_table *nls_cp);
150 int build_ntlmssp_smb3_negotiate_blob(unsigned char **pbuffer, u16 *buflen,
151 				 struct cifs_ses *ses,
152 				 struct TCP_Server_Info *server,
153 				 const struct nls_table *nls_cp);
154 int build_ntlmssp_auth_blob(unsigned char **pbuffer, u16 *buflen,
155 			struct cifs_ses *ses,
156 			struct TCP_Server_Info *server,
157 			const struct nls_table *nls_cp);
158