summaryrefslogtreecommitdiff
path: root/app/Core/User/UserProviderInterface.php
blob: 07e01f42df1f844f3cb94176fafd67b14e7143ea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
<?php

namespace Kanboard\Core\User;

/**
 * User Provider Interface
 *
 * @package  user
 * @author   Frederic Guillot
 */
interface UserProviderInterface
{
    /**
     * Return true to allow automatic user creation
     *
     * @access public
     * @return boolean
     */
    public function isUserCreationAllowed();

    /**
     * Get external id column name
     *
     * Example: google_id, github_id, gitlab_id...
     *
     * @access public
     * @return string
     */
    public function getExternalIdColumn();

    /**
     * Get internal id
     *
     * If a value is returned the user properties won't be updated in the local database
     *
     * @access public
     * @return integer
     */
    public function getInternalId();

    /**
     * Get external id
     *
     * @access public
     * @return string
     */
    public function getExternalId();

    /**
     * Get user role
     *
     * Return an empty string to not override role stored in the database
     *
     * @access public
     * @return string
     */
    public function getRole();

    /**
     * Get username
     *
     * @access public
     * @return string
     */
    public function getUsername();

    /**
     * Get user full name
     *
     * @access public
     * @return string
     */
    public function getName();

    /**
     * Get user email
     *
     * @access public
     * @return string
     */
    public function getEmail();

    /**
     * Get external group ids
     *
     * A synchronization is done at login time,
     * the user will be member of those groups if they exists in the database
     *
     * @access public
     * @return string[]
     */
    public function getExternalGroupIds();

    /**
     * Get extra user attributes
     *
     * Example: is_ldap_user, disable_login_form, notifications_enabled...
     *
     * @access public
     * @return array
     */
    public function getExtraAttributes();
}