Add res_config_ldap for realtime LDAP engine.
[asterisk/asterisk.git] / doc / ldap.txt
1 Asterisk Realtime LDAP Driver
2 ---------------------------
3
4 With this driver Asterisk can retrieve information from a LDAP drectory, including 
5 sip/iax users, extensions and configuration.
6
7 See configs/res_ldap.conf.sample for a configuration file sample
8
9
10 Here is a LDAP dif sample:
11
12 # Base SIP Phones Entry
13 dn: uid=phone-base,dc=myDomain,dc=myDomainExt
14 objectClass: top
15 objectClass: AstAccount
16 objectClass: AstAccountSIP
17 uid: phone-base
18 AstAccountAccountingCode: baseacccode
19 AstAccountHost: dynamic
20 preferredLanguage: FR
21 AstAccountAMAFlags: billing
22 AstAccountContext: ldaptest
23
24
25 # A Phone. realmedPassword md5 hash should be the result of 
26 #  echo -n "UID:SIPRealm:Password" | md5sum
27 dn: uid=phone-test,dc=myDomain,dc=myDomainExt
28 objectClass: top
29 objectClass: AstAccount
30 objectClass: AstAccountSIP
31 uid: phone-test
32 AstAccountAccountingCode: acc-phone-base
33 AstAccountFullContact: Noone <1234>
34 AstAccountCallerID: 1234
35 AstAccountBaseDN: uid=phone-base,dc=myDomain,dc=myDomainExt
36 realmedPassword: {MD5}f67965da780bf9c70d6e337f938cee6f
37
38
39 # extensions, 
40 dn: ou=extensions,dc=myDomain,dc=myDomainExt
41 ou: extensions
42 objectClass: top
43 objectClass: organizationalUnit
44
45 # Extension 100 Priority 1 in context ldaptest
46 dn: cn=100-1,ou=extensions,dc=myDomain,dc=myDomainExt
47 AstExtensionApplication: NoOp
48 AstExtensionApplicationData: TEST LDAP
49 objectClass: top
50 objectClass: AstExtension
51 AstExtensionExten: 100
52 AstExtensionContext: ldaptest
53 cn: 100-1
54 AstExtensionPriority: 1
55
56 # Extension 100 Priority 1 in context ldaptest
57 dn: cn=100-2,ou=extensions,dc=myDomain,dc=myDomainExt
58 objectClass: top
59 objectClass: AstExtension
60 AstExtensionExten: 100
61 AstExtensionContext: ldaptest
62 cn: 100-2
63 AstExtensionPriority: 2
64 AstExtensionApplication: hangup
65