drsuapi: Add documentation
[Samba/gebeck_regimport.git] / source4 / rpc_server / drsuapi / updaterefs.c
blobb7a0b44277e3cdf0fe5536abcf74029e656c665e
1 /*
2 Unix SMB/CIFS implementation.
4 implement the DRSUpdateRefs call
6 Copyright (C) Andrew Tridgell 2009
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 "rpc_server/dcerpc_server.h"
24 #include "dsdb/samdb/samdb.h"
25 #include "libcli/security/security.h"
26 #include "libcli/security/session.h"
27 #include "rpc_server/drsuapi/dcesrv_drsuapi.h"
28 #include "auth/session.h"
29 #include "librpc/gen_ndr/ndr_drsuapi.h"
31 struct repsTo {
32 uint32_t count;
33 struct repsFromToBlob *r;
37 add a replication destination for a given partition GUID
39 static WERROR uref_add_dest(struct ldb_context *sam_ctx, TALLOC_CTX *mem_ctx,
40 struct ldb_dn *dn, struct repsFromTo1 *dest,
41 uint32_t options)
43 struct repsTo reps;
44 WERROR werr;
45 unsigned int i;
47 werr = dsdb_loadreps(sam_ctx, mem_ctx, dn, "repsTo", &reps.r, &reps.count);
48 if (!W_ERROR_IS_OK(werr)) {
49 return werr;
52 for (i=0; i<reps.count; i++) {
53 if (GUID_compare(&dest->source_dsa_obj_guid,
54 &reps.r[i].ctr.ctr1.source_dsa_obj_guid) == 0) {
55 if (options & DRSUAPI_DRS_GETCHG_CHECK) {
56 return WERR_OK;
57 } else {
58 return WERR_DS_DRA_REF_ALREADY_EXISTS;
63 reps.r = talloc_realloc(mem_ctx, reps.r, struct repsFromToBlob, reps.count+1);
64 if (reps.r == NULL) {
65 return WERR_DS_DRA_INTERNAL_ERROR;
67 ZERO_STRUCT(reps.r[reps.count]);
68 reps.r[reps.count].version = 1;
69 reps.r[reps.count].ctr.ctr1 = *dest;
70 /* add the GCSPN flag if the client asked for it */
71 reps.r[reps.count].ctr.ctr1.replica_flags |= (options & DRSUAPI_DRS_REF_GCSPN);
72 reps.count++;
74 werr = dsdb_savereps(sam_ctx, mem_ctx, dn, "repsTo", reps.r, reps.count);
75 if (!W_ERROR_IS_OK(werr)) {
76 return werr;
79 return WERR_OK;
83 delete a replication destination for a given partition GUID
85 static WERROR uref_del_dest(struct ldb_context *sam_ctx, TALLOC_CTX *mem_ctx,
86 struct ldb_dn *dn, struct GUID *dest_guid,
87 uint32_t options)
89 struct repsTo reps;
90 WERROR werr;
91 unsigned int i;
92 bool found = false;
94 werr = dsdb_loadreps(sam_ctx, mem_ctx, dn, "repsTo", &reps.r, &reps.count);
95 if (!W_ERROR_IS_OK(werr)) {
96 return werr;
99 for (i=0; i<reps.count; i++) {
100 if (GUID_compare(dest_guid, &reps.r[i].ctr.ctr1.source_dsa_obj_guid) == 0) {
101 if (i+1 < reps.count) {
102 memmove(&reps.r[i], &reps.r[i+1], sizeof(reps.r[i])*(reps.count-(i+1)));
104 reps.count--;
105 found = true;
109 werr = dsdb_savereps(sam_ctx, mem_ctx, dn, "repsTo", reps.r, reps.count);
110 if (!W_ERROR_IS_OK(werr)) {
111 return werr;
114 if (!found &&
115 !(options & DRSUAPI_DRS_GETCHG_CHECK) &&
116 !(options & DRSUAPI_DRS_ADD_REF)) {
117 return WERR_DS_DRA_REF_NOT_FOUND;
120 return WERR_OK;
124 * @brief Update the references for the given NC and the destination DSA object
126 * This function is callable from non RPC functions (ie. getncchanges), it
127 * will validate the request to update reference and then will add/del a repsTo
128 * to the specified server referenced by its DSA GUID in the request.
130 * @param[in] b_state A bind_state object
132 * @param[in] mem_ctx A talloc context for memory allocation
134 * @param[in] req A drsuapi_DsReplicaUpdateRefsRequest1
135 * object which NC, which server and which
136 * action (add/delete) should be performed
138 * @return WERR_OK is success, different error
139 * otherwise.
141 WERROR drsuapi_UpdateRefs(struct drsuapi_bind_state *b_state, TALLOC_CTX *mem_ctx,
142 struct drsuapi_DsReplicaUpdateRefsRequest1 *req)
144 WERROR werr;
145 int ret;
146 struct ldb_dn *dn;
147 struct ldb_dn *nc_root;
148 struct ldb_context *sam_ctx = b_state->sam_ctx_system?b_state->sam_ctx_system:b_state->sam_ctx;
150 DEBUG(4,("DsReplicaUpdateRefs for host '%s' with GUID %s options 0x%08x nc=%s\n",
151 req->dest_dsa_dns_name, GUID_string(mem_ctx, &req->dest_dsa_guid),
152 req->options,
153 drs_ObjectIdentifier_to_string(mem_ctx, req->naming_context)));
156 * 4.1.26.2 Server Behavior of the IDL_DRSUpdateRefs Method
157 * Implements the input validation checks
159 if (GUID_all_zero(&req->dest_dsa_guid)) {
160 return WERR_DS_DRA_INVALID_PARAMETER;
163 if (req->dest_dsa_dns_name == NULL) {
164 return WERR_DS_DRA_INVALID_PARAMETER;
167 if (!(req->options & (DRSUAPI_DRS_DEL_REF|DRSUAPI_DRS_ADD_REF))) {
168 return WERR_DS_DRA_INVALID_PARAMETER;
171 dn = drs_ObjectIdentifier_to_dn(mem_ctx, sam_ctx, req->naming_context);
172 W_ERROR_HAVE_NO_MEMORY(dn);
173 ret = dsdb_find_nc_root(sam_ctx, dn, dn, &nc_root);
174 if (ret != LDB_SUCCESS) {
175 return WERR_DS_DRA_BAD_NC;
177 if (ldb_dn_compare(dn, nc_root) != 0) {
178 return WERR_DS_DRA_BAD_NC;
181 if (ldb_transaction_start(sam_ctx) != LDB_SUCCESS) {
182 DEBUG(0,(__location__ ": Failed to start transaction on samdb: %s\n",
183 ldb_errstring(sam_ctx)));
184 return WERR_DS_DRA_INTERNAL_ERROR;
187 if (req->options & DRSUAPI_DRS_DEL_REF) {
188 werr = uref_del_dest(sam_ctx, mem_ctx, dn, &req->dest_dsa_guid, req->options);
189 if (!W_ERROR_IS_OK(werr)) {
190 DEBUG(0,("Failed to delete repsTo for %s: %s\n",
191 GUID_string(mem_ctx, &req->dest_dsa_guid),
192 win_errstr(werr)));
193 goto failed;
197 if (req->options & DRSUAPI_DRS_ADD_REF) {
198 struct repsFromTo1 dest;
199 struct repsFromTo1OtherInfo oi;
201 ZERO_STRUCT(dest);
202 ZERO_STRUCT(oi);
204 oi.dns_name = req->dest_dsa_dns_name;
205 dest.other_info = &oi;
206 dest.source_dsa_obj_guid = req->dest_dsa_guid;
207 dest.replica_flags = req->options;
209 werr = uref_add_dest(sam_ctx, mem_ctx, dn, &dest, req->options);
210 if (!W_ERROR_IS_OK(werr)) {
211 DEBUG(0,("Failed to add repsTo for %s: %s\n",
212 GUID_string(mem_ctx, &dest.source_dsa_obj_guid),
213 win_errstr(werr)));
214 goto failed;
218 if (ldb_transaction_commit(sam_ctx) != LDB_SUCCESS) {
219 DEBUG(0,(__location__ ": Failed to commit transaction on samdb: %s\n",
220 ldb_errstring(sam_ctx)));
221 return WERR_DS_DRA_INTERNAL_ERROR;
224 return WERR_OK;
226 failed:
227 ldb_transaction_cancel(sam_ctx);
228 return werr;
232 drsuapi_DsReplicaUpdateRefs
234 WERROR dcesrv_drsuapi_DsReplicaUpdateRefs(struct dcesrv_call_state *dce_call, TALLOC_CTX *mem_ctx,
235 struct drsuapi_DsReplicaUpdateRefs *r)
237 struct dcesrv_handle *h;
238 struct drsuapi_bind_state *b_state;
239 struct drsuapi_DsReplicaUpdateRefsRequest1 *req;
240 WERROR werr;
241 int ret;
242 enum security_user_level security_level;
244 DCESRV_PULL_HANDLE_WERR(h, r->in.bind_handle, DRSUAPI_BIND_HANDLE);
245 b_state = h->data;
247 if (r->in.level != 1) {
248 DEBUG(0,("DrReplicUpdateRefs - unsupported level %u\n", r->in.level));
249 return WERR_DS_DRA_INVALID_PARAMETER;
251 req = &r->in.req.req1;
252 werr = drs_security_access_check(b_state->sam_ctx,
253 mem_ctx,
254 dce_call->conn->auth_state.session_info->security_token,
255 req->naming_context,
256 GUID_DRS_MANAGE_TOPOLOGY);
258 if (!W_ERROR_IS_OK(werr)) {
259 return werr;
262 security_level = security_session_user_level(dce_call->conn->auth_state.session_info, NULL);
263 if (security_level < SECURITY_ADMINISTRATOR) {
264 /* check that they are using an DSA objectGUID that they own */
265 ret = dsdb_validate_dsa_guid(b_state->sam_ctx,
266 &req->dest_dsa_guid,
267 &dce_call->conn->auth_state.session_info->security_token->sids[PRIMARY_USER_SID_INDEX]);
268 if (ret != LDB_SUCCESS) {
269 DEBUG(0,(__location__ ": Refusing DsReplicaUpdateRefs for sid %s with GUID %s\n",
270 dom_sid_string(mem_ctx,
271 &dce_call->conn->auth_state.session_info->security_token->sids[PRIMARY_USER_SID_INDEX]),
272 GUID_string(mem_ctx, &req->dest_dsa_guid)));
273 return WERR_DS_DRA_ACCESS_DENIED;
277 werr = drsuapi_UpdateRefs(b_state, mem_ctx, req);
279 #if 0
280 NDR_PRINT_FUNCTION_DEBUG(drsuapi_DsReplicaUpdateRefs, NDR_BOTH, r);
281 #endif
283 return werr;