From c50d6942470340c46fb08684a948b07f4ac919f6 Mon Sep 17 00:00:00 2001
From: stroeder <stroeder>
Date: Sat, 24 Oct 2015 13:07:33 +0000
Subject: [PATCH] Added example and link to RFC 4513

---
 Doc/ldap-sasl.rst | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/Doc/ldap-sasl.rst b/Doc/ldap-sasl.rst
index dd5fce3..2cd5fc6 100644
--- a/Doc/ldap-sasl.rst
+++ b/Doc/ldap-sasl.rst
@@ -1,4 +1,4 @@
-.. % $Id: ldap-sasl.rst,v 1.1 2015/10/24 12:49:41 stroeder Exp $
+.. % $Id: ldap-sasl.rst,v 1.2 2015/10/24 13:07:33 stroeder Exp $
 
 
 ********************************************
@@ -12,6 +12,7 @@ This module implements various authentication methods for SASL bind.
 .. seealso::
 
    :rfc:`4422` - Simple Authentication and Security Layer (SASL)
+   :rfc:`4513` - Lightweight Directory Access Protocol (LDAP): Authentication Methods and Security Mechanisms
 
 
 :py:mod:`ldap.sasl` SASL bind requests
@@ -64,6 +65,21 @@ Classes
 Examples for ldap.sasl
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
+This example connects to a OpenLDAP server via LDAP over IPC and
+sends a SASL external bind request.
+
 ::
 
-   import ldap.sasl
+   import ldap, ldap.sasl, urllib
+
+   ldapi_path = '/tmp/openldap-socket'
+   ldap_conn = ldap.initialize(
+       'ldapi://%s' % (
+           urllib.quote_plus(ldapi_path)
+       )
+   )
+   # Send SASL bind request for mechanism EXTERNAL
+   ldap_conn.sasl_non_interactive_bind_s('EXTERNAL')
+   # Find out the SASL Authorization Identity
+   print ldap_conn.whoami_s()
+