b77bc9188a60ed4e68d8d0f2ba53c283451ea163
1 # -*- coding: utf-8 -*-
3 # Licensed under the Apache License, Version 2.0 (the "License");
4 # you may not use this file except in compliance with the License.
5 # You may obtain a copy of the License at
7 # http://www.apache.org/licenses/LICENSE-2.0
9 # Unless required by applicable law or agreed to in writing, software
10 # distributed under the License is distributed on an "AS IS" BASIS,
11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
13 # See the License for the specific language governing permissions and
14 # limitations under the License.
17 from uuid
import uuid4
18 from hashlib
import sha256
19 from http
import HTTPStatus
21 from validation
import user_new_schema
, user_edit_schema
, project_new_schema
, project_edit_schema
22 from validation
import vim_account_new_schema
, vim_account_edit_schema
, sdn_new_schema
, sdn_edit_schema
23 from validation
import wim_account_new_schema
, wim_account_edit_schema
, roles_new_schema
, roles_edit_schema
24 from validation
import validate_input
25 from validation
import ValidationError
26 from validation
import is_valid_uuid
# To check that User/Project Names don't look like UUIDs
27 from base_topic
import BaseTopic
, EngineException
29 __author__
= "Alfonso Tierno <alfonso.tiernosepulveda@telefonica.com>"
32 class UserTopic(BaseTopic
):
35 schema_new
= user_new_schema
36 schema_edit
= user_edit_schema
39 def __init__(self
, db
, fs
, msg
):
40 BaseTopic
.__init
__(self
, db
, fs
, msg
)
43 def _get_project_filter(session
):
45 Generates a filter dictionary for querying database users.
46 Current policy is admin can show all, non admin, only its own user.
47 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
50 if session
["admin"]: # allows all
53 return {"username": session
["username"]}
55 def check_conflict_on_new(self
, session
, indata
):
56 # check username not exists
57 if self
.db
.get_one(self
.topic
, {"username": indata
.get("username")}, fail_on_empty
=False, fail_on_more
=False):
58 raise EngineException("username '{}' exists".format(indata
["username"]), HTTPStatus
.CONFLICT
)
60 if not session
["force"]:
61 for p
in indata
.get("projects"):
62 # To allow project addressing by Name as well as ID
63 if not self
.db
.get_one("projects", {BaseTopic
.id_field("projects", p
): p
}, fail_on_empty
=False,
65 raise EngineException("project '{}' does not exist".format(p
), HTTPStatus
.CONFLICT
)
67 def check_conflict_on_del(self
, session
, _id
, db_content
):
69 Check if deletion can be done because of dependencies if it is not force. To override
70 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
71 :param _id: internal _id
72 :param db_content: The database content of this item _id
73 :return: None if ok or raises EngineException with the conflict
75 if _id
== session
["username"]:
76 raise EngineException("You cannot delete your own user", http_code
=HTTPStatus
.CONFLICT
)
79 def format_on_new(content
, project_id
=None, make_public
=False):
80 BaseTopic
.format_on_new(content
, make_public
=False)
81 # Removed so that the UUID is kept, to allow User Name modification
82 # content["_id"] = content["username"]
84 content
["_admin"]["salt"] = salt
85 if content
.get("password"):
86 content
["password"] = sha256(content
["password"].encode('utf-8') + salt
.encode('utf-8')).hexdigest()
87 if content
.get("project_role_mappings"):
88 projects
= [mapping
[0] for mapping
in content
["project_role_mappings"]]
90 if content
.get("projects"):
91 content
["projects"] += projects
93 content
["projects"] = projects
96 def format_on_edit(final_content
, edit_content
):
97 BaseTopic
.format_on_edit(final_content
, edit_content
)
98 if edit_content
.get("password"):
100 final_content
["_admin"]["salt"] = salt
101 final_content
["password"] = sha256(edit_content
["password"].encode('utf-8') +
102 salt
.encode('utf-8')).hexdigest()
104 def edit(self
, session
, _id
, indata
=None, kwargs
=None, content
=None):
105 if not session
["admin"]:
106 raise EngineException("needed admin privileges", http_code
=HTTPStatus
.UNAUTHORIZED
)
107 # Names that look like UUIDs are not allowed
108 name
= (indata
if indata
else kwargs
).get("username")
109 if is_valid_uuid(name
):
110 raise EngineException("Usernames that look like UUIDs are not allowed",
111 http_code
=HTTPStatus
.UNPROCESSABLE_ENTITY
)
112 return BaseTopic
.edit(self
, session
, _id
, indata
=indata
, kwargs
=kwargs
, content
=content
)
114 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
115 if not session
["admin"]:
116 raise EngineException("needed admin privileges", http_code
=HTTPStatus
.UNAUTHORIZED
)
117 # Names that look like UUIDs are not allowed
118 name
= indata
["username"] if indata
else kwargs
["username"]
119 if is_valid_uuid(name
):
120 raise EngineException("Usernames that look like UUIDs are not allowed",
121 http_code
=HTTPStatus
.UNPROCESSABLE_ENTITY
)
122 return BaseTopic
.new(self
, rollback
, session
, indata
=indata
, kwargs
=kwargs
, headers
=headers
)
125 class ProjectTopic(BaseTopic
):
127 topic_msg
= "projects"
128 schema_new
= project_new_schema
129 schema_edit
= project_edit_schema
132 def __init__(self
, db
, fs
, msg
):
133 BaseTopic
.__init
__(self
, db
, fs
, msg
)
136 def _get_project_filter(session
):
138 Generates a filter dictionary for querying database users.
139 Current policy is admin can show all, non admin, only its own user.
140 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
143 if session
["admin"]: # allows all
146 return {"_id.cont": session
["project_id"]}
148 def check_conflict_on_new(self
, session
, indata
):
149 if not indata
.get("name"):
150 raise EngineException("missing 'name'")
151 # check name not exists
152 if self
.db
.get_one(self
.topic
, {"name": indata
.get("name")}, fail_on_empty
=False, fail_on_more
=False):
153 raise EngineException("name '{}' exists".format(indata
["name"]), HTTPStatus
.CONFLICT
)
156 def format_on_new(content
, project_id
=None, make_public
=False):
157 BaseTopic
.format_on_new(content
, None)
158 # Removed so that the UUID is kept, to allow Project Name modification
159 # content["_id"] = content["name"]
161 def check_conflict_on_del(self
, session
, _id
, db_content
):
163 Check if deletion can be done because of dependencies if it is not force. To override
164 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
165 :param _id: internal _id
166 :param db_content: The database content of this item _id
167 :return: None if ok or raises EngineException with the conflict
169 if _id
in session
["project_id"]:
170 raise EngineException("You cannot delete your own project", http_code
=HTTPStatus
.CONFLICT
)
173 _filter
= {"projects": _id
}
174 if self
.db
.get_list("users", _filter
):
175 raise EngineException("There is some USER that contains this project", http_code
=HTTPStatus
.CONFLICT
)
177 def edit(self
, session
, _id
, indata
=None, kwargs
=None, content
=None):
178 if not session
["admin"]:
179 raise EngineException("needed admin privileges", http_code
=HTTPStatus
.UNAUTHORIZED
)
180 # Names that look like UUIDs are not allowed
181 name
= (indata
if indata
else kwargs
).get("name")
182 if is_valid_uuid(name
):
183 raise EngineException("Project names that look like UUIDs are not allowed",
184 http_code
=HTTPStatus
.UNPROCESSABLE_ENTITY
)
185 return BaseTopic
.edit(self
, session
, _id
, indata
=indata
, kwargs
=kwargs
, content
=content
)
187 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
188 if not session
["admin"]:
189 raise EngineException("needed admin privileges", http_code
=HTTPStatus
.UNAUTHORIZED
)
190 # Names that look like UUIDs are not allowed
191 name
= indata
["name"] if indata
else kwargs
["name"]
192 if is_valid_uuid(name
):
193 raise EngineException("Project names that look like UUIDs are not allowed",
194 http_code
=HTTPStatus
.UNPROCESSABLE_ENTITY
)
195 return BaseTopic
.new(self
, rollback
, session
, indata
=indata
, kwargs
=kwargs
, headers
=headers
)
198 class VimAccountTopic(BaseTopic
):
199 topic
= "vim_accounts"
200 topic_msg
= "vim_account"
201 schema_new
= vim_account_new_schema
202 schema_edit
= vim_account_edit_schema
203 vim_config_encrypted
= ("admin_password", "nsx_password", "vcenter_password")
206 def __init__(self
, db
, fs
, msg
):
207 BaseTopic
.__init
__(self
, db
, fs
, msg
)
209 def check_conflict_on_new(self
, session
, indata
):
210 self
.check_unique_name(session
, indata
["name"], _id
=None)
212 def check_conflict_on_edit(self
, session
, final_content
, edit_content
, _id
):
213 if not session
["force"] and edit_content
.get("name"):
214 self
.check_unique_name(session
, edit_content
["name"], _id
=_id
)
217 schema_version
= final_content
.get("schema_version")
219 if edit_content
.get("vim_password"):
220 final_content
["vim_password"] = self
.db
.encrypt(edit_content
["vim_password"],
221 schema_version
=schema_version
, salt
=_id
)
222 if edit_content
.get("config"):
223 for p
in self
.vim_config_encrypted
:
224 if edit_content
["config"].get(p
):
225 final_content
["config"][p
] = self
.db
.encrypt(edit_content
["config"][p
],
226 schema_version
=schema_version
, salt
=_id
)
228 def format_on_new(self
, content
, project_id
=None, make_public
=False):
229 BaseTopic
.format_on_new(content
, project_id
=project_id
, make_public
=make_public
)
230 content
["schema_version"] = schema_version
= "1.1"
233 if content
.get("vim_password"):
234 content
["vim_password"] = self
.db
.encrypt(content
["vim_password"], schema_version
=schema_version
,
236 if content
.get("config"):
237 for p
in self
.vim_config_encrypted
:
238 if content
["config"].get(p
):
239 content
["config"][p
] = self
.db
.encrypt(content
["config"][p
], schema_version
=schema_version
,
242 content
["_admin"]["operationalState"] = "PROCESSING"
244 def delete(self
, session
, _id
, dry_run
=False):
246 Delete item by its internal _id
247 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
248 :param _id: server internal id
249 :param dry_run: make checking but do not delete
250 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
252 # TODO add admin to filter, validate rights
253 if dry_run
or session
["force"]: # delete completely
254 return BaseTopic
.delete(self
, session
, _id
, dry_run
)
255 else: # if not, sent to kafka
256 v
= BaseTopic
.delete(self
, session
, _id
, dry_run
=True)
257 self
.db
.set_one("vim_accounts", {"_id": _id
}, {"_admin.to_delete": True}) # TODO change status
258 self
._send
_msg
("delete", {"_id": _id
})
259 return v
# TODO indicate an offline operation to return 202 ACCEPTED
262 class WimAccountTopic(BaseTopic
):
263 topic
= "wim_accounts"
264 topic_msg
= "wim_account"
265 schema_new
= wim_account_new_schema
266 schema_edit
= wim_account_edit_schema
268 wim_config_encrypted
= ()
270 def __init__(self
, db
, fs
, msg
):
271 BaseTopic
.__init
__(self
, db
, fs
, msg
)
273 def check_conflict_on_new(self
, session
, indata
):
274 self
.check_unique_name(session
, indata
["name"], _id
=None)
276 def check_conflict_on_edit(self
, session
, final_content
, edit_content
, _id
):
277 if not session
["force"] and edit_content
.get("name"):
278 self
.check_unique_name(session
, edit_content
["name"], _id
=_id
)
281 schema_version
= final_content
.get("schema_version")
283 if edit_content
.get("wim_password"):
284 final_content
["wim_password"] = self
.db
.encrypt(edit_content
["wim_password"],
285 schema_version
=schema_version
, salt
=_id
)
286 if edit_content
.get("config"):
287 for p
in self
.wim_config_encrypted
:
288 if edit_content
["config"].get(p
):
289 final_content
["config"][p
] = self
.db
.encrypt(edit_content
["config"][p
],
290 schema_version
=schema_version
, salt
=_id
)
292 def format_on_new(self
, content
, project_id
=None, make_public
=False):
293 BaseTopic
.format_on_new(content
, project_id
=project_id
, make_public
=make_public
)
294 content
["schema_version"] = schema_version
= "1.1"
297 if content
.get("wim_password"):
298 content
["wim_password"] = self
.db
.encrypt(content
["wim_password"], schema_version
=schema_version
,
300 if content
.get("config"):
301 for p
in self
.wim_config_encrypted
:
302 if content
["config"].get(p
):
303 content
["config"][p
] = self
.db
.encrypt(content
["config"][p
], schema_version
=schema_version
,
306 content
["_admin"]["operationalState"] = "PROCESSING"
308 def delete(self
, session
, _id
, dry_run
=False):
310 Delete item by its internal _id
311 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
312 :param _id: server internal id
313 :param dry_run: make checking but do not delete
314 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
316 # TODO add admin to filter, validate rights
317 if dry_run
or session
["force"]: # delete completely
318 return BaseTopic
.delete(self
, session
, _id
, dry_run
)
319 else: # if not, sent to kafka
320 v
= BaseTopic
.delete(self
, session
, _id
, dry_run
=True)
321 self
.db
.set_one("wim_accounts", {"_id": _id
}, {"_admin.to_delete": True}) # TODO change status
322 self
._send
_msg
("delete", {"_id": _id
})
323 return v
# TODO indicate an offline operation to return 202 ACCEPTED
326 class SdnTopic(BaseTopic
):
329 schema_new
= sdn_new_schema
330 schema_edit
= sdn_edit_schema
333 def __init__(self
, db
, fs
, msg
):
334 BaseTopic
.__init
__(self
, db
, fs
, msg
)
336 def check_conflict_on_new(self
, session
, indata
):
337 self
.check_unique_name(session
, indata
["name"], _id
=None)
339 def check_conflict_on_edit(self
, session
, final_content
, edit_content
, _id
):
340 if not session
["force"] and edit_content
.get("name"):
341 self
.check_unique_name(session
, edit_content
["name"], _id
=_id
)
344 schema_version
= final_content
.get("schema_version")
345 if schema_version
and edit_content
.get("password"):
346 final_content
["password"] = self
.db
.encrypt(edit_content
["password"], schema_version
=schema_version
,
349 def format_on_new(self
, content
, project_id
=None, make_public
=False):
350 BaseTopic
.format_on_new(content
, project_id
=project_id
, make_public
=make_public
)
351 content
["schema_version"] = schema_version
= "1.1"
353 if content
.get("password"):
354 content
["password"] = self
.db
.encrypt(content
["password"], schema_version
=schema_version
,
357 content
["_admin"]["operationalState"] = "PROCESSING"
359 def delete(self
, session
, _id
, dry_run
=False):
361 Delete item by its internal _id
362 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
363 :param _id: server internal id
364 :param dry_run: make checking but do not delete
365 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
367 if dry_run
or session
["force"]: # delete completely
368 return BaseTopic
.delete(self
, session
, _id
, dry_run
)
369 else: # if not sent to kafka
370 v
= BaseTopic
.delete(self
, session
, _id
, dry_run
=True)
371 self
.db
.set_one("sdns", {"_id": _id
}, {"_admin.to_delete": True}) # TODO change status
372 self
._send
_msg
("delete", {"_id": _id
})
373 return v
# TODO indicate an offline operation to return 202 ACCEPTED
376 class UserTopicAuth(UserTopic
):
378 # topic_msg = "users"
379 schema_new
= user_new_schema
380 schema_edit
= user_edit_schema
382 def __init__(self
, db
, fs
, msg
, auth
):
383 UserTopic
.__init
__(self
, db
, fs
, msg
)
386 def check_conflict_on_new(self
, session
, indata
):
388 Check that the data to be inserted is valid
390 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
391 :param indata: data to be inserted
392 :return: None or raises EngineException
394 username
= indata
.get("username")
395 user_list
= list(map(lambda x
: x
["username"], self
.auth
.get_user_list()))
397 if "projects" in indata
.keys():
398 raise EngineException("Format invalid: the keyword \"projects\" is not allowed for Keystone",
399 HTTPStatus
.BAD_REQUEST
)
401 if username
in user_list
:
402 raise EngineException("username '{}' exists".format(username
), HTTPStatus
.CONFLICT
)
404 def check_conflict_on_edit(self
, session
, final_content
, edit_content
, _id
):
406 Check that the data to be edited/uploaded is valid
408 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
409 :param final_content: data once modified
410 :param edit_content: incremental data that contains the modifications to apply
411 :param _id: internal _id
412 :return: None or raises EngineException
414 users
= self
.auth
.get_user_list()
415 admin_user
= [user
for user
in users
if user
["name"] == "admin"][0]
417 if _id
== admin_user
["_id"] and edit_content
["project_role_mappings"]:
420 "role": "system_admin"
422 if elem
not in edit_content
:
423 raise EngineException("You cannot remove system_admin role from admin user",
424 http_code
=HTTPStatus
.FORBIDDEN
)
426 def check_conflict_on_del(self
, session
, _id
, db_content
):
428 Check if deletion can be done because of dependencies if it is not force. To override
429 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
430 :param _id: internal _id
431 :param db_content: The database content of this item _id
432 :return: None if ok or raises EngineException with the conflict
434 if _id
== session
["username"]:
435 raise EngineException("You cannot delete your own user", http_code
=HTTPStatus
.CONFLICT
)
438 def format_on_new(content
, project_id
=None, make_public
=False):
440 Modifies content descriptor to include _id.
442 NOTE: No password salt required because the authentication backend
443 should handle these security concerns.
445 :param content: descriptor to be modified
446 :param make_public: if included it is generated as public for reading.
447 :return: None, but content is modified
449 BaseTopic
.format_on_new(content
, make_public
=False)
450 content
["_id"] = content
["username"]
451 content
["password"] = content
["password"]
454 def format_on_edit(final_content
, edit_content
):
456 Modifies final_content descriptor to include the modified date.
458 NOTE: No password salt required because the authentication backend
459 should handle these security concerns.
461 :param final_content: final descriptor generated
462 :param edit_content: alterations to be include
463 :return: None, but final_content is modified
465 BaseTopic
.format_on_edit(final_content
, edit_content
)
466 if "password" in edit_content
:
467 final_content
["password"] = edit_content
["password"]
469 final_content
["project_role_mappings"] = edit_content
["project_role_mappings"]
472 def format_on_show(content
):
474 Modifies the content of the role information to separate the role
475 metadata from the role definition.
477 project_role_mappings
= []
479 for project
in content
["projects"]:
480 for role
in project
["roles"]:
481 project_role_mappings
.append({"project": project
, "role": role
})
483 del content
["projects"]
484 content
["project_role_mappings"] = project_role_mappings
488 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
490 Creates a new entry into the authentication backend.
492 NOTE: Overrides BaseTopic functionality because it doesn't require access to database.
494 :param rollback: list to append created items at database in case a rollback may to be done
495 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
496 :param indata: data to be inserted
497 :param kwargs: used to override the indata descriptor
498 :param headers: http request headers
499 :return: _id: identity of the inserted data.
502 content
= BaseTopic
._remove
_envelop
(indata
)
504 # Override descriptor with query string kwargs
505 BaseTopic
._update
_input
_with
_kwargs
(content
, kwargs
)
506 content
= self
._validate
_input
_new
(content
, session
["force"])
507 self
.check_conflict_on_new(session
, content
)
508 self
.format_on_new(content
, session
["project_id"], make_public
=session
["public"])
509 _id
= self
.auth
.create_user(content
["username"], content
["password"])
510 rollback
.append({"topic": self
.topic
, "_id": _id
})
511 del content
["password"]
512 # self._send_msg("create", content)
514 except ValidationError
as e
:
515 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
517 def show(self
, session
, _id
):
519 Get complete information on an topic
521 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
522 :param _id: server internal id
523 :return: dictionary, raise exception if not found.
525 users
= [user
for user
in self
.auth
.get_user_list() if user
["_id"] == _id
]
528 return self
.format_on_show(users
[0])
530 raise EngineException("Too many users found", HTTPStatus
.CONFLICT
)
532 raise EngineException("User not found", HTTPStatus
.NOT_FOUND
)
534 def edit(self
, session
, _id
, indata
=None, kwargs
=None, content
=None):
536 Updates an user entry.
538 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
540 :param indata: data to be inserted
541 :param kwargs: used to override the indata descriptor
543 :return: _id: identity of the inserted data.
545 indata
= self
._remove
_envelop
(indata
)
547 # Override descriptor with query string kwargs
549 BaseTopic
._update
_input
_with
_kwargs
(indata
, kwargs
)
551 indata
= self
._validate
_input
_edit
(indata
, force
=session
["force"])
554 content
= self
.show(session
, _id
)
555 self
.check_conflict_on_edit(session
, content
, indata
, _id
=_id
)
556 self
.format_on_edit(content
, indata
)
558 if "password" in content
:
559 self
.auth
.change_password(content
["name"], content
["password"])
561 user
= self
.show(session
, _id
)
562 original_mapping
= user
["project_role_mappings"]
563 edit_mapping
= content
["project_role_mappings"]
565 mappings_to_remove
= [mapping
for mapping
in original_mapping
566 if mapping
not in edit_mapping
]
568 mappings_to_add
= [mapping
for mapping
in edit_mapping
569 if mapping
not in original_mapping
]
571 for mapping
in mappings_to_remove
:
572 self
.auth
.remove_role_from_user(
578 for mapping
in mappings_to_add
:
579 self
.auth
.assign_role_to_user(
585 return content
["_id"]
586 except ValidationError
as e
:
587 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
589 def list(self
, session
, filter_q
=None):
591 Get a list of the topic that matches a filter
592 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
593 :param filter_q: filter of data to be applied
594 :return: The list, it can be empty if no one match the filter.
599 users
= [self
.format_on_show(user
) for user
in self
.auth
.get_user_list(filter_q
)]
603 def delete(self
, session
, _id
, dry_run
=False):
605 Delete item by its internal _id
607 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
608 :param _id: server internal id
609 :param force: indicates if deletion must be forced in case of conflict
610 :param dry_run: make checking but do not delete
611 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
613 self
.check_conflict_on_del(session
, _id
, None)
615 v
= self
.auth
.delete_user(_id
)
620 class ProjectTopicAuth(ProjectTopic
):
622 # topic_msg = "projects"
623 # schema_new = project_new_schema
624 # schema_edit = project_edit_schema
626 def __init__(self
, db
, fs
, msg
, auth
):
627 ProjectTopic
.__init
__(self
, db
, fs
, msg
)
630 def check_conflict_on_new(self
, session
, indata
):
632 Check that the data to be inserted is valid
634 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
635 :param indata: data to be inserted
636 :return: None or raises EngineException
638 project
= indata
.get("name")
639 project_list
= list(map(lambda x
: x
["name"], self
.auth
.get_project_list()))
641 if project
in project_list
:
642 raise EngineException("project '{}' exists".format(project
), HTTPStatus
.CONFLICT
)
644 def check_conflict_on_del(self
, session
, _id
, db_content
):
646 Check if deletion can be done because of dependencies if it is not force. To override
648 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
649 :param _id: internal _id
650 :param db_content: The database content of this item _id
651 :return: None if ok or raises EngineException with the conflict
653 projects
= self
.auth
.get_project_list()
654 current_project
= [project
for project
in projects
655 if project
["name"] == session
["project_id"]][0]
657 if _id
== current_project
["_id"]:
658 raise EngineException("You cannot delete your own project", http_code
=HTTPStatus
.CONFLICT
)
660 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
662 Creates a new entry into the authentication backend.
664 NOTE: Overrides BaseTopic functionality because it doesn't require access to database.
666 :param rollback: list to append created items at database in case a rollback may to be done
667 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
668 :param indata: data to be inserted
669 :param kwargs: used to override the indata descriptor
670 :param headers: http request headers
671 :return: _id: identity of the inserted data.
674 content
= BaseTopic
._remove
_envelop
(indata
)
676 # Override descriptor with query string kwargs
677 BaseTopic
._update
_input
_with
_kwargs
(content
, kwargs
)
678 content
= self
._validate
_input
_new
(content
, session
["force"])
679 self
.check_conflict_on_new(session
, content
)
680 self
.format_on_new(content
, project_id
=session
["project_id"], make_public
=session
["public"])
681 _id
= self
.auth
.create_project(content
["name"])
682 rollback
.append({"topic": self
.topic
, "_id": _id
})
683 # self._send_msg("create", content)
685 except ValidationError
as e
:
686 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
688 def show(self
, session
, _id
):
690 Get complete information on an topic
692 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
693 :param _id: server internal id
694 :return: dictionary, raise exception if not found.
696 projects
= [project
for project
in self
.auth
.get_project_list() if project
["_id"] == _id
]
698 if len(projects
) == 1:
700 elif len(projects
) > 1:
701 raise EngineException("Too many projects found", HTTPStatus
.CONFLICT
)
703 raise EngineException("Project not found", HTTPStatus
.NOT_FOUND
)
705 def list(self
, session
, filter_q
=None):
707 Get a list of the topic that matches a filter
709 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
710 :param filter_q: filter of data to be applied
711 :return: The list, it can be empty if no one match the filter.
716 return self
.auth
.get_project_list(filter_q
)
718 def delete(self
, session
, _id
, dry_run
=False):
720 Delete item by its internal _id
722 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
723 :param _id: server internal id
724 :param dry_run: make checking but do not delete
725 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
727 self
.check_conflict_on_del(session
, _id
, None)
729 v
= self
.auth
.delete_project(_id
)
734 class RoleTopicAuth(BaseTopic
):
735 topic
= "roles_operations"
737 schema_new
= roles_new_schema
738 schema_edit
= roles_edit_schema
741 def __init__(self
, db
, fs
, msg
, auth
, ops
):
742 BaseTopic
.__init
__(self
, db
, fs
, msg
)
744 self
.operations
= ops
747 def validate_role_definition(operations
, role_definitions
):
749 Validates the role definition against the operations defined in
750 the resources to operations files.
752 :param operations: operations list
753 :param role_definitions: role definition to test
754 :return: None if ok, raises ValidationError exception on error
756 ignore_fields
= ["_id", "_admin", "name"]
757 for role_def
in role_definitions
.keys():
758 if role_def
in ignore_fields
:
761 if isinstance(role_definitions
[role_def
], bool):
764 raise ValidationError("Operation authorization \".\" should be True/False.")
765 if role_def
[-1] == ".":
766 raise ValidationError("Operation cannot end with \".\"")
768 role_def_matches
= [op
for op
in operations
if op
.startswith(role_def
)]
770 if len(role_def_matches
) == 0:
771 raise ValidationError("No matching operation found.")
773 if not isinstance(role_definitions
[role_def
], bool):
774 raise ValidationError("Operation authorization {} should be True/False.".format(role_def
))
776 def _validate_input_new(self
, input, force
=False):
778 Validates input user content for a new entry.
780 :param input: user input content for the new topic
781 :param force: may be used for being more tolerant
782 :return: The same input content, or a changed version of it.
785 validate_input(input, self
.schema_new
)
786 self
.validate_role_definition(self
.operations
, input)
790 def _validate_input_edit(self
, input, force
=False):
792 Validates input user content for updating an entry.
794 :param input: user input content for the new topic
795 :param force: may be used for being more tolerant
796 :return: The same input content, or a changed version of it.
799 validate_input(input, self
.schema_edit
)
800 self
.validate_role_definition(self
.operations
, input)
804 def check_conflict_on_new(self
, session
, indata
):
806 Check that the data to be inserted is valid
808 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
809 :param indata: data to be inserted
810 :return: None or raises EngineException
812 role
= indata
.get("name")
813 role_list
= list(map(lambda x
: x
["name"], self
.auth
.get_role_list()))
815 if role
in role_list
:
816 raise EngineException("role '{}' exists".format(role
), HTTPStatus
.CONFLICT
)
818 def check_conflict_on_edit(self
, session
, final_content
, edit_content
, _id
):
820 Check that the data to be edited/uploaded is valid
822 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
823 :param final_content: data once modified
824 :param edit_content: incremental data that contains the modifications to apply
825 :param _id: internal _id
826 :return: None or raises EngineException
828 roles
= self
.auth
.get_role_list()
829 system_admin_role
= [role
for role
in roles
830 if roles
["name"] == "system_admin"][0]
832 if _id
== system_admin_role
["_id"]:
833 raise EngineException("You cannot edit system_admin role", http_code
=HTTPStatus
.FORBIDDEN
)
835 def check_conflict_on_del(self
, session
, _id
, db_content
):
837 Check if deletion can be done because of dependencies if it is not force. To override
839 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
840 :param _id: internal _id
841 :param db_content: The database content of this item _id
842 :return: None if ok or raises EngineException with the conflict
844 roles
= self
.auth
.get_role_list()
845 system_admin_role
= [role
for role
in roles
846 if roles
["name"] == "system_admin"][0]
848 if _id
== system_admin_role
["_id"]:
849 raise EngineException("You cannot delete system_admin role", http_code
=HTTPStatus
.FORBIDDEN
)
852 def format_on_new(content
, project_id
=None, make_public
=False):
854 Modifies content descriptor to include _admin
856 :param content: descriptor to be modified
857 :param project_id: if included, it add project read/write permissions
858 :param make_public: if included it is generated as public for reading.
859 :return: None, but content is modified
862 if "_admin" not in content
:
863 content
["_admin"] = {}
864 if not content
["_admin"].get("created"):
865 content
["_admin"]["created"] = now
866 content
["_admin"]["modified"] = now
868 if "." in content
.keys():
869 content
["root"] = content
["."]
872 if "root" not in content
.keys():
873 content
["root"] = False
875 ignore_fields
= ["_id", "_admin", "name"]
876 content_keys
= content
.keys()
877 for role_def
in content_keys
:
878 if role_def
in ignore_fields
:
880 content
[role_def
.replace(".", ":")] = content
[role_def
]
881 del content
[role_def
]
884 def format_on_edit(final_content
, edit_content
):
886 Modifies final_content descriptor to include the modified date.
888 :param final_content: final descriptor generated
889 :param edit_content: alterations to be include
890 :return: None, but final_content is modified
892 final_content
["_admin"]["modified"] = time()
894 ignore_fields
= ["_id", "name", "_admin"]
895 delete_keys
= [key
for key
in final_content
.keys() if key
not in ignore_fields
]
897 for key
in delete_keys
:
898 del final_content
[key
]
900 # Saving the role definition
901 for role_def
, value
in edit_content
.items():
902 final_content
[role_def
.replace(".", ":")] = value
904 if ":" in final_content
.keys():
905 final_content
["root"] = final_content
[":"]
906 del final_content
[":"]
908 if "root" not in final_content
.keys():
909 final_content
["root"] = False
912 def format_on_show(content
):
914 Modifies the content of the role information to separate the role
915 metadata from the role definition. Eases the reading process of the
918 :param definition: role definition to be processed
920 content_keys
= list(content
.keys())
922 content
["_id"] = str(content
["_id"])
924 for key
in content_keys
:
926 content
[key
.replace(":", ".")] = content
[key
]
929 def show(self
, session
, _id
):
931 Get complete information on an topic
933 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
934 :param _id: server internal id
935 :return: dictionary, raise exception if not found.
937 filter_db
= self
._get
_project
_filter
(session
)
938 filter_db
["_id"] = _id
940 role
= self
.db
.get_one(self
.topic
, filter_db
)
941 new_role
= dict(role
)
942 self
.format_on_show(new_role
)
946 def list(self
, session
, filter_q
=None):
948 Get a list of the topic that matches a filter
950 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
951 :param filter_q: filter of data to be applied
952 :return: The list, it can be empty if no one match the filter.
957 if "root" in filter_q
:
958 filter_q
[":"] = filter_q
["root"]
961 if len(filter_q
) > 0:
962 keys
= [key
for key
in filter_q
.keys() if "." in key
]
965 filter_q
[key
.replace(".", ":")] = filter_q
[key
]
968 roles
= self
.db
.get_list(self
.topic
, filter_q
)
972 new_role
= dict(role
)
973 self
.format_on_show(new_role
)
974 new_roles
.append(new_role
)
978 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
980 Creates a new entry into database.
982 :param rollback: list to append created items at database in case a rollback may to be done
983 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
984 :param indata: data to be inserted
985 :param kwargs: used to override the indata descriptor
986 :param headers: http request headers
987 :return: _id: identity of the inserted data.
990 content
= BaseTopic
._remove
_envelop
(indata
)
992 # Override descriptor with query string kwargs
993 BaseTopic
._update
_input
_with
_kwargs
(content
, kwargs
)
994 content
= self
._validate
_input
_new
(content
, session
["force"])
995 self
.check_conflict_on_new(session
, content
)
996 self
.format_on_new(content
, project_id
=session
["project_id"], make_public
=session
["public"])
997 role_name
= content
["name"]
998 role
= self
.auth
.create_role(role_name
)
999 content
["_id"] = role
["_id"]
1000 _id
= self
.db
.create(self
.topic
, content
)
1001 rollback
.append({"topic": self
.topic
, "_id": _id
})
1002 # self._send_msg("create", content)
1004 except ValidationError
as e
:
1005 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
1007 def delete(self
, session
, _id
, dry_run
=False):
1009 Delete item by its internal _id
1011 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
1012 :param _id: server internal id
1013 :param dry_run: make checking but do not delete
1014 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
1016 self
.check_conflict_on_del(session
, _id
, None)
1017 filter_q
= self
._get
_project
_filter
(session
)
1018 filter_q
["_id"] = _id
1020 self
.auth
.delete_role(_id
)
1021 v
= self
.db
.del_one(self
.topic
, filter_q
)
1025 def edit(self
, session
, _id
, indata
=None, kwargs
=None, content
=None):
1027 Updates a role entry.
1029 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
1031 :param indata: data to be inserted
1032 :param kwargs: used to override the indata descriptor
1034 :return: _id: identity of the inserted data.
1036 indata
= self
._remove
_envelop
(indata
)
1038 # Override descriptor with query string kwargs
1040 self
._update
_input
_with
_kwargs
(indata
, kwargs
)
1042 indata
= self
._validate
_input
_edit
(indata
, force
=session
["force"])
1045 content
= self
.show(session
, _id
)
1046 self
.check_conflict_on_edit(session
, content
, indata
, _id
=_id
)
1047 self
.format_on_edit(content
, indata
)
1048 self
.db
.replace(self
.topic
, _id
, content
)
1050 except ValidationError
as e
:
1051 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)