blob: d0fc5eeed0b91c7eb2343f8f2d2c4331aa8365b5 [file] [log] [blame]
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -05001description: >
Patrick Williamsa1347412022-12-06 10:56:22 -06002 Implement to update LDAP mandatory properties. Any service implementing
3 User.Ldap.Config interface on one or more objects must implement
4 Object.Enable interface on the object.
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -05005
6properties:
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -05007 - name: LDAPServerURI
8 type: string
9 description: >
10 Specifies the LDAP URI of the server to connect to.
Nagaraju Goruganti95fafa82018-09-30 23:25:42 -050011 errors:
Patrick Williams8da396c2022-03-14 14:21:02 -050012 - xyz.openbmc_project.Common.Error.InternalFailure
13 - xyz.openbmc_project.Common.Error.InvalidArgument
14 - xyz.openbmc_project.Common.Error.NoCACertificate
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -050015 - name: LDAPBindDN
16 type: string
17 description: >
18 Specifies the distinguished name with which to bind to the directory
19 server for lookups.
Nagaraju Goruganti95fafa82018-09-30 23:25:42 -050020 errors:
Patrick Williams8da396c2022-03-14 14:21:02 -050021 - xyz.openbmc_project.Common.Error.InternalFailure
22 - xyz.openbmc_project.Common.Error.InvalidArgument
Ratan Gupta46239082019-03-20 07:11:40 +053023 - name: LDAPBindDNPassword
24 type: string
25 description: >
26 Specifies the credentials with which to bind,Implementation should
Patrick Williamsa1347412022-12-06 10:56:22 -060027 consider changing the permissions of the underlying file to only grant
28 access to the root user. This property value should not be reflected
29 on the D-bus object itself. Implementation can use the given value and
30 update the service implementing the LDAP client.This is just to
31 facilitate the support for changing the bin dn password if needed.
32 Currently this property is over D-bus, There are security concerns for
33 the same, but once we find better way to update the ldap password we
34 would fix it.
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -050035 - name: LDAPBaseDN
36 type: string
37 description: >
38 Specifies the base distinguished name to use as search base.
Nagaraju Goruganti95fafa82018-09-30 23:25:42 -050039 errors:
Patrick Williams8da396c2022-03-14 14:21:02 -050040 - xyz.openbmc_project.Common.Error.InternalFailure
41 - xyz.openbmc_project.Common.Error.InvalidArgument
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -050042 - name: LDAPSearchScope
43 type: enum[self.SearchScope]
44 description: >
45 Specifies the search scope:subtree, one level or base object.
Lei YUcb1d0592019-01-09 10:25:49 +080046 default: sub
Nagaraju Goruganti95fafa82018-09-30 23:25:42 -050047 errors:
Patrick Williams8da396c2022-03-14 14:21:02 -050048 - xyz.openbmc_project.Common.Error.InternalFailure
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -050049 - name: LDAPType
50 type: enum[self.Type]
51 description: >
52 Specifies the the configured server is ActiveDirectory(AD) or
Patrick Williamsa1347412022-12-06 10:56:22 -060053 OpenLdap. It's just an indication for the LDAP stack running on the
54 BMC, in case the app is implemented in such a way that it has to react
55 differently for AD vs openldap. This property is readonly, Once the
56 D-Bus object gets created then this property should not be modifiable.
Nagaraju Goruganti95fafa82018-09-30 23:25:42 -050057 errors:
Patrick Williams8da396c2022-03-14 14:21:02 -050058 - xyz.openbmc_project.Common.Error.InternalFailure
59 - xyz.openbmc_project.Common.Error.NotAllowed
Ratan Gupta910b0d92019-03-08 20:40:49 +053060 - name: GroupNameAttribute
61 type: string
62 description: >
Patrick Williamsa1347412022-12-06 10:56:22 -060063 The value of this property shall be the attribute name that contains
64 the name of the Group in the LDAP server.
Ratan Gupta910b0d92019-03-08 20:40:49 +053065 - name: UserNameAttribute
66 type: string
67 description: >
Patrick Williamsa1347412022-12-06 10:56:22 -060068 The value of this property shall be the attribute name that contains
69 the username in the LDAP server.
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -050070enumerations:
71 - name: SearchScope
72 description: >
73 Possible base scopes.
74 values:
Patrick Williams8da396c2022-03-14 14:21:02 -050075 - name: sub
76 - name: one
77 - name: base
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -050078
79 - name: Type
80 description: >
81 Possible LDAP Types.
82 values:
Patrick Williams8da396c2022-03-14 14:21:02 -050083 - name: ActiveDirectory
84 - name: OpenLdap