Passed
Push — develop ( 87ed0e...c14b61 )
by Plexxi
06:36 queued 03:57
created

BaseAuthenticationBackend.get_user_groups()   A

Complexity

Conditions 1

Size

Total Lines 9

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 1
dl 0
loc 9
rs 9.6666
c 0
b 0
f 0
1
# Licensed to the StackStorm, Inc ('StackStorm') under one or more
2
# contributor license agreements.  See the NOTICE file distributed with
3
# this work for additional information regarding copyright ownership.
4
# The ASF licenses this file to You under the Apache License, Version 2.0
5
# (the "License"); you may not use this file except in compliance with
6
# the License.  You may obtain a copy of the License at
7
#
8
#     http://www.apache.org/licenses/LICENSE-2.0
9
#
10
# Unless required by applicable law or agreed to in writing, software
11
# distributed under the License is distributed on an "AS IS" BASIS,
12
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
# See the License for the specific language governing permissions and
14
# limitations under the License.
15
16
import abc
17
18
import six
19
20
from st2auth.backends.constants import AuthBackendCapability
21
22
__all__ = [
23
    'BaseAuthenticationBackend'
24
]
25
26
27
@six.add_metaclass(abc.ABCMeta)
28
class BaseAuthenticationBackend(object):
29
    """
30
    Base authentication class.
31
    """
32
33
    # Capabilities offered by the auth backend
34
    CAPABILITIES = (
35
        AuthBackendCapability.CAN_AUTHENTICATE_USER
36
    )
37
38
    @abc.abstractmethod
39
    def authenticate(self, username, password):
40
        pass
41
42
    def get_user(self, username):
43
        """
44
        Retrieve information (user account) for a particular user.
45
46
        Note: Not all the auth backends may implement this.
47
48
        :rtype: ``dict``
49
        """
50
        raise NotImplementedError('get_user() not implemented for this backend')
51
52
    def get_user_groups(self, username):
53
        """
54
        Retrieve a list of groups a particular user is a member of.
55
56
        Note: Not all the auth backends may implement this.
57
58
        :rtype: ``list`` of ``str``
59
        """
60
        raise NotImplementedError('get_groups() not implemented for this backend')
61