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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
######################################################################
#
# utils A collection of utility functions that do not depend on
# the python-ldap module.
#
# This software is governed by a license. See
# LICENSE.txt for the terms of this license.
#
######################################################################
__version__='$Revision: 1333 $'[11:-2]
import urllib
import sha
import SSHA
import md5
import random
import base64
import codecs
import string
from sets import Set
#################################################
# "Safe" imports for use in the other modules
#################################################
try:
import crypt
HAVE_CRYPT = 1
except ImportError:
crypt = None
HAVE_CRYPT = 0
#################################################
# Constants used in other modules
#################################################
HTTP_METHODS = ('GET', 'PUT', 'POST')
GROUP_MEMBER_MAP = { 'groupOfUniqueNames' : 'uniqueMember'
, 'groupOfNames' : 'member'
, 'accessGroup' : 'member'
, 'group' : 'member'
}
VALID_GROUP_ATTRIBUTES = Set(list(GROUP_MEMBER_MAP.values()) +
[ 'name'
, 'displayName'
, 'cn'
, 'dn'
, 'objectGUID'
, 'description'
, 'mail'
]
)
encoding = 'latin1'
#################################################
# Helper methods for other modules
#################################################
def _verifyUnicode(st):
""" Verify that the string is unicode """
if isinstance(st, unicode):
return st
else:
try:
return unicode(st)
except UnicodeError:
return unicode(st, encoding).encode(encoding)
def _createLDAPPassword(password, encoding='SHA'):
""" Create a password string suitable for userPassword """
if encoding == 'SSHA':
pwd_str = '{SSHA}' + SSHA.encrypt(password)
elif encoding == 'crypt':
saltseeds = list('%s%s' % ( string.lowercase[:26]
, string.uppercase[:26]
) )
salt = ''
for n in range(2):
salt += random.choice(saltseeds)
pwd_str = '{crypt}%s' % crypt.crypt(password, salt)
elif encoding == 'md5':
m = md5.new(password)
pwd_str = '{md5}' + base64.encodestring(m.digest())
elif encoding == 'clear':
pwd_str = password
else:
sha_obj = sha.new(password)
pwd_str = '{SHA}' + base64.encodestring(sha_obj.digest())
return pwd_str.strip()
try:
encodeLocal, decodeLocal, reader = codecs.lookup(encoding)[:3]
encodeUTF8, decodeUTF8 = codecs.lookup('UTF-8')[:2]
if getattr(reader, '__module__', '') == 'encodings.utf_8':
# Everything stays UTF-8, so we can make this cheaper
to_utf8 = from_utf8 = str
else:
def from_utf8(s):
return encodeLocal(decodeUTF8(s)[0])[0]
def to_utf8(s):
if isinstance(s, str):
s = decodeLocal(s)[0]
return encodeUTF8(s)[0]
except LookupError:
raise LookupError, 'Unknown encoding "%s"' % encoding
def guid2string(val):
""" convert an active directory binary objectGUID value as returned by
python-ldap into a string that can be used as an LDAP query value """
s = ['\\%02X' % ord(x) for x in val]
return ''.join(s)
############################################################
# LDAP delegate registry
############################################################
delegate_registry = {}
def registerDelegate(name, klass, description=''):
""" Register delegates that handle the LDAP-related work
name is a short ID-like moniker for the delegate
klass is a reference to the delegate class itself
description is a more verbose delegate description
"""
delegate_registry[name] = { 'name' : name
, 'klass' : klass
, 'description' : description
}
def registeredDelegates():
""" Return the currently-registered delegates """
return delegate_registry
def _createDelegate(name='LDAP delegate'):
""" Create a delegate based on the name passed in """
default = delegate_registry.get('LDAP delegate')
info = delegate_registry.get(name, None) or default
klass = info['klass']
delegate = klass()
return delegate
|
