1
0
Fork 0
Kerberized WebDAV client for Python
Go to file
Bob Carroll 18e0722e8a converted license and read to markdown 2013-05-30 15:33:59 -07:00
.gitignore initial release 2013-04-26 23:24:07 -07:00
AUTHORS.md converted license and read to markdown 2013-05-30 15:33:59 -07:00
LICENSE.md converted license and read to markdown 2013-05-30 15:33:59 -07:00
MANIFEST.in initial release 2013-04-26 23:24:07 -07:00
README.md converted license and read to markdown 2013-05-30 15:33:59 -07:00
krb5dav.py fixed bug when server doesn't send back any cookies 2013-05-01 17:14:33 -07:00
setup.py fixed bug when server doesn't send back any cookies 2013-05-01 17:14:33 -07:00

README.md

WebDAV-Kerberos

WebDAV-Kerberos is a Kerberised subclass of the davlib.DAV class found in the Python_WebDAV_Library package. This module depends on Python_WebDAV_Library and PyKerberos. Python 3 is not (yet) supported. Installing and configuring Kerberos properly is left as an exercise for the reader.

Dependencies

  • Python_WebDAV_Library (tested with version 0.4.2)
  • PyKerberos (tested with revision 11110)

Usage

The interface is exactly the same as davlib.DAV.

Krb5DAV includes an extra constructor argument and an extra function. Specify the principal constructor argument to set the client user principal name you wish to connect as. Omitting this argument will cause the Kerberos client to use the principal of the current user.

The Krb5DAV.whoami() function will return the authenticated user principal name. If called before authentication the function will return the value of the principal constructor argument, which may be the empty string if you omitted the argument.

Examples

from krb5dav import Krb5DAV

# Connect to SharePoint with the credentials of the current user. You must
# have a fresh ticket in your Kerberos credentials cache for this to work.
dav = Krb5DAV('sharepoint.example.com', protocol='http')

response = dav.get('/MySite/Home/Shared%20Documents/foo.docx')
with open('/tmp/foo.docx', 'wb') as outfile:
    outfile.write(response.read())
dav.close()

# Connect to SharePoint with specific credentials. You must have a Kerberos
# keytab file with the principal's key, and the current user must have read
# access to it.
dav = Krb5DAV('sharepoint.example.com', protocol='http', principal='jdoe@EXAMPLE.COM')

with open('/tmp/foo.docx', 'rb') as infile:
    buf = infile.read()
dav.put('/MySite/Home/Shared%20Documents/foo2.docx', buf)
dav.close()