lib/audit_logging/audit_logging.h

   1 /*
   2    common routines for audit logging
   3
   4    Copyright (C) Andrew Bartlett <abartlet@samba.org> 2018
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19 #ifndef _AUDIT_LOGGING_H_
  20 #define _AUDIT_LOGGING_H_
  21 #include <talloc.h>
  22 #include "lib/messaging/irpc.h"
  23 #include "lib/tsocket/tsocket.h"
  24
  25 char* audit_get_timestamp(TALLOC_CTX *frame);
  26 void audit_log_human_text(const char *prefix,
  27                           const char *message,
  28                           int debug_class,
  29                           int debug_level);
  30
  31 #ifdef HAVE_JANSSON
  32 #include <jansson.h>
  33 /*
  34  * Wrapper for jannson JSON object
  35  *
  36  */
  37 struct json_object {
  38         json_t *root;
  39         bool valid;
  40 };
  41 extern const struct json_object json_empty_object;
  42
  43 #define JSON_ERROR -1
  44
  45 void audit_log_json(const char *prefix,
  46                     struct json_object *message,
  47                     int debug_class,
  48                     int debug_level);
  49 void audit_message_send(struct imessaging_context *msg_ctx,
  50                         const char *server_name,
  51                         uint32_t message_type,
  52                         struct json_object *message);
  53 struct json_object json_new_object(void);
  54 struct json_object json_new_array(void);
  55 void json_free(struct json_object *object);
  56 void json_assert_is_array(struct json_object *array);
  57 bool json_is_invalid(struct json_object *object);
  58
  59 int json_add_int(struct json_object *object, const char *name, const int value);
  60 int json_add_bool(struct json_object *object,
  61                   const char *name,
  62                   const bool value);
  63 int json_add_string(struct json_object *object,
  64                     const char *name,
  65                     const char *value);
  66 int json_add_object(struct json_object *object,
  67                     const char *name,
  68                     struct json_object *value);
  69 int json_add_stringn(struct json_object *object,
  70                      const char *name,
  71                      const char *value,
  72                      const size_t len);
  73 int json_add_version(struct json_object *object, int major, int minor);
  74 int json_add_timestamp(struct json_object *object);
  75 int json_add_address(struct json_object *object,
  76                      const char *name,
  77                      const struct tsocket_address *address);
  78 int json_add_sid(struct json_object *object,
  79                  const char *name,
  80                  const struct dom_sid *sid);
  81 int json_add_guid(struct json_object *object,
  82                   const char *name,
  83                   const struct GUID *guid);
  84
  85 struct json_object json_get_array(struct json_object *object,
  86                                   const char* name);
  87 struct json_object json_get_object(struct json_object *object,
  88                                    const char* name);
  89 char *json_to_string(TALLOC_CTX *mem_ctx,
  90                      struct json_object *object);
  91 #endif
  92 #endif