library/adconn.h - master - githubmirror/adcli

library/adconn.h
174 строки7 KB
Samuel Cabrero
conn: Allow to retrieve the connected LDAP address
06 сен 2023, 13:16
06 сен 2023, 13:1677794bc
/*
 * adcli
 *
 * Copyright (C) 2012 Red Hat Inc.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 * MA 02110-1301 USA
 *
 * Author: Stef Walter <stefw@gnome.org>
 */

#ifndef ADCONN_H_
#define ADCONN_H_

#include "adutil.h"

#include <krb5/krb5.h>
#include <ldap.h>

typedef enum {
	ADCLI_LOGIN_UNKNOWN = 0,
	ADCLI_LOGIN_COMPUTER_ACCOUNT = 1 << 1,
	ADCLI_LOGIN_USER_ACCOUNT = 1 << 2,
} adcli_login_type;

enum conn_is_writeable {
	IS_UNKNOWN = 0,
	IS_NOT_WRITEABLE = 1,
	IS_WRITEABLE
};


#define ADCLI_CAP_OID                      "1.2.840.113556.1.4.800"
#define ADCLI_CAP_LDAP_INTEG_OID           "1.2.840.113556.1.4.1791"
#define ADCLI_CAP_V51_OID                  "1.2.840.113556.1.4.1670"
#define ADCLI_CAP_ADAM_DIGEST              "1.2.840.113556.1.4.1880"
#define ADCLI_CAP_ADAM_OID                 "1.2.840.113556.1.4.1851"
#define ADCLI_CAP_PARTIAL_SECRETS_OID      "1.2.840.113556.1.4.1920"
#define ADCLI_CAP_V60_OID                  "1.2.840.113556.1.4.1935"
#define ADCLI_CAP_V61_R2_OID               "1.2.840.113556.1.4.2080"
#define ADCLI_CAP_W8_OID                   "1.2.840.113556.1.4.2237"

typedef char *      (* adcli_password_func)          (adcli_login_type type,
                                                      const char *name,
                                                      int flags,
                                                      void *data);

typedef void        (* adcli_destroy_func)           (void *data);

typedef struct _adcli_conn_ctx adcli_conn;

adcli_result        adcli_conn_discover              (adcli_conn *conn);

adcli_result        adcli_conn_connect               (adcli_conn *conn);

adcli_conn *        adcli_conn_new                   (const char *domain);

adcli_conn *        adcli_conn_ref                   (adcli_conn *conn);

void                adcli_conn_unref                 (adcli_conn *conn);

void                adcli_conn_set_password_func     (adcli_conn *conn,
                                                      adcli_password_func password_func,
                                                      void *data,
                                                      adcli_destroy_func destroy_data);

const char *        adcli_conn_get_host_fqdn         (adcli_conn *conn);

void                adcli_conn_set_host_fqdn         (adcli_conn *conn,
                                                      const char *value);

const char *        adcli_conn_get_domain_name       (adcli_conn *conn);

const char *        adcli_conn_get_forest_name       (adcli_conn *conn);

void                adcli_conn_set_domain_name       (adcli_conn *conn,
                                                      const char *value);

const char *        adcli_conn_get_domain_realm      (adcli_conn *conn);

void                adcli_conn_set_domain_realm      (adcli_conn *conn,
                                                      const char *value);

const char *        adcli_conn_get_domain_controller (adcli_conn *conn);

void                adcli_conn_set_domain_controller (adcli_conn *conn,
                                                      const char *value);

bool                adcli_conn_get_use_ldaps         (adcli_conn *conn);
void                adcli_conn_set_use_ldaps         (adcli_conn *conn,
                                                      bool value);

const char *        adcli_conn_get_domain_short      (adcli_conn *conn);

const char *        adcli_conn_get_domain_sid        (adcli_conn *conn);

const char *        adcli_conn_get_domain_guid       (adcli_conn *conn);

LDAP *              adcli_conn_get_ldap_connection   (adcli_conn *conn);

struct sockaddr *   adcli_conn_get_ldap_address      (adcli_conn *conn);

krb5_context        adcli_conn_get_krb5_context      (adcli_conn *conn);

void                adcli_conn_set_krb5_context      (adcli_conn *conn,
                                                      krb5_context k5);

const char *        adcli_conn_get_computer_name     (adcli_conn *conn);

void                adcli_conn_set_computer_name     (adcli_conn *conn,
                                                      const char *value);

const char *        adcli_conn_get_computer_password (adcli_conn *conn);

void                adcli_conn_set_computer_password (adcli_conn *conn,
                                                      const char *password);

const char *        adcli_conn_get_login_user         (adcli_conn *conn);

void                adcli_conn_set_login_user         (adcli_conn *conn,
                                                      const char *value);

const char *        adcli_conn_get_user_password     (adcli_conn *conn);

void                adcli_conn_set_user_password     (adcli_conn *conn,
                                                      const char *value);

adcli_login_type    adcli_conn_get_login_type        (adcli_conn *conn);

adcli_login_type    adcli_conn_get_allowed_login_types  (adcli_conn *conn);

void                adcli_conn_set_allowed_login_types  (adcli_conn *conn,
                                                         adcli_login_type types);

krb5_ccache         adcli_conn_get_login_ccache      (adcli_conn *conn);

const char *        adcli_conn_get_login_ccache_name (adcli_conn *conn);

void                adcli_conn_set_login_ccache_name (adcli_conn *conn,
                                                      const char *ccname);

const char *        adcli_conn_get_login_keytab_name (adcli_conn *conn);

void                adcli_conn_set_login_keytab_name (adcli_conn *conn,
                                                      const char *ktname);

const char *        adcli_conn_get_default_naming_context (adcli_conn *conn);

const char *        adcli_conn_get_krb5_conf_dir     (adcli_conn *conn);

void                adcli_conn_set_krb5_conf_dir     (adcli_conn *conn,
                                                      const char *value);

int                 adcli_conn_server_has_capability (adcli_conn *conn,
                                                      const char *capability);

bool                adcli_conn_server_has_sasl_mech  (adcli_conn *conn,
                                                      const char *mech);

bool                adcli_conn_is_writeable          (adcli_conn *conn);

#endif /* ADCONN_H_ */