ldap-wrapper.h

См. документацию.

 
#ifndef ALD_LDAP_WRAPPER
#define ALD_LDAP_WRAPPER
 
#include "common.h"
#include "ALDCore.h"
#include <map>
#include <memory>
 
using namespace std;
 
namespace ALD
{
#define LDAP_ITF_NAME "ldap"
 
#define LDAP_ATTR_NULLABLE  true
 
enum alSCOPE {alsBASE, alsONELEVEL, alsSUBTREE, alsCHILDREN};
 
enum alOPERATION {
    aloADD = '+',          
    aloREPLACE = '=',      
    aloDELVAL = '-',       
    aloDELETE = '!'        
};
 
class IALDLdapEntity
{
public:
 
    string DN;                  
    ald_string_multimap Attrs;  
 
    virtual string ValByAttr(const string& Attr, bool nullable = false) = 0;
 
    virtual size_t ValsByAttr(const string& Attr, ald_string_list &vals, bool nullable = false) = 0;
 
 
    virtual void Clear() = 0;       
    virtual bool IsValid() = 0;     
    virtual void Create() = 0;      
    virtual void Delete() = 0;      
 
 
    virtual void Update(ald_string_multimap &modattrs, bool inplace = false) = 0;
 
    virtual void Rename(const string &newrdn) = 0;
 
    virtual string creator() = 0;       
    virtual string modifier() = 0;      
    virtual string created() = 0;       
    virtual string modified() = 0;      
 
    virtual ~IALDLdapEntity(){}     
};
 
typedef shared_ptr<IALDLdapEntity> CALDLdapEntPtr;  
 
typedef list<CALDLdapEntPtr> ald_ldap_ent_list; 
 
class IALDLdapQuery
{
public:
    virtual void First() = 0;       
 
    virtual bool Fetch(CALDLdapEntPtr &Entity) = 0;
 
    virtual int Count() = 0;        
 
    virtual ~IALDLdapQuery(){}     
};
 
typedef shared_ptr<IALDLdapQuery> CALDLdapQueryPtr; 
 
class IALDLdapConnection
{
public:
    virtual ~IALDLdapConnection(){} 
 
    virtual ALDAuthType AuthType() = 0;     
 
    virtual bool Connect(const string &server, ALDAuthType at) = 0;
    virtual bool IsConnected() = 0;         
    virtual void Disconnect() = 0;          
 
    // utils
    virtual long GetLastError() = 0;    
    virtual bool IfReconnectNeeded() = 0;   
    virtual string LocalToUtf8(const string &strLocal) = 0;     
    virtual string Utf8ToLocal(const string &strUtf8) = 0;      
    virtual void AdjustGecosType() = 0;         
 
    // operations
    virtual CALDLdapEntPtr AllocEntity() = 0;   
 
    virtual CALDLdapQueryPtr Search(const string &basedn, const string &filter,
                       ald_string_list &attrs, alSCOPE scope = alsSUBTREE) = 0;
 
    virtual void DeleteAttr(const string &dn, const string &attr) = 0;
 
    virtual void SetAttrValue(const string &dn, const string &attr, const string &val,
                              alOPERATION op = aloREPLACE) = 0;
 
    virtual void SetAttrValues(const string &dn, const string &attr, ald_string_list &vals,
                               alOPERATION op = aloREPLACE) = 0;
 
    virtual void UpdateDN(const string &dn, ald_string_multimap &modattrs) = 0;
 
    virtual void DeleteDN(const string &dn) = 0;      
 
    virtual void AddDN(const string &dn, ald_string_multimap &attrs) = 0;
 
    virtual void RenameDN(const string &dn, const string &newrdn) = 0;
 
    virtual void SetAttrBinaryValue(const string &dn, const string &attr,
                                    const char* pval, unsigned long len,
                                    alOPERATION op = aloREPLACE) = 0;
 
    virtual void* GetAttrBinaryValue(const string &dn, const string &attr,
                                    unsigned long &len) = 0;
 
    // maintaining
    virtual void EnsureOU(const string &dn) = 0;            
 
    virtual void EnumerateIndexes(ald_string_list &indexes) = 0; 
    virtual void AddDBIndex(const string &idx) = 0;         
    virtual void DeleteDBIndex(const string &idx) = 0;      
 
    virtual void EnumerateDBAccessRules(ald_string_list &rules) = 0;
 
    #define ALD_LDAP_ACCESS_POS_FIRST     0
    #define ALD_LDAP_ACCESS_POS_LAST      -1
 
    virtual void AddDBAccessRule(int idx, const string &rule) = 0;
 
    virtual void DeleteDBAccessRule(int idx) = 0;   
 
    virtual void EnumerateLdapSchemas(ald_string_list &schemas) = 0;    
    virtual bool IsLdapSchemaRegistered(const string &schema) = 0;      
 
    virtual void EnumerateModules(ald_string_list &modules) = 0;    
 
    virtual void EnumerateDatabases(ald_string_map &dbs) = 0;       
 
    virtual void EnumerateDBUniqueness(ald_string_list &uniqs) = 0;   
    virtual void AddDBUniqueness(const string &uniq) = 0;           
    virtual void DeleteDBUniqueness(const string &uniq) = 0;        
 
    virtual void EnumerateDBLimits(ald_string_map &limits) = 0;      
    virtual void AddDBLimit(const string &who, const string &limit) = 0; 
    virtual void DeleteDBLimit(const string &who) = 0;            
 
    //replication
    virtual void EnumerateSyncRepls(ald_string_list &syncrepls) = 0;    
    virtual void AddSyncRepl(string rid, string provider) = 0;          
    virtual void DeleteSyncRepl(string rid, string provider) = 0;       
 
    //referral
    virtual void EnumerateLdapProviders(ald_string_map &providers) = 0; 
 
    virtual void AddLdapProvider(const string &domain, string uri, const string &pwd) = 0;
 
    virtual CALDLdapEntPtr GetLdapProvider(const string &domain) = 0;
 
    virtual void UpdateLdapProvider(const string &domain, string uri) = 0;  
    virtual void DeleteLdapProvider(const string &domain) = 0;  
};
 
typedef shared_ptr<IALDLdapConnection> CALDLdapConnPtr; 
 
class IALDLdapWrapper: public CALDInterface
{
public:
    IALDLdapWrapper(IALDCore& Core):CALDInterface(LDAP_ITF_NAME, Core){} 
    virtual CALDLdapConnPtr getConnection() = 0;    
    virtual void RegisterLdapSchema(const string &schema) = 0;  
    virtual string getDefaultURIs() = 0; 
};
 
typedef shared_ptr<IALDLdapWrapper> CALDLdapWrapperPtr; 
 
 
} // ALD
 
#endif  // ALD_LDAP_WRAPPER