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
["username"] == "admin"][0]
417 if _id
== admin_user
["_id"] and "project_role_mappings" in edit_content
.keys():
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
["_id"], "role": role
["_id"]})
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"])["_id"]
511 if "project_role_mappings" in content
.keys():
512 for mapping
in content
["project_role_mappings"]:
513 self
.auth
.assign_role_to_user(_id
, mapping
["project"], mapping
["role"])
515 rollback
.append({"topic": self
.topic
, "_id": _id
})
516 del content
["password"]
517 # self._send_msg("create", content)
519 except ValidationError
as e
:
520 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
522 def show(self
, session
, _id
):
524 Get complete information on an topic
526 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
527 :param _id: server internal id
528 :return: dictionary, raise exception if not found.
530 users
= [user
for user
in self
.auth
.get_user_list() if user
["_id"] == _id
]
533 return self
.format_on_show(users
[0])
535 raise EngineException("Too many users found", HTTPStatus
.CONFLICT
)
537 raise EngineException("User not found", HTTPStatus
.NOT_FOUND
)
539 def edit(self
, session
, _id
, indata
=None, kwargs
=None, content
=None):
541 Updates an user entry.
543 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
545 :param indata: data to be inserted
546 :param kwargs: used to override the indata descriptor
548 :return: _id: identity of the inserted data.
550 indata
= self
._remove
_envelop
(indata
)
552 # Override descriptor with query string kwargs
554 BaseTopic
._update
_input
_with
_kwargs
(indata
, kwargs
)
556 indata
= self
._validate
_input
_edit
(indata
, force
=session
["force"])
559 content
= self
.show(session
, _id
)
560 self
.check_conflict_on_edit(session
, content
, indata
, _id
=_id
)
561 self
.format_on_edit(content
, indata
)
563 if "password" in content
:
564 self
.auth
.change_password(content
["username"], content
["password"])
566 user
= self
.show(session
, _id
)
567 original_mapping
= user
["project_role_mappings"]
568 edit_mapping
= content
["project_role_mappings"]
570 mappings_to_remove
= [mapping
for mapping
in original_mapping
571 if mapping
not in edit_mapping
]
573 mappings_to_add
= [mapping
for mapping
in edit_mapping
574 if mapping
not in original_mapping
]
576 for mapping
in mappings_to_remove
:
577 self
.auth
.remove_role_from_user(
583 for mapping
in mappings_to_add
:
584 self
.auth
.assign_role_to_user(
590 return content
["_id"]
591 except ValidationError
as e
:
592 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
594 def list(self
, session
, filter_q
=None):
596 Get a list of the topic that matches a filter
597 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
598 :param filter_q: filter of data to be applied
599 :return: The list, it can be empty if no one match the filter.
604 users
= [self
.format_on_show(user
) for user
in self
.auth
.get_user_list(filter_q
)]
608 def delete(self
, session
, _id
, dry_run
=False):
610 Delete item by its internal _id
612 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
613 :param _id: server internal id
614 :param force: indicates if deletion must be forced in case of conflict
615 :param dry_run: make checking but do not delete
616 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
618 self
.check_conflict_on_del(session
, _id
, None)
620 v
= self
.auth
.delete_user(_id
)
625 class ProjectTopicAuth(ProjectTopic
):
627 # topic_msg = "projects"
628 schema_new
= project_new_schema
629 schema_edit
= project_edit_schema
631 def __init__(self
, db
, fs
, msg
, auth
):
632 ProjectTopic
.__init
__(self
, db
, fs
, msg
)
635 def check_conflict_on_new(self
, session
, indata
):
637 Check that the data to be inserted is valid
639 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
640 :param indata: data to be inserted
641 :return: None or raises EngineException
643 project
= indata
.get("name")
644 project_list
= list(map(lambda x
: x
["name"], self
.auth
.get_project_list()))
646 if project
in project_list
:
647 raise EngineException("project '{}' exists".format(project
), HTTPStatus
.CONFLICT
)
649 def check_conflict_on_del(self
, session
, _id
, db_content
):
651 Check if deletion can be done because of dependencies if it is not force. To override
653 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
654 :param _id: internal _id
655 :param db_content: The database content of this item _id
656 :return: None if ok or raises EngineException with the conflict
658 projects
= self
.auth
.get_project_list()
659 current_project
= [project
for project
in projects
660 if project
["name"] in session
["project_id"]][0]
662 if _id
== current_project
["_id"]:
663 raise EngineException("You cannot delete your own project", http_code
=HTTPStatus
.CONFLICT
)
665 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
667 Creates a new entry into the authentication backend.
669 NOTE: Overrides BaseTopic functionality because it doesn't require access to database.
671 :param rollback: list to append created items at database in case a rollback may to be done
672 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
673 :param indata: data to be inserted
674 :param kwargs: used to override the indata descriptor
675 :param headers: http request headers
676 :return: _id: identity of the inserted data.
679 content
= BaseTopic
._remove
_envelop
(indata
)
681 # Override descriptor with query string kwargs
682 BaseTopic
._update
_input
_with
_kwargs
(content
, kwargs
)
683 content
= self
._validate
_input
_new
(content
, session
["force"])
684 self
.check_conflict_on_new(session
, content
)
685 self
.format_on_new(content
, project_id
=session
["project_id"], make_public
=session
["public"])
686 _id
= self
.auth
.create_project(content
["name"])
687 rollback
.append({"topic": self
.topic
, "_id": _id
})
688 # self._send_msg("create", content)
690 except ValidationError
as e
:
691 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
693 def show(self
, session
, _id
):
695 Get complete information on an topic
697 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
698 :param _id: server internal id
699 :return: dictionary, raise exception if not found.
701 projects
= [project
for project
in self
.auth
.get_project_list() if project
["_id"] == _id
]
703 if len(projects
) == 1:
705 elif len(projects
) > 1:
706 raise EngineException("Too many projects found", HTTPStatus
.CONFLICT
)
708 raise EngineException("Project not found", HTTPStatus
.NOT_FOUND
)
710 def list(self
, session
, filter_q
=None):
712 Get a list of the topic that matches a filter
714 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
715 :param filter_q: filter of data to be applied
716 :return: The list, it can be empty if no one match the filter.
721 return self
.auth
.get_project_list(filter_q
)
723 def delete(self
, session
, _id
, dry_run
=False):
725 Delete item by its internal _id
727 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
728 :param _id: server internal id
729 :param dry_run: make checking but do not delete
730 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
732 self
.check_conflict_on_del(session
, _id
, None)
734 v
= self
.auth
.delete_project(_id
)
738 def edit(self
, session
, _id
, indata
=None, kwargs
=None, content
=None):
740 Updates a project entry.
742 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
744 :param indata: data to be inserted
745 :param kwargs: used to override the indata descriptor
747 :return: _id: identity of the inserted data.
749 indata
= self
._remove
_envelop
(indata
)
751 # Override descriptor with query string kwargs
753 BaseTopic
._update
_input
_with
_kwargs
(indata
, kwargs
)
755 indata
= self
._validate
_input
_edit
(indata
, force
=session
["force"])
758 content
= self
.show(session
, _id
)
759 self
.check_conflict_on_edit(session
, content
, indata
, _id
=_id
)
760 self
.format_on_edit(content
, indata
)
763 self
.auth
.update_project(content
["_id"], indata
["name"])
764 except ValidationError
as e
:
765 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
768 class RoleTopicAuth(BaseTopic
):
769 topic
= "roles_operations"
771 schema_new
= roles_new_schema
772 schema_edit
= roles_edit_schema
775 def __init__(self
, db
, fs
, msg
, auth
, ops
):
776 BaseTopic
.__init
__(self
, db
, fs
, msg
)
778 self
.operations
= ops
781 def validate_role_definition(operations
, role_definitions
):
783 Validates the role definition against the operations defined in
784 the resources to operations files.
786 :param operations: operations list
787 :param role_definitions: role definition to test
788 :return: None if ok, raises ValidationError exception on error
790 ignore_fields
= ["_id", "_admin", "name"]
791 for role_def
in role_definitions
.keys():
792 if role_def
in ignore_fields
:
794 if role_def
== "root":
795 if isinstance(role_definitions
[role_def
], bool):
798 raise ValidationError("Operation authorization \".\" should be True/False.")
799 if role_def
[-1] == ":":
800 raise ValidationError("Operation cannot end with \".\"")
802 role_def_matches
= [op
for op
in operations
if op
.startswith(role_def
)]
804 if len(role_def_matches
) == 0:
805 raise ValidationError("No matching operation found.")
807 if not isinstance(role_definitions
[role_def
], bool):
808 raise ValidationError("Operation authorization {} should be True/False.".format(role_def
))
810 def _validate_input_new(self
, input, force
=False):
812 Validates input user content for a new entry.
814 :param input: user input content for the new topic
815 :param force: may be used for being more tolerant
816 :return: The same input content, or a changed version of it.
819 validate_input(input, self
.schema_new
)
820 self
.validate_role_definition(self
.operations
, input)
824 def _validate_input_edit(self
, input, force
=False):
826 Validates input user content for updating an entry.
828 :param input: user input content for the new topic
829 :param force: may be used for being more tolerant
830 :return: The same input content, or a changed version of it.
833 validate_input(input, self
.schema_edit
)
834 self
.validate_role_definition(self
.operations
, input)
838 def check_conflict_on_new(self
, session
, indata
):
840 Check that the data to be inserted is valid
842 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
843 :param indata: data to be inserted
844 :return: None or raises EngineException
846 role
= indata
.get("name")
847 role_list
= list(map(lambda x
: x
["name"], self
.auth
.get_role_list()))
849 if role
in role_list
:
850 raise EngineException("role '{}' exists".format(role
), HTTPStatus
.CONFLICT
)
852 def check_conflict_on_edit(self
, session
, final_content
, edit_content
, _id
):
854 Check that the data to be edited/uploaded is valid
856 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
857 :param final_content: data once modified
858 :param edit_content: incremental data that contains the modifications to apply
859 :param _id: internal _id
860 :return: None or raises EngineException
862 roles
= self
.auth
.get_role_list()
863 system_admin_role
= [role
for role
in roles
864 if role
["name"] == "system_admin"][0]
866 if _id
== system_admin_role
["_id"]:
867 raise EngineException("You cannot edit system_admin role", http_code
=HTTPStatus
.FORBIDDEN
)
869 def check_conflict_on_del(self
, session
, _id
, db_content
):
871 Check if deletion can be done because of dependencies if it is not force. To override
873 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
874 :param _id: internal _id
875 :param db_content: The database content of this item _id
876 :return: None if ok or raises EngineException with the conflict
878 roles
= self
.auth
.get_role_list()
879 system_admin_role
= [role
for role
in roles
880 if role
["name"] == "system_admin"][0]
882 if _id
== system_admin_role
["_id"]:
883 raise EngineException("You cannot delete system_admin role", http_code
=HTTPStatus
.FORBIDDEN
)
886 def format_on_new(content
, project_id
=None, make_public
=False):
888 Modifies content descriptor to include _admin
890 :param content: descriptor to be modified
891 :param project_id: if included, it add project read/write permissions
892 :param make_public: if included it is generated as public for reading.
893 :return: None, but content is modified
896 if "_admin" not in content
:
897 content
["_admin"] = {}
898 if not content
["_admin"].get("created"):
899 content
["_admin"]["created"] = now
900 content
["_admin"]["modified"] = now
902 if ":" in content
.keys():
903 content
["root"] = content
[":"]
906 if "root" not in content
.keys():
907 content
["root"] = False
910 def format_on_edit(final_content
, edit_content
):
912 Modifies final_content descriptor to include the modified date.
914 :param final_content: final descriptor generated
915 :param edit_content: alterations to be include
916 :return: None, but final_content is modified
918 final_content
["_admin"]["modified"] = time()
920 ignore_fields
= ["_id", "name", "_admin"]
921 delete_keys
= [key
for key
in final_content
.keys() if key
not in ignore_fields
]
923 for key
in delete_keys
:
924 del final_content
[key
]
926 # Saving the role definition
927 for role_def
, value
in edit_content
.items():
928 final_content
[role_def
] = value
930 if ":" in final_content
.keys():
931 final_content
["root"] = final_content
[":"]
932 del final_content
[":"]
934 if "root" not in final_content
.keys():
935 final_content
["root"] = False
938 def format_on_show(content
):
940 Modifies the content of the role information to separate the role
941 metadata from the role definition. Eases the reading process of the
944 :param definition: role definition to be processed
946 content
["_id"] = str(content
["_id"])
948 def show(self
, session
, _id
):
950 Get complete information on an topic
952 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
953 :param _id: server internal id
954 :return: dictionary, raise exception if not found.
956 filter_db
= {"_id": _id
}
958 role
= self
.db
.get_one(self
.topic
, filter_db
)
959 new_role
= dict(role
)
960 self
.format_on_show(new_role
)
964 def list(self
, session
, filter_q
=None):
966 Get a list of the topic that matches a filter
968 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
969 :param filter_q: filter of data to be applied
970 :return: The list, it can be empty if no one match the filter.
976 filter_q
["root"] = filter_q
[":"]
978 for key
in filter_q
.keys():
981 filter_q
[key
] = filter_q
[key
] in ["True", "true"]
983 roles
= self
.db
.get_list(self
.topic
, filter_q
)
987 new_role
= dict(role
)
988 self
.format_on_show(new_role
)
989 new_roles
.append(new_role
)
993 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
995 Creates a new entry into database.
997 :param rollback: list to append created items at database in case a rollback may to be done
998 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
999 :param indata: data to be inserted
1000 :param kwargs: used to override the indata descriptor
1001 :param headers: http request headers
1002 :return: _id: identity of the inserted data.
1005 content
= BaseTopic
._remove
_envelop
(indata
)
1007 # Override descriptor with query string kwargs
1008 BaseTopic
._update
_input
_with
_kwargs
(content
, kwargs
)
1009 content
= self
._validate
_input
_new
(content
, session
["force"])
1010 self
.check_conflict_on_new(session
, content
)
1011 self
.format_on_new(content
, project_id
=session
["project_id"], make_public
=session
["public"])
1012 role_name
= content
["name"]
1013 role
= self
.auth
.create_role(role_name
)
1014 content
["_id"] = role
["_id"]
1015 _id
= self
.db
.create(self
.topic
, content
)
1016 rollback
.append({"topic": self
.topic
, "_id": _id
})
1017 # self._send_msg("create", content)
1019 except ValidationError
as e
:
1020 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
1022 def delete(self
, session
, _id
, dry_run
=False):
1024 Delete item by its internal _id
1026 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
1027 :param _id: server internal id
1028 :param dry_run: make checking but do not delete
1029 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
1031 self
.check_conflict_on_del(session
, _id
, None)
1032 filter_q
= {"_id": _id
}
1034 self
.auth
.delete_role(_id
)
1035 v
= self
.db
.del_one(self
.topic
, filter_q
)
1039 def edit(self
, session
, _id
, indata
=None, kwargs
=None, content
=None):
1041 Updates a role entry.
1043 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
1045 :param indata: data to be inserted
1046 :param kwargs: used to override the indata descriptor
1048 :return: _id: identity of the inserted data.
1050 indata
= self
._remove
_envelop
(indata
)
1052 # Override descriptor with query string kwargs
1054 self
._update
_input
_with
_kwargs
(indata
, kwargs
)
1056 indata
= self
._validate
_input
_edit
(indata
, force
=session
["force"])
1059 content
= self
.show(session
, _id
)
1060 self
.check_conflict_on_edit(session
, content
, indata
, _id
=_id
)
1061 self
.format_on_edit(content
, indata
)
1062 self
.db
.replace(self
.topic
, _id
, content
)
1064 except ValidationError
as e
:
1065 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)