man pages: Fix synonyms.
[Samba.git] / source / utils / net_rpc_join.c
blob361a319c04cd83c711eaab8b6229804080f1b3d4
1 /*
2 Samba Unix/Linux SMB client library
3 Distributed SMB/CIFS Server Management Utility
4 Copyright (C) 2001 Andrew Bartlett (abartlet@samba.org)
5 Copyright (C) Tim Potter 2001
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
21 #include "includes.h"
22 #include "utils/net.h"
24 /* Macro for checking RPC error codes to make things more readable */
26 #define CHECK_RPC_ERR(rpc, msg) \
27 if (!NT_STATUS_IS_OK(result = rpc)) { \
28 DEBUG(0, (msg ": %s\n", nt_errstr(result))); \
29 goto done; \
32 #define CHECK_RPC_ERR_DEBUG(rpc, debug_args) \
33 if (!NT_STATUS_IS_OK(result = rpc)) { \
34 DEBUG(0, debug_args); \
35 goto done; \
38 /**
39 * confirm that a domain join is still valid
41 * @return A shell status integer (0 for success)
43 **/
44 int net_rpc_join_ok(const char *domain, const char *server, struct in_addr *ip )
46 uint32_t neg_flags = NETLOGON_NEG_AUTH2_ADS_FLAGS;
47 enum security_types sec;
48 unsigned int conn_flags = NET_FLAGS_PDC | NET_FLAGS_ANONYMOUS;
49 struct cli_state *cli = NULL;
50 struct rpc_pipe_client *pipe_hnd = NULL;
51 struct rpc_pipe_client *netlogon_pipe = NULL;
52 NTSTATUS ntret = NT_STATUS_UNSUCCESSFUL;
54 sec = (enum security_types)lp_security();
56 if (sec == SEC_ADS) {
57 /* Connect to IPC$ using machine account's credentials. We don't use anonymous
58 connection here, as it may be denied by server's local policy. */
59 net_use_machine_account();
63 /* Connect to remote machine */
64 if (!(cli = net_make_ipc_connection_ex(domain, server, ip, conn_flags))) {
65 return -1;
68 /* Setup the creds as though we're going to do schannel... */
69 netlogon_pipe = get_schannel_session_key(cli, domain, &neg_flags, &ntret);
71 /* We return NT_STATUS_INVALID_NETWORK_RESPONSE if the server is refusing
72 to negotiate schannel, but the creds were set up ok. That'll have to do. */
74 if (!netlogon_pipe) {
75 if (NT_STATUS_EQUAL(ntret, NT_STATUS_INVALID_NETWORK_RESPONSE)) {
76 cli_shutdown(cli);
77 return 0;
78 } else {
79 DEBUG(0,("net_rpc_join_ok: failed to get schannel session "
80 "key from server %s for domain %s. Error was %s\n",
81 cli->desthost, domain, nt_errstr(ntret) ));
82 cli_shutdown(cli);
83 return -1;
87 /* Only do the rest of the schannel test if the client is allowed to do this. */
88 if (!lp_client_schannel()) {
89 cli_shutdown(cli);
90 /* We're good... */
91 return 0;
94 pipe_hnd = cli_rpc_pipe_open_schannel_with_key(cli, PI_NETLOGON,
95 PIPE_AUTH_LEVEL_PRIVACY,
96 domain, netlogon_pipe->dc, &ntret);
98 if (!pipe_hnd) {
99 DEBUG(0,("net_rpc_join_ok: failed to open schannel session "
100 "on netlogon pipe to server %s for domain %s. Error was %s\n",
101 cli->desthost, domain, nt_errstr(ntret) ));
102 cli_shutdown(cli);
103 return -1;
106 cli_shutdown(cli);
107 return 0;
111 * Join a domain using the administrator username and password
113 * @param argc Standard main() style argc
114 * @param argc Standard main() style argv. Initial components are already
115 * stripped. Currently not used.
116 * @return A shell status integer (0 for success)
120 int net_rpc_join_newstyle(int argc, const char **argv)
123 /* libsmb variables */
125 struct cli_state *cli;
126 TALLOC_CTX *mem_ctx;
127 uint32 acb_info = ACB_WSTRUST;
128 uint32_t neg_flags = NETLOGON_NEG_AUTH2_ADS_FLAGS;
129 uint32 sec_channel_type;
130 struct rpc_pipe_client *pipe_hnd = NULL;
132 /* rpc variables */
134 POLICY_HND lsa_pol, sam_pol, domain_pol, user_pol;
135 DOM_SID *domain_sid;
136 uint32 user_rid;
138 /* Password stuff */
140 char *clear_trust_password = NULL;
141 uchar pwbuf[516];
142 SAM_USERINFO_CTR ctr;
143 SAM_USER_INFO_24 p24;
144 SAM_USER_INFO_16 p16;
145 uchar md4_trust_password[16];
147 /* Misc */
149 NTSTATUS result;
150 int retval = 1;
151 char *domain = NULL;
152 uint32 num_rids, *name_types, *user_rids;
153 uint32 flags = 0x3e8;
154 char *acct_name;
155 const char *const_acct_name;
156 uint32 acct_flags=0;
158 /* check what type of join */
159 if (argc >= 0) {
160 sec_channel_type = get_sec_channel_type(argv[0]);
161 } else {
162 sec_channel_type = get_sec_channel_type(NULL);
165 switch (sec_channel_type) {
166 case SEC_CHAN_WKSTA:
167 acb_info = ACB_WSTRUST;
168 break;
169 case SEC_CHAN_BDC:
170 acb_info = ACB_SVRTRUST;
171 break;
172 #if 0
173 case SEC_CHAN_DOMAIN:
174 acb_info = ACB_DOMTRUST;
175 break;
176 #endif
179 /* Make authenticated connection to remote machine */
181 if (!(cli = net_make_ipc_connection(NET_FLAGS_PDC)))
182 return 1;
184 if (!(mem_ctx = talloc_init("net_rpc_join_newstyle"))) {
185 DEBUG(0, ("Could not initialise talloc context\n"));
186 goto done;
189 /* Fetch domain sid */
191 pipe_hnd = cli_rpc_pipe_open_noauth(cli, PI_LSARPC, &result);
192 if (!pipe_hnd) {
193 DEBUG(0, ("Error connecting to LSA pipe. Error was %s\n",
194 nt_errstr(result) ));
195 goto done;
199 CHECK_RPC_ERR(rpccli_lsa_open_policy(pipe_hnd, mem_ctx, True,
200 SEC_RIGHTS_MAXIMUM_ALLOWED,
201 &lsa_pol),
202 "error opening lsa policy handle");
204 CHECK_RPC_ERR(rpccli_lsa_query_info_policy(pipe_hnd, mem_ctx, &lsa_pol,
205 5, &domain, &domain_sid),
206 "error querying info policy");
208 rpccli_lsa_close(pipe_hnd, mem_ctx, &lsa_pol);
209 cli_rpc_pipe_close(pipe_hnd); /* Done with this pipe */
211 /* Bail out if domain didn't get set. */
212 if (!domain) {
213 DEBUG(0, ("Could not get domain name.\n"));
214 goto done;
217 /* Create domain user */
218 pipe_hnd = cli_rpc_pipe_open_noauth(cli, PI_SAMR, &result);
219 if (!pipe_hnd) {
220 DEBUG(0, ("Error connecting to SAM pipe. Error was %s\n",
221 nt_errstr(result) ));
222 goto done;
225 CHECK_RPC_ERR(rpccli_samr_connect(pipe_hnd, mem_ctx,
226 SEC_RIGHTS_MAXIMUM_ALLOWED,
227 &sam_pol),
228 "could not connect to SAM database");
231 CHECK_RPC_ERR(rpccli_samr_open_domain(pipe_hnd, mem_ctx, &sam_pol,
232 SEC_RIGHTS_MAXIMUM_ALLOWED,
233 domain_sid, &domain_pol),
234 "could not open domain");
236 /* Create domain user */
237 if ((acct_name = talloc_asprintf(mem_ctx, "%s$", global_myname())) == NULL) {
238 result = NT_STATUS_NO_MEMORY;
239 goto done;
241 strlower_m(acct_name);
242 const_acct_name = acct_name;
244 acct_flags = SAMR_GENERIC_READ | SAMR_GENERIC_WRITE |
245 SAMR_GENERIC_EXECUTE | SAMR_STANDARD_WRITEDAC |
246 SAMR_STANDARD_DELETE | SAMR_USER_SETPASS | SAMR_USER_GETATTR |
247 SAMR_USER_SETATTR;
248 DEBUG(10, ("Creating account with flags: %d\n",acct_flags));
249 result = rpccli_samr_create_dom_user(pipe_hnd, mem_ctx, &domain_pol,
250 acct_name, acb_info,
251 acct_flags, &user_pol,
252 &user_rid);
254 if (!NT_STATUS_IS_OK(result) &&
255 !NT_STATUS_EQUAL(result, NT_STATUS_USER_EXISTS)) {
256 d_fprintf(stderr, "Creation of workstation account failed\n");
258 /* If NT_STATUS_ACCESS_DENIED then we have a valid
259 username/password combo but the user does not have
260 administrator access. */
262 if (NT_STATUS_V(result) == NT_STATUS_V(NT_STATUS_ACCESS_DENIED))
263 d_fprintf(stderr, "User specified does not have administrator privileges\n");
265 goto done;
268 /* We *must* do this.... don't ask... */
270 if (NT_STATUS_IS_OK(result)) {
271 rpccli_samr_close(pipe_hnd, mem_ctx, &user_pol);
274 CHECK_RPC_ERR_DEBUG(rpccli_samr_lookup_names(pipe_hnd, mem_ctx,
275 &domain_pol, flags,
276 1, &const_acct_name,
277 &num_rids,
278 &user_rids, &name_types),
279 ("error looking up rid for user %s: %s\n",
280 acct_name, nt_errstr(result)));
282 if (name_types[0] != SID_NAME_USER) {
283 DEBUG(0, ("%s is not a user account (type=%d)\n", acct_name, name_types[0]));
284 goto done;
287 user_rid = user_rids[0];
289 /* Open handle on user */
291 CHECK_RPC_ERR_DEBUG(
292 rpccli_samr_open_user(pipe_hnd, mem_ctx, &domain_pol,
293 SEC_RIGHTS_MAXIMUM_ALLOWED,
294 user_rid, &user_pol),
295 ("could not re-open existing user %s: %s\n",
296 acct_name, nt_errstr(result)));
298 /* Create a random machine account password */
301 char *str;
302 str = generate_random_str(DEFAULT_TRUST_ACCOUNT_PASSWORD_LENGTH);
303 clear_trust_password = SMB_STRDUP(str);
304 E_md4hash(clear_trust_password, md4_trust_password);
307 encode_pw_buffer(pwbuf, clear_trust_password, STR_UNICODE);
309 /* Set password on machine account */
311 ZERO_STRUCT(ctr);
312 ZERO_STRUCT(p24);
314 init_sam_user_info24(&p24, (char *)pwbuf,24);
316 ctr.switch_value = 24;
317 ctr.info.id24 = &p24;
319 CHECK_RPC_ERR(rpccli_samr_set_userinfo(pipe_hnd, mem_ctx, &user_pol, 24,
320 &cli->user_session_key, &ctr),
321 "error setting trust account password");
323 /* Why do we have to try to (re-)set the ACB to be the same as what
324 we passed in the samr_create_dom_user() call? When a NT
325 workstation is joined to a domain by an administrator the
326 acb_info is set to 0x80. For a normal user with "Add
327 workstations to the domain" rights the acb_info is 0x84. I'm
328 not sure whether it is supposed to make a difference or not. NT
329 seems to cope with either value so don't bomb out if the set
330 userinfo2 level 0x10 fails. -tpot */
332 ZERO_STRUCT(ctr);
333 ctr.switch_value = 16;
334 ctr.info.id16 = &p16;
336 init_sam_user_info16(&p16, acb_info);
338 /* Ignoring the return value is necessary for joining a domain
339 as a normal user with "Add workstation to domain" privilege. */
341 result = rpccli_samr_set_userinfo2(pipe_hnd, mem_ctx, &user_pol, 16,
342 &cli->user_session_key, &ctr);
344 rpccli_samr_close(pipe_hnd, mem_ctx, &user_pol);
345 cli_rpc_pipe_close(pipe_hnd); /* Done with this pipe */
347 /* Now check the whole process from top-to-bottom */
349 pipe_hnd = cli_rpc_pipe_open_noauth(cli, PI_NETLOGON, &result);
350 if (!pipe_hnd) {
351 DEBUG(0,("Error connecting to NETLOGON pipe. Error was %s\n",
352 nt_errstr(result) ));
353 goto done;
356 result = rpccli_netlogon_setup_creds(pipe_hnd,
357 cli->desthost, /* server name */
358 domain, /* domain */
359 global_myname(), /* client name */
360 global_myname(), /* machine account name */
361 md4_trust_password,
362 sec_channel_type,
363 &neg_flags);
365 if (!NT_STATUS_IS_OK(result)) {
366 DEBUG(0, ("Error in domain join verification (credential setup failed): %s\n\n",
367 nt_errstr(result)));
369 if ( NT_STATUS_EQUAL(result, NT_STATUS_ACCESS_DENIED) &&
370 (sec_channel_type == SEC_CHAN_BDC) ) {
371 d_fprintf(stderr, "Please make sure that no computer account\n"
372 "named like this machine (%s) exists in the domain\n",
373 global_myname());
376 goto done;
379 /* We can only check the schannel connection if the client is allowed
380 to do this and the server supports it. If not, just assume success
381 (after all the rpccli_netlogon_setup_creds() succeeded, and we'll
382 do the same again (setup creds) in net_rpc_join_ok(). JRA. */
384 if (lp_client_schannel() && (neg_flags & NETLOGON_NEG_SCHANNEL)) {
385 struct rpc_pipe_client *netlogon_schannel_pipe =
386 cli_rpc_pipe_open_schannel_with_key(cli,
387 PI_NETLOGON,
388 PIPE_AUTH_LEVEL_PRIVACY,
389 domain,
390 pipe_hnd->dc,
391 &result);
393 if (!NT_STATUS_IS_OK(result)) {
394 DEBUG(0, ("Error in domain join verification (schannel setup failed): %s\n\n",
395 nt_errstr(result)));
397 if ( NT_STATUS_EQUAL(result, NT_STATUS_ACCESS_DENIED) &&
398 (sec_channel_type == SEC_CHAN_BDC) ) {
399 d_fprintf(stderr, "Please make sure that no computer account\n"
400 "named like this machine (%s) exists in the domain\n",
401 global_myname());
404 goto done;
406 cli_rpc_pipe_close(netlogon_schannel_pipe);
409 cli_rpc_pipe_close(pipe_hnd);
411 /* Now store the secret in the secrets database */
413 strupper_m(domain);
415 if (!secrets_store_domain_sid(domain, domain_sid)) {
416 DEBUG(0, ("error storing domain sid for %s\n", domain));
417 goto done;
420 if (!secrets_store_machine_password(clear_trust_password, domain, sec_channel_type)) {
421 DEBUG(0, ("error storing plaintext domain secrets for %s\n", domain));
424 /* double-check, connection from scratch */
425 retval = net_rpc_join_ok(domain, cli->desthost, &cli->dest_ip);
427 done:
429 /* Display success or failure */
431 if (domain) {
432 if (retval != 0) {
433 fprintf(stderr,"Unable to join domain %s.\n",domain);
434 } else {
435 printf("Joined domain %s.\n",domain);
439 cli_shutdown(cli);
441 SAFE_FREE(clear_trust_password);
443 return retval;
447 * check that a join is OK
449 * @return A shell status integer (0 for success)
452 int net_rpc_testjoin(int argc, const char **argv)
454 char *domain = smb_xstrdup(opt_target_workgroup);
456 /* Display success or failure */
457 if (net_rpc_join_ok(domain, NULL, NULL) != 0) {
458 fprintf(stderr,"Join to domain '%s' is not valid\n",domain);
459 free(domain);
460 return -1;
463 printf("Join to '%s' is OK\n",domain);
464 free(domain);
465 return 0;