src/core/ldapauthenticator.h

   1 /***************************************************************************
   2  *   Copyright (C) 2005-2016 by the Quassel Project                        *
   3  *   devel@quassel-irc.org                                                 *
   4  *                                                                         *
   5  *   This program is free software; you can redistribute it and/or modify  *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation; either version 2 of the License, or     *
   8  *   (at your option) version 3.                                           *
   9  *                                                                         *
  10  *   This program is distributed in the hope that it will be useful,       *
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  13  *   GNU General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with this program; if not, write to the                         *
  17  *   Free Software Foundation, Inc.,                                       *
  18  *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.         *
  19  ***************************************************************************/
  20
  21 /* This file contains an implementation of an LDAP Authenticator, as an example
  22  * of what a custom external auth provider could do.
  23  *
  24  * It's based off of this pull request for quassel by abustany:
  25  * https://github.com/quassel/quassel/pull/4/
  26  *
  27  */
  28
  29 #pragma once
  30
  31 #include "authenticator.h"
  32
  33 #include "core.h"
  34
  35 // Link against LDAP.
  36 /* We should use openldap on windows if at all possible, rather than trying to
  37  * write some kind of compatiblity routine.
  38 #ifdef Q_CC_MSVC
  39 #include <windows.h>
  40 #include <winldap.h>
  41 #else*/
  42 #include <ldap.h>
  43 //#endif
  44
  45 // Default LDAP server port.
  46 constexpr int DEFAULT_LDAP_PORT = 389;
  47
  48 class LdapAuthenticator : public Authenticator
  49 {
  50     Q_OBJECT
  51
  52 public:
  53     LdapAuthenticator(QObject *parent = 0);
  54     ~LdapAuthenticator() override;
  55
  56 public slots:
  57     /* General */
  58     bool isAvailable() const override;
  59     QString backendId() const override;
  60     QString displayName() const override;
  61     QString description() const override;
  62     QVariantList setupData() const override;
  63
  64     bool canChangePassword() const override { return false; }
  65
  66     bool setup(const QVariantMap &settings = {}) override;
  67     State init(const QVariantMap &settings = {}) override;
  68     UserId validateUser(const QString &user, const QString &password) override;
  69
  70 protected:
  71     void setAuthProperties(const QVariantMap &properties);
  72     bool ldapConnect();
  73     void ldapDisconnect();
  74     bool ldapAuth(const QString &username, const QString &password);
  75
  76     // Protected methods for retrieving info about the LDAP connection.
  77     QString hostName() const { return _hostName; }
  78     int port() const { return _port; }
  79     QString bindDN() const { return _bindDN; }
  80     QString baseDN() const { return _baseDN; }
  81
  82 private:
  83     QString _hostName;
  84     int _port;
  85     QString _bindDN;
  86     QString _baseDN;
  87     QString _filter;
  88     QString _bindPassword;
  89     QString _uidAttribute;
  90
  91     // The actual connection object.
  92     LDAP *_connection {nullptr};
  93 };