blob: ea16928603fc8ea2684d14a7dc17664458f63733 [file] [log] [blame]
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -05001description: >
2 Implement to create LDAP name service daemon configuration file.
3
4methods:
5 - name: CreateConfig
6 description: >
7 This method always creates a new config file as well as a D-Bus
8 object to represent the config, it will destroy an existing one,
9 if found. In other words, this is not an update API. Individual
10 properties can be updated as per the
11 xyz/openbmc_project/User/Ldap/Config.interface.yaml.
12 parameters:
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -050013 - name: LDAPServerURI
14 type: string
15 description: >
16 Specifies the LDAP URI of the server to connect to.
17 - name: LDAPBindDN
18 type: string
19 description: >
20 Specifies the distinguished name with which to bind to the
21 directory server for lookups.
22 - name: LDAPBaseDN
23 type: string
24 description: >
25 Specifies the base distinguished name to use as search base.
26 - name: LDAPBINDDNpassword
27 type: string
28 description: >
29 Specifies the clear text credentials with which to bind. This
30 option is only applicable when used with LDAPBindDN.
31 - name: LDAPSearchScope
32 type: enum[self.SearchScope]
33 description: >
34 Specifies the search scope:subtree, one level or base object.
35 - name: LDAPType
36 type: enum[self.Type]
37 description: >
38 Specifies the the configured server is ActiveDirectory(AD) or
39 OpenLdap. It's just an indication for the LDAP stack running on
40 the BMC, in case the app is implemented in such a way that it has
41 to react differently for AD vs openldap.
42 returns:
43 - name: path
44 type: string
45 description: >
46 The object path of the D-Bus object representing the config.
47
48 errors:
49 - xyz.openbmc_project.Common.Error.InternalFailure
50 - xyz.openbmc_project.Common.Error.InvalidArgument
Nagaraju Goruganti8d656132018-10-17 03:08:21 -050051 - xyz.openbmc_project.Common.Error.NoCACertificate
Nagaraju Gorugantic6cfd2c2018-08-10 00:57:41 -050052
53enumerations:
54 - name: SearchScope
55 description: >
56 Possible base scopes.
57 values:
58 - name: sub
59 - name: one
60 - name: base
61
62 - name: Type
63 description: >
64 Possible LDAP Types.
65 values:
66 - name: ActiveDirectory
67 - name: OpenLdap
68
69# vim: tabstop=8 expandtab shiftwidth=4 softtabstop=4