Statistics
| Branch: | Tag: | Revision:

root / pithos / backends / lib / sqlalchemy / permissions.py @ cf341da4

History | View | Annotate | Download (5.8 kB)

1
# Copyright 2011-2012 GRNET S.A. All rights reserved.
2
# 
3
# Redistribution and use in source and binary forms, with or
4
# without modification, are permitted provided that the following
5
# conditions are met:
6
# 
7
#   1. Redistributions of source code must retain the above
8
#      copyright notice, this list of conditions and the following
9
#      disclaimer.
10
# 
11
#   2. Redistributions in binary form must reproduce the above
12
#      copyright notice, this list of conditions and the following
13
#      disclaimer in the documentation and/or other materials
14
#      provided with the distribution.
15
# 
16
# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
17
# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19
# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
20
# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
23
# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
24
# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
26
# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27
# POSSIBILITY OF SUCH DAMAGE.
28
# 
29
# The views and conclusions contained in the software and
30
# documentation are those of the authors and should not be
31
# interpreted as representing official policies, either expressed
32
# or implied, of GRNET S.A.
33

    
34
from sqlalchemy.sql import select, literal
35
from sqlalchemy.sql.expression import join, union
36

    
37
from xfeatures import XFeatures
38
from groups import Groups
39
from public import Public
40

    
41

    
42
READ = 0
43
WRITE = 1
44

    
45

    
46
class Permissions(XFeatures, Groups, Public):
47
    
48
    def __init__(self, **params):
49
        XFeatures.__init__(self, **params)
50
        Groups.__init__(self, **params)
51
        Public.__init__(self, **params)
52
    
53
    def access_grant(self, path, access, members=()):
54
        """Grant members with access to path.
55
           Members can also be '*' (all),
56
           or some group specified as 'owner:group'."""
57
        
58
        if not members:
59
            return
60
        feature = self.xfeature_create(path)
61
        self.feature_setmany(feature, access, members)
62
    
63
    def access_set(self, path, permissions):
64
        """Set permissions for path. The permissions dict
65
           maps 'read', 'write' keys to member lists."""
66
        
67
        r = permissions.get('read', [])
68
        w = permissions.get('write', [])
69
        if not r and not w:
70
            self.xfeature_destroy(path)
71
            return
72
        feature = self.xfeature_create(path)
73
        if r:
74
            self.feature_clear(feature, READ)
75
            self.feature_setmany(feature, READ, r)
76
        if w:
77
            self.feature_clear(feature, WRITE)
78
            self.feature_setmany(feature, WRITE, w)
79
    
80
    def access_get(self, path):
81
        """Get permissions for path."""
82
        
83
        feature = self.xfeature_get(path)
84
        if not feature:
85
            return {}
86
        permissions = self.feature_dict(feature)
87
        if READ in permissions:
88
            permissions['read'] = permissions[READ]
89
            del(permissions[READ])
90
        if WRITE in permissions:
91
            permissions['write'] = permissions[WRITE]
92
            del(permissions[WRITE])
93
        return permissions
94
    
95
    def access_clear(self, path):
96
        """Revoke access to path (both permissions and public)."""
97
        
98
        self.xfeature_destroy(path)
99
        self.public_unset(path)
100
    
101
    def access_check(self, path, access, member):
102
        """Return true if the member has this access to the path."""
103
        
104
        feature = self.xfeature_get(path)
105
        if not feature:
106
            return False
107
        members = self.feature_get(feature, access)
108
        if member in members or '*' in members:
109
            return True
110
        for owner, group in self.group_parents(member):
111
            if owner + ':' + group in members:
112
                return True
113
        return False
114
    
115
    def access_inherit(self, path):
116
        """Return the paths influencing the access for path."""
117
        
118
        r = self.xfeature_inherit(path)
119
        if not r:
120
            return []
121
        
122
        # Only keep path components.
123
        parts = path.rstrip('/').split('/')
124
        valid = []
125
        for i in range(1, len(parts)):
126
            subp = '/'.join(parts[:i + 1])
127
            valid.append(subp)
128
            valid.append(subp + '/')
129
        return [x[0] for x in r if x[0] in valid]
130
    
131
    def access_list_paths(self, member, prefix=None):
132
        """Return the list of paths granted to member."""
133
        
134
        xfeatures_xfeaturevals =  self.xfeatures.join(self.xfeaturevals)
135
        
136
        selectable = (self.groups.c.owner + ':' + self.groups.c.name)
137
        member_groups = select([selectable.label('value')],
138
            self.groups.c.member == member)
139
        
140
        members = select([literal(member).label('value')])
141
        any = select([literal('*').label('value')])
142
        
143
        u = union(member_groups, members, any).alias()
144
        inner_join = join(xfeatures_xfeaturevals, u,
145
                    self.xfeaturevals.c.value == u.c.value)
146
        s = select([self.xfeatures.c.path], from_obj=[inner_join]).distinct()
147
        if prefix:
148
            s = s.where(self.xfeatures.c.path.like(self.escape_like(prefix) + '%', escape='\\'))
149
        r = self.conn.execute(s)
150
        l = [row[0] for row in r.fetchall()]
151
        r.close()
152
        return l
153
    
154
    def access_list_shared(self, prefix=''):
155
        """Return the list of shared paths."""
156
        
157
        s = select([self.xfeatures.c.path],
158
            self.xfeatures.c.path.like(self.escape_like(prefix) + '%', escape='\\')).order_by(self.xfeatures.c.path.asc())
159
        r = self.conn.execute(s)
160
        l = [row[0] for row in r.fetchall()]
161
        r.close()
162
        return l