a7373014494aed88d296aa7faea8f19214ea90e0
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
, role
])
483 del content
["projects"]
484 content
["project_role_mappings"] = project_role_mappings
486 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
488 Creates a new entry into the authentication backend.
490 NOTE: Overrides BaseTopic functionality because it doesn't require access to database.
492 :param rollback: list to append created items at database in case a rollback may to be done
493 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
494 :param indata: data to be inserted
495 :param kwargs: used to override the indata descriptor
496 :param headers: http request headers
497 :return: _id: identity of the inserted data.
500 content
= BaseTopic
._remove
_envelop
(indata
)
502 # Override descriptor with query string kwargs
503 BaseTopic
._update
_input
_with
_kwargs
(content
, kwargs
)
504 content
= self
._validate
_input
_new
(content
, session
["force"])
505 self
.check_conflict_on_new(session
, content
)
506 self
.format_on_new(content
, session
["project_id"], make_public
=session
["public"])
507 _id
= self
.auth
.create_user(content
["username"], content
["password"])
508 rollback
.append({"topic": self
.topic
, "_id": _id
})
509 del content
["password"]
510 # self._send_msg("create", content)
512 except ValidationError
as e
:
513 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
515 def show(self
, session
, _id
):
517 Get complete information on an topic
519 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
520 :param _id: server internal id
521 :return: dictionary, raise exception if not found.
523 users
= [user
for user
in self
.auth
.get_user_list() if user
["_id"] == _id
]
526 return self
.format_on_show(users
[0])
528 raise EngineException("Too many users found", HTTPStatus
.CONFLICT
)
530 raise EngineException("User not found", HTTPStatus
.NOT_FOUND
)
532 def edit(self
, session
, _id
, indata
=None, kwargs
=None, content
=None):
534 Updates an user entry.
536 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
538 :param indata: data to be inserted
539 :param kwargs: used to override the indata descriptor
541 :return: _id: identity of the inserted data.
543 indata
= self
._remove
_envelop
(indata
)
545 # Override descriptor with query string kwargs
547 BaseTopic
._update
_input
_with
_kwargs
(indata
, kwargs
)
549 indata
= self
._validate
_input
_edit
(indata
, force
=session
["force"])
552 content
= self
.show(session
, _id
)
553 self
.check_conflict_on_edit(session
, content
, indata
, _id
=_id
)
554 self
.format_on_edit(content
, indata
)
556 if "password" in content
:
557 self
.auth
.change_password(content
["name"], content
["password"])
559 user
= self
.show(session
, _id
)
560 original_mapping
= user
["project_role_mappings"]
561 edit_mapping
= content
["project_role_mappings"]
563 mappings_to_remove
= [mapping
for mapping
in original_mapping
564 if mapping
not in edit_mapping
]
566 mappings_to_add
= [mapping
for mapping
in edit_mapping
567 if mapping
not in original_mapping
]
569 for mapping
in mappings_to_remove
:
570 self
.auth
.remove_role_from_user(
576 for mapping
in mappings_to_add
:
577 self
.auth
.assign_role_to_user(
583 return content
["_id"]
584 except ValidationError
as e
:
585 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
587 def list(self
, session
, filter_q
=None):
589 Get a list of the topic that matches a filter
590 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
591 :param filter_q: filter of data to be applied
592 :return: The list, it can be empty if no one match the filter.
597 users
= [self
.format_on_show(user
) for user
in self
.auth
.get_user_list(filter_q
)]
601 def delete(self
, session
, _id
, dry_run
=False):
603 Delete item by its internal _id
605 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
606 :param _id: server internal id
607 :param force: indicates if deletion must be forced in case of conflict
608 :param dry_run: make checking but do not delete
609 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
611 self
.check_conflict_on_del(session
, _id
, None)
613 v
= self
.auth
.delete_user(_id
)
618 class ProjectTopicAuth(ProjectTopic
):
620 # topic_msg = "projects"
621 # schema_new = project_new_schema
622 # schema_edit = project_edit_schema
624 def __init__(self
, db
, fs
, msg
, auth
):
625 ProjectTopic
.__init
__(self
, db
, fs
, msg
)
628 def check_conflict_on_new(self
, session
, indata
):
630 Check that the data to be inserted is valid
632 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
633 :param indata: data to be inserted
634 :return: None or raises EngineException
636 project
= indata
.get("name")
637 project_list
= list(map(lambda x
: x
["name"], self
.auth
.get_project_list()))
639 if project
in project_list
:
640 raise EngineException("project '{}' exists".format(project
), HTTPStatus
.CONFLICT
)
642 def check_conflict_on_del(self
, session
, _id
, db_content
):
644 Check if deletion can be done because of dependencies if it is not force. To override
646 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
647 :param _id: internal _id
648 :param db_content: The database content of this item _id
649 :return: None if ok or raises EngineException with the conflict
651 projects
= self
.auth
.get_project_list()
652 current_project
= [project
for project
in projects
653 if project
["name"] == session
["project_id"]][0]
655 if _id
== current_project
["_id"]:
656 raise EngineException("You cannot delete your own project", http_code
=HTTPStatus
.CONFLICT
)
658 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
660 Creates a new entry into the authentication backend.
662 NOTE: Overrides BaseTopic functionality because it doesn't require access to database.
664 :param rollback: list to append created items at database in case a rollback may to be done
665 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
666 :param indata: data to be inserted
667 :param kwargs: used to override the indata descriptor
668 :param headers: http request headers
669 :return: _id: identity of the inserted data.
672 content
= BaseTopic
._remove
_envelop
(indata
)
674 # Override descriptor with query string kwargs
675 BaseTopic
._update
_input
_with
_kwargs
(content
, kwargs
)
676 content
= self
._validate
_input
_new
(content
, session
["force"])
677 self
.check_conflict_on_new(session
, content
)
678 self
.format_on_new(content
, project_id
=session
["project_id"], make_public
=session
["public"])
679 _id
= self
.auth
.create_project(content
["name"])
680 rollback
.append({"topic": self
.topic
, "_id": _id
})
681 # self._send_msg("create", content)
683 except ValidationError
as e
:
684 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
686 def show(self
, session
, _id
):
688 Get complete information on an topic
690 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
691 :param _id: server internal id
692 :return: dictionary, raise exception if not found.
694 projects
= [project
for project
in self
.auth
.get_project_list() if project
["_id"] == _id
]
696 if len(projects
) == 1:
698 elif len(projects
) > 1:
699 raise EngineException("Too many projects found", HTTPStatus
.CONFLICT
)
701 raise EngineException("Project not found", HTTPStatus
.NOT_FOUND
)
703 def list(self
, session
, filter_q
=None):
705 Get a list of the topic that matches a filter
707 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
708 :param filter_q: filter of data to be applied
709 :return: The list, it can be empty if no one match the filter.
714 return self
.auth
.get_project_list(filter_q
)
716 def delete(self
, session
, _id
, dry_run
=False):
718 Delete item by its internal _id
720 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
721 :param _id: server internal id
722 :param dry_run: make checking but do not delete
723 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
725 self
.check_conflict_on_del(session
, _id
, None)
727 v
= self
.auth
.delete_project(_id
)
732 class RoleTopicAuth(BaseTopic
):
733 topic
= "roles_operations"
735 schema_new
= roles_new_schema
736 schema_edit
= roles_edit_schema
739 def __init__(self
, db
, fs
, msg
, auth
, ops
):
740 BaseTopic
.__init
__(self
, db
, fs
, msg
)
742 self
.operations
= ops
745 def validate_role_definition(operations
, role_definitions
):
747 Validates the role definition against the operations defined in
748 the resources to operations files.
750 :param operations: operations list
751 :param role_definitions: role definition to test
752 :return: None if ok, raises ValidationError exception on error
754 ignore_fields
= ["_id", "_admin", "name"]
755 for role_def
in role_definitions
.keys():
756 if role_def
in ignore_fields
:
759 if isinstance(role_definitions
[role_def
], bool):
762 raise ValidationError("Operation authorization \".\" should be True/False.")
763 if role_def
[-1] == ".":
764 raise ValidationError("Operation cannot end with \".\"")
766 role_def_matches
= [op
for op
in operations
if op
.startswith(role_def
)]
768 if len(role_def_matches
) == 0:
769 raise ValidationError("No matching operation found.")
771 if not isinstance(role_definitions
[role_def
], bool):
772 raise ValidationError("Operation authorization {} should be True/False.".format(role_def
))
774 def _validate_input_new(self
, input, force
=False):
776 Validates input user content for a new entry.
778 :param input: user input content for the new topic
779 :param force: may be used for being more tolerant
780 :return: The same input content, or a changed version of it.
783 validate_input(input, self
.schema_new
)
784 self
.validate_role_definition(self
.operations
, input)
788 def _validate_input_edit(self
, input, force
=False):
790 Validates input user content for updating an entry.
792 :param input: user input content for the new topic
793 :param force: may be used for being more tolerant
794 :return: The same input content, or a changed version of it.
797 validate_input(input, self
.schema_edit
)
798 self
.validate_role_definition(self
.operations
, input)
802 def check_conflict_on_new(self
, session
, indata
):
804 Check that the data to be inserted is valid
806 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
807 :param indata: data to be inserted
808 :return: None or raises EngineException
810 role
= indata
.get("name")
811 role_list
= list(map(lambda x
: x
["name"], self
.auth
.get_role_list()))
813 if role
in role_list
:
814 raise EngineException("role '{}' exists".format(role
), HTTPStatus
.CONFLICT
)
816 def check_conflict_on_edit(self
, session
, final_content
, edit_content
, _id
):
818 Check that the data to be edited/uploaded is valid
820 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
821 :param final_content: data once modified
822 :param edit_content: incremental data that contains the modifications to apply
823 :param _id: internal _id
824 :return: None or raises EngineException
826 roles
= self
.auth
.get_role_list()
827 system_admin_role
= [role
for role
in roles
828 if roles
["name"] == "system_admin"][0]
830 if _id
== system_admin_role
["_id"]:
831 raise EngineException("You cannot edit system_admin role", http_code
=HTTPStatus
.FORBIDDEN
)
833 def check_conflict_on_del(self
, session
, _id
, db_content
):
835 Check if deletion can be done because of dependencies if it is not force. To override
837 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
838 :param _id: internal _id
839 :param db_content: The database content of this item _id
840 :return: None if ok or raises EngineException with the conflict
842 roles
= self
.auth
.get_role_list()
843 system_admin_role
= [role
for role
in roles
844 if roles
["name"] == "system_admin"][0]
846 if _id
== system_admin_role
["_id"]:
847 raise EngineException("You cannot delete system_admin role", http_code
=HTTPStatus
.FORBIDDEN
)
850 def format_on_new(content
, project_id
=None, make_public
=False):
852 Modifies content descriptor to include _admin
854 :param content: descriptor to be modified
855 :param project_id: if included, it add project read/write permissions
856 :param make_public: if included it is generated as public for reading.
857 :return: None, but content is modified
860 if "_admin" not in content
:
861 content
["_admin"] = {}
862 if not content
["_admin"].get("created"):
863 content
["_admin"]["created"] = now
864 content
["_admin"]["modified"] = now
867 ignore_fields
= ["_id", "_admin", "name"]
868 content_keys
= content
.keys()
869 for role_def
in content_keys
:
870 if role_def
in ignore_fields
:
872 content
[role_def
.replace(".", ":")] = content
[role_def
]
873 del content
[role_def
]
876 def format_on_edit(final_content
, edit_content
):
878 Modifies final_content descriptor to include the modified date.
880 :param final_content: final descriptor generated
881 :param edit_content: alterations to be include
882 :return: None, but final_content is modified
884 final_content
["_admin"]["modified"] = time()
886 ignore_fields
= ["_id", "name", "_admin"]
887 delete_keys
= [key
for key
in final_content
.keys() if key
not in ignore_fields
]
889 for key
in delete_keys
:
890 del final_content
[key
]
892 # Saving the role definition
893 for role_def
, value
in edit_content
.items():
894 final_content
[role_def
.replace(".", ":")] = value
896 if ":" not in final_content
.keys():
897 final_content
[":"] = False
900 def format_on_show(content
):
902 Modifies the content of the role information to separate the role
903 metadata from the role definition. Eases the reading process of the
906 :param definition: role definition to be processed
908 content_keys
= list(content
.keys())
910 for key
in content_keys
:
912 content
[key
.replace(":", ".")] = content
[key
]
915 def show(self
, session
, _id
):
917 Get complete information on an topic
919 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
920 :param _id: server internal id
921 :return: dictionary, raise exception if not found.
923 filter_db
= self
._get
_project
_filter
(session
)
924 filter_db
["_id"] = _id
926 role
= self
.db
.get_one(self
.topic
, filter_db
)
927 new_role
= dict(role
)
928 self
.format_on_show(new_role
)
932 def list(self
, session
, filter_q
=None):
934 Get a list of the topic that matches a filter
936 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
937 :param filter_q: filter of data to be applied
938 :return: The list, it can be empty if no one match the filter.
943 if "root" in filter_q
:
944 filter_q
[":"] = filter_q
["root"]
947 if len(filter_q
) > 0:
948 keys
= [key
for key
in filter_q
.keys() if "." in key
]
951 filter_q
[key
.replace(".", ":")] = filter_q
[key
]
954 roles
= self
.db
.get_list(self
.topic
, filter_q
)
958 new_role
= dict(role
)
959 self
.format_on_show(new_role
)
960 new_roles
.append(new_role
)
964 def new(self
, rollback
, session
, indata
=None, kwargs
=None, headers
=None):
966 Creates a new entry into database.
968 :param rollback: list to append created items at database in case a rollback may to be done
969 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
970 :param indata: data to be inserted
971 :param kwargs: used to override the indata descriptor
972 :param headers: http request headers
973 :return: _id: identity of the inserted data.
976 content
= BaseTopic
._remove
_envelop
(indata
)
978 # Override descriptor with query string kwargs
979 BaseTopic
._update
_input
_with
_kwargs
(content
, kwargs
)
980 content
= self
._validate
_input
_new
(content
, session
["force"])
981 self
.check_conflict_on_new(session
, content
)
982 self
.format_on_new(content
, project_id
=session
["project_id"], make_public
=session
["public"])
983 role_name
= content
["name"]
984 role
= self
.auth
.create_role(role_name
)
985 content
["_id"] = role
["_id"]
986 _id
= self
.db
.create(self
.topic
, content
)
987 rollback
.append({"topic": self
.topic
, "_id": _id
})
988 # self._send_msg("create", content)
990 except ValidationError
as e
:
991 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)
993 def delete(self
, session
, _id
, dry_run
=False):
995 Delete item by its internal _id
997 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
998 :param _id: server internal id
999 :param dry_run: make checking but do not delete
1000 :return: dictionary with deleted item _id. It raises EngineException on error: not found, conflict, ...
1002 self
.check_conflict_on_del(session
, _id
, None)
1003 filter_q
= self
._get
_project
_filter
(session
)
1004 filter_q
["_id"] = _id
1006 self
.auth
.delete_role(_id
)
1007 v
= self
.db
.del_one(self
.topic
, filter_q
)
1011 def edit(self
, session
, _id
, indata
=None, kwargs
=None, content
=None):
1013 Updates a role entry.
1015 :param session: contains "username", "admin", "force", "public", "project_id", "set_project"
1017 :param indata: data to be inserted
1018 :param kwargs: used to override the indata descriptor
1020 :return: _id: identity of the inserted data.
1022 indata
= self
._remove
_envelop
(indata
)
1024 # Override descriptor with query string kwargs
1026 self
._update
_input
_with
_kwargs
(indata
, kwargs
)
1028 indata
= self
._validate
_input
_edit
(indata
, force
=session
["force"])
1031 content
= self
.show(session
, _id
)
1032 self
.check_conflict_on_edit(session
, content
, indata
, _id
=_id
)
1033 self
.format_on_edit(content
, indata
)
1034 self
.db
.replace(self
.topic
, _id
, content
)
1036 except ValidationError
as e
:
1037 raise EngineException(e
, HTTPStatus
.UNPROCESSABLE_ENTITY
)