Extended the documentation for the "tls certfile" parameter in the smb.conf.
[Samba.git] / auth / ntlmssp / gensec_ntlmssp.c
blob329d8eb4751acadc4817360dd0d3c541bc5b564e
1 /*
2 * Unix SMB/CIFS implementation.
3 * Version 3.0
4 * NTLMSSP Signing routines
5 * Copyright (C) Luke Kenneth Casson Leighton 1996-2001
6 * Copyright (C) Andrew Bartlett <abartlet@samba.org> 2003-2005
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 3 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, see <http://www.gnu.org/licenses/>.
22 #include "includes.h"
23 #include "auth/ntlmssp/ntlmssp.h"
24 #include "auth/gensec/gensec.h"
25 #include "auth/gensec/gensec_internal.h"
26 #include "auth/ntlmssp/ntlmssp_private.h"
28 NTSTATUS gensec_ntlmssp_magic(struct gensec_security *gensec_security,
29 const DATA_BLOB *first_packet)
31 if (ntlmssp_blob_matches_magic(first_packet)) {
32 return NT_STATUS_OK;
33 } else {
34 return NT_STATUS_INVALID_PARAMETER;
38 /**
39 * Return the NTLMSSP master session key
41 * @param ntlmssp_state NTLMSSP State
44 NTSTATUS gensec_ntlmssp_session_key(struct gensec_security *gensec_security,
45 TALLOC_CTX *mem_ctx,
46 DATA_BLOB *session_key)
48 struct gensec_ntlmssp_context *gensec_ntlmssp =
49 talloc_get_type_abort(gensec_security->private_data,
50 struct gensec_ntlmssp_context);
51 struct ntlmssp_state *ntlmssp_state = gensec_ntlmssp->ntlmssp_state;
53 if (ntlmssp_state->expected_state != NTLMSSP_DONE) {
54 return NT_STATUS_NO_USER_SESSION_KEY;
57 if (!ntlmssp_state->session_key.data) {
58 return NT_STATUS_NO_USER_SESSION_KEY;
60 *session_key = data_blob_talloc(mem_ctx, ntlmssp_state->session_key.data, ntlmssp_state->session_key.length);
61 if (!session_key->data) {
62 return NT_STATUS_NO_MEMORY;
65 return NT_STATUS_OK;
68 bool gensec_ntlmssp_have_feature(struct gensec_security *gensec_security,
69 uint32_t feature)
71 struct gensec_ntlmssp_context *gensec_ntlmssp =
72 talloc_get_type_abort(gensec_security->private_data,
73 struct gensec_ntlmssp_context);
74 struct ntlmssp_state *ntlmssp_state = gensec_ntlmssp->ntlmssp_state;
76 if (feature & GENSEC_FEATURE_SIGN) {
77 if (!ntlmssp_state->session_key.length) {
78 return false;
80 if (ntlmssp_state->neg_flags & NTLMSSP_NEGOTIATE_SIGN) {
81 return true;
84 if (feature & GENSEC_FEATURE_SEAL) {
85 if (!ntlmssp_state->session_key.length) {
86 return false;
88 if (ntlmssp_state->neg_flags & NTLMSSP_NEGOTIATE_SEAL) {
89 return true;
92 if (feature & GENSEC_FEATURE_SESSION_KEY) {
93 if (ntlmssp_state->session_key.length) {
94 return true;
97 if (feature & GENSEC_FEATURE_DCE_STYLE) {
98 return true;
100 if (feature & GENSEC_FEATURE_ASYNC_REPLIES) {
101 if (ntlmssp_state->neg_flags & NTLMSSP_NEGOTIATE_NTLM2) {
102 return true;
105 if (feature & GENSEC_FEATURE_SIGN_PKT_HEADER) {
106 return true;
108 if (feature & GENSEC_FEATURE_NEW_SPNEGO) {
109 if (!ntlmssp_state->session_key.length) {
110 return false;
112 if (!(ntlmssp_state->neg_flags & NTLMSSP_NEGOTIATE_SIGN)) {
113 return false;
115 return ntlmssp_state->new_spnego;
118 return false;
121 NTSTATUS gensec_ntlmssp_start(struct gensec_security *gensec_security)
123 struct gensec_ntlmssp_context *gensec_ntlmssp;
125 gensec_ntlmssp = talloc_zero(gensec_security,
126 struct gensec_ntlmssp_context);
127 if (!gensec_ntlmssp) {
128 return NT_STATUS_NO_MEMORY;
131 gensec_security->private_data = gensec_ntlmssp;
132 return NT_STATUS_OK;
135 NTSTATUS gensec_ntlmssp_sign_packet(struct gensec_security *gensec_security,
136 TALLOC_CTX *sig_mem_ctx,
137 const uint8_t *data, size_t length,
138 const uint8_t *whole_pdu, size_t pdu_length,
139 DATA_BLOB *sig)
141 struct gensec_ntlmssp_context *gensec_ntlmssp =
142 talloc_get_type_abort(gensec_security->private_data,
143 struct gensec_ntlmssp_context);
144 NTSTATUS nt_status;
146 nt_status = ntlmssp_sign_packet(gensec_ntlmssp->ntlmssp_state,
147 sig_mem_ctx,
148 data, length,
149 whole_pdu, pdu_length,
150 sig);
152 return nt_status;
155 NTSTATUS gensec_ntlmssp_check_packet(struct gensec_security *gensec_security,
156 const uint8_t *data, size_t length,
157 const uint8_t *whole_pdu, size_t pdu_length,
158 const DATA_BLOB *sig)
160 struct gensec_ntlmssp_context *gensec_ntlmssp =
161 talloc_get_type_abort(gensec_security->private_data,
162 struct gensec_ntlmssp_context);
163 NTSTATUS nt_status;
165 nt_status = ntlmssp_check_packet(gensec_ntlmssp->ntlmssp_state,
166 data, length,
167 whole_pdu, pdu_length,
168 sig);
170 return nt_status;
173 NTSTATUS gensec_ntlmssp_seal_packet(struct gensec_security *gensec_security,
174 TALLOC_CTX *sig_mem_ctx,
175 uint8_t *data, size_t length,
176 const uint8_t *whole_pdu, size_t pdu_length,
177 DATA_BLOB *sig)
179 struct gensec_ntlmssp_context *gensec_ntlmssp =
180 talloc_get_type_abort(gensec_security->private_data,
181 struct gensec_ntlmssp_context);
182 NTSTATUS nt_status;
184 nt_status = ntlmssp_seal_packet(gensec_ntlmssp->ntlmssp_state,
185 sig_mem_ctx,
186 data, length,
187 whole_pdu, pdu_length,
188 sig);
190 return nt_status;
194 wrappers for the ntlmssp_*() functions
196 NTSTATUS gensec_ntlmssp_unseal_packet(struct gensec_security *gensec_security,
197 uint8_t *data, size_t length,
198 const uint8_t *whole_pdu, size_t pdu_length,
199 const DATA_BLOB *sig)
201 struct gensec_ntlmssp_context *gensec_ntlmssp =
202 talloc_get_type_abort(gensec_security->private_data,
203 struct gensec_ntlmssp_context);
204 NTSTATUS nt_status;
206 nt_status = ntlmssp_unseal_packet(gensec_ntlmssp->ntlmssp_state,
207 data, length,
208 whole_pdu, pdu_length,
209 sig);
211 return nt_status;
214 size_t gensec_ntlmssp_sig_size(struct gensec_security *gensec_security, size_t data_size)
216 return NTLMSSP_SIG_SIZE;
219 NTSTATUS gensec_ntlmssp_wrap(struct gensec_security *gensec_security,
220 TALLOC_CTX *out_mem_ctx,
221 const DATA_BLOB *in,
222 DATA_BLOB *out)
224 struct gensec_ntlmssp_context *gensec_ntlmssp =
225 talloc_get_type_abort(gensec_security->private_data,
226 struct gensec_ntlmssp_context);
228 return ntlmssp_wrap(gensec_ntlmssp->ntlmssp_state,
229 out_mem_ctx,
230 in, out);
234 NTSTATUS gensec_ntlmssp_unwrap(struct gensec_security *gensec_security,
235 TALLOC_CTX *out_mem_ctx,
236 const DATA_BLOB *in,
237 DATA_BLOB *out)
239 struct gensec_ntlmssp_context *gensec_ntlmssp =
240 talloc_get_type_abort(gensec_security->private_data,
241 struct gensec_ntlmssp_context);
243 return ntlmssp_unwrap(gensec_ntlmssp->ntlmssp_state,
244 out_mem_ctx,
245 in, out);