Files
heimdal/lib/kadm5/private.h
Luke Howard 62c1790bf5 kadm5: pre/post-commit plugin hook for kadm5 update operations (#397)
This change adds plugin support to the kadmin libraries for performing
actions before and after a password change is committed to the KDC database
and after a change is made to the attributes of a principal (specifically,
a change to DISALLOW_ALL_TIX).

This change adds a hook_libraries configuration option to the [kadmin]
section of krb5.conf (or kdc.conf if you use that file) that must be set
to load the module. That configuration option is in the form:

[kadmin]
  hook_libraries = /usr/local/lib/krb5/plugins/kadm5_hook/krb5_sync.so

where the value is the full path to the plugin that you want to load. If
this option is not present, kadmind will not load a plugin and the changes
from the patch will be inactive. If this option is given and the plugin
cannot be loaded, kadmind startup will abort with a (hopefully useful)
error message in syslog.

Any plugin used with this patch must expose a public function named
kadm5_hook_init of type kadm5_hook_init_t that returns a kadm5_hook structure.
See sample_hook.c for an example of this initialization function.

typedef struct kadm5_hook {
    const char *name;
    uint32_t version;
    const char *vendor;
    void (KRB5_CALLCONV *fini)(krb5_context, void *data);

    krb5_error_code (KRB5_CALLCONV *chpass)(krb5_context context,
					    void *data,
					    enum kadm5_hook_stage stage,
                                            krb5_error_code code,
                                            krb5_const_principal princ,
                                            uint32_t flags,
                                            size_t n_ks_tuple,
                                            krb5_key_salt_tuple *ks_tuple,
                                            const char *password,
                                            char **error_msg);
    ...
};

where enum kadm5_hook_stage is:

enum kadm5_hook_stage {
    KADM5_HOOK_STAGE_PRECOMMIT,
    KADM5_HOOK_STAGE_POSTCOMMIT
};

init creates a hook context that is passed into all subsequent calls.
chpass is called for password changes, create is called for principal
creation (with the newly-created principal in the kadm5_principal_ent_t
argument), and modify is called when a principal is modified. The purpose of
the remaining functions should be self-explanatory.

returning 0 on success and a Kerberos error code on failure, setting the
Kerberos error message in the provided context. The error code passed in is
valid for post-commit hooks and contains the result of the update operation.

This change is submitted under the following license

Copyright 2012, 2013
The Board of Trustees of the Leland Stanford Junior University

Portions Copyright 2018 AuriStor Inc.

Copying and distribution of this file, with or without modification, are
permitted in any medium without royalty provided the copyright notice and
this notice are preserved. This file is offered as-is, without any
warranty.
2018-12-26 11:04:05 -06:00

201 lines
5.9 KiB
C

/*
* Copyright (c) 1997-2000 Kungliga Tekniska Högskolan
* (Royal Institute of Technology, Stockholm, Sweden).
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* 3. Neither the name of the Institute nor the names of its contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
/* $Id$ */
#ifndef __kadm5_privatex_h__
#define __kadm5_privatex_h__
#include "kadm5-hook.h"
#ifdef HAVE_SYS_UN_H
#include <sys/un.h>
#endif
struct kadm_func {
kadm5_ret_t (*chpass_principal) (void *, krb5_principal, int,
int, krb5_key_salt_tuple*, const char*);
kadm5_ret_t (*create_principal) (void*, kadm5_principal_ent_t, uint32_t,
int, krb5_key_salt_tuple *,
const char*);
kadm5_ret_t (*delete_principal) (void*, krb5_principal);
kadm5_ret_t (*destroy) (void*);
kadm5_ret_t (*flush) (void*);
kadm5_ret_t (*get_principal) (void*, krb5_principal,
kadm5_principal_ent_t, uint32_t);
kadm5_ret_t (*get_principals) (void*, const char*, char***, int*);
kadm5_ret_t (*get_privs) (void*, uint32_t*);
kadm5_ret_t (*modify_principal) (void*, kadm5_principal_ent_t, uint32_t);
kadm5_ret_t (*randkey_principal) (void*, krb5_principal, krb5_boolean, int,
krb5_key_salt_tuple*, krb5_keyblock**,
int*);
kadm5_ret_t (*rename_principal) (void*, krb5_principal, krb5_principal);
kadm5_ret_t (*chpass_principal_with_key) (void *, krb5_principal, int,
int, krb5_key_data *);
kadm5_ret_t (*lock) (void *);
kadm5_ret_t (*unlock) (void *);
kadm5_ret_t (*setkey_principal_3) (void *, krb5_principal, krb5_boolean,
int, krb5_key_salt_tuple *,
krb5_keyblock *, int);
};
typedef struct kadm5_hook_context {
void *handle;
const kadm5_hook *hook;
void *data;
} kadm5_hook_context;
/* XXX should be integrated */
typedef struct kadm5_common_context {
krb5_context context;
krb5_boolean my_context;
struct kadm_func funcs;
void *data;
} kadm5_common_context;
typedef struct kadm5_log_peer {
int fd;
char *name;
krb5_auth_context ac;
struct kadm5_log_peer *next;
} kadm5_log_peer;
typedef struct kadm5_log_context {
char *log_file;
int log_fd;
int read_only;
int lock_mode;
uint32_t version;
time_t last_time;
#ifndef NO_UNIX_SOCKETS
struct sockaddr_un socket_name;
#else
struct addrinfo *socket_info;
#endif
krb5_socket_t socket_fd;
} kadm5_log_context;
typedef struct kadm5_server_context {
krb5_context context;
krb5_boolean my_context;
struct kadm_func funcs;
/* */
kadm5_config_params config;
HDB *db;
int keep_open;
krb5_principal caller;
unsigned acl_flags;
kadm5_log_context log_context;
size_t num_hooks;
kadm5_hook_context **hooks;
} kadm5_server_context;
typedef struct kadm5_client_context {
krb5_context context;
krb5_boolean my_context;
struct kadm_func funcs;
/* */
krb5_auth_context ac;
char *realm;
char *admin_server;
int kadmind_port;
krb5_socket_t sock;
char *client_name;
char *service_name;
krb5_prompter_fct prompter;
const char *keytab;
krb5_ccache ccache;
kadm5_config_params *realm_params;
} kadm5_client_context;
typedef struct kadm5_ad_context {
krb5_context context;
krb5_boolean my_context;
struct kadm_func funcs;
/* */
kadm5_config_params config;
krb5_principal caller;
krb5_ccache ccache;
char *client_name;
char *realm;
void *ldap_conn;
char *base_dn;
} kadm5_ad_context;
/*
* This enum is used in the iprop log file and on the wire in the iprop
* protocol. DO NOT CHANGE, except to add new op types at the end, and
* look for places in lib/kadm5/log.c to update.
*/
enum kadm_ops {
kadm_get,
kadm_delete,
kadm_create,
kadm_rename,
kadm_chpass,
kadm_modify,
kadm_randkey,
kadm_get_privs,
kadm_get_princs,
kadm_chpass_with_key,
kadm_nop,
kadm_first = kadm_get,
kadm_last = kadm_nop
};
/* FIXME nop types are currently not implemented */
enum kadm_nop_type {
kadm_nop_plain, /* plain nop, not relevance except as uberblock */
kadm_nop_trunc, /* indicates that the master truncated the log */
kadm_nop_close /* indicates that the master closed this log */
};
enum kadm_iter_opts {
kadm_forward = 1,
kadm_backward = 2,
kadm_confirmed = 4,
kadm_unconfirmed = 8
};
enum kadm_recover_mode {
kadm_recover_commit,
kadm_recover_replay
};
#define KADMIN_APPL_VERSION "KADM0.1"
#define KADMIN_OLD_APPL_VERSION "KADM0.0"
#include "kadm5-private.h"
#endif /* __kadm5_privatex_h__ */