source3/auth/proto.h

   1 /*
   2  *  Unix SMB/CIFS implementation.
   3  *  Password and authentication handling
   4  *
   5  *  Copyright (C) Andrew Tridgell               1992-2001
   6  *  Copyright (C) Luke Kenneth Casson Leighton  1996-2000
   7  *  Copyright (C) Jeremy Allison                1997-2001
   8  *  Copyright (C) John H Terpsta                1999-2001
   9  *  Copyright (C) Tim Potter                    2000
  10  *  Copyright (C) Andrew Bartlett               2001-2003
  11  *  Copyright (C) Jelmer Vernooij               2002
  12  *  Copyright (C) Rafal Szczesniak              2002
  13  *  Copyright (C) Gerald Carter                 2003
  14  *  Copyright (C) Volker Lendecke               2006,2010
  15  *  Copyright (C) Michael Adam                  2007
  16  *  Copyright (C) Dan Sledz                     2009
  17  *  Copyright (C) Simo Sorce                    2010
  18  *
  19  *  This program is free software; you can redistribute it and/or modify
  20  *  it under the terms of the GNU General Public License as published by
  21  *  the Free Software Foundation; either version 3 of the License, or
  22  *  (at your option) any later version.
  23  *
  24  *  This program is distributed in the hope that it will be useful,
  25  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  26  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  27  *  GNU General Public License for more details.
  28  *
  29  *  You should have received a copy of the GNU General Public License
  30  *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
  31  */
  32
  33 #ifndef _AUTH_PROTO_H_
  34 #define _AUTH_PROTO_H_
  35
  36 /* The following definitions come from auth/auth.c  */
  37
  38 NTSTATUS smb_register_auth(int version, const char *name, auth_init_function init);
  39 bool load_auth_module(struct auth_context *auth_context,
  40                       const char *module, auth_methods **ret) ;
  41 NTSTATUS make_auth_context_subsystem(TALLOC_CTX *mem_ctx,
  42                                      struct auth_context **auth_context);
  43 NTSTATUS make_auth_context_fixed(TALLOC_CTX *mem_ctx,
  44                                  struct auth_context **auth_context,
  45                                  uchar chal[8]) ;
  46
  47 /* The following definitions come from auth/auth_builtin.c  */
  48
  49 NTSTATUS auth_builtin_init(void);
  50
  51 /* The following definitions come from auth/auth_compat.c  */
  52
  53 NTSTATUS check_plaintext_password(const char *smb_name,
  54                                   const struct tsocket_address *remote_address,
  55                                   DATA_BLOB plaintext_password,
  56                                   struct auth_serversupplied_info **server_info);
  57 bool password_ok(struct auth_context *actx, bool global_encrypted,
  58                  const char *session_workgroup,
  59                  const char *smb_name,
  60                  const struct tsocket_address *remote_address,
  61                  DATA_BLOB password_blob);
  62
  63 /* The following definitions come from auth/auth_domain.c  */
  64
  65 void attempt_machine_password_change(void);
  66 NTSTATUS auth_domain_init(void);
  67
  68 NTSTATUS auth_netlogond_init(void);
  69
  70 /* The following definitions come from auth/auth_ntlmssp.c  */
  71
  72 NTSTATUS auth_ntlmssp_session_info(TALLOC_CTX *mem_ctx,
  73                                    struct auth_ntlmssp_state *auth_ntlmssp_state,
  74                                    struct auth_session_info **session_info);
  75 NTSTATUS auth_ntlmssp_prepare(const struct tsocket_address *remote_address,
  76                               struct auth_ntlmssp_state **auth_ntlmssp_state);
  77 NTSTATUS auth_ntlmssp_start(struct auth_ntlmssp_state *auth_ntlmssp_state);
  78 NTSTATUS auth_generic_start(struct auth_ntlmssp_state *auth_ntlmssp_state, const char *oid);
  79 NTSTATUS auth_generic_authtype_start(struct auth_ntlmssp_state *auth_ntlmssp_state,
  80                                      uint8_t auth_type, uint8_t auth_level);
  81
  82
  83 /* The following definitions come from auth/auth_sam.c  */
  84
  85 NTSTATUS check_sam_security(const DATA_BLOB *challenge,
  86                             TALLOC_CTX *mem_ctx,
  87                             const struct auth_usersupplied_info *user_info,
  88                             struct auth_serversupplied_info **server_info);
  89 NTSTATUS check_sam_security_info3(const DATA_BLOB *challenge,
  90                                   TALLOC_CTX *mem_ctx,
  91                                   const struct auth_usersupplied_info *user_info,
  92                                   struct netr_SamInfo3 **pinfo3);
  93 NTSTATUS auth_sam_init(void);
  94
  95 /* The following definitions come from auth/auth_server.c  */
  96
  97 NTSTATUS auth_server_init(void);
  98
  99 /* The following definitions come from auth/auth_unix.c  */
 100
 101 NTSTATUS auth_unix_init(void);
 102
 103 /* The following definitions come from auth/auth_util.c  */
 104 struct tsocket_address;
 105
 106 NTSTATUS make_user_info_map(struct auth_usersupplied_info **user_info,
 107                             const char *smb_name,
 108                             const char *client_domain,
 109                             const char *workstation_name,
 110                             const struct tsocket_address *remote_address,
 111                             DATA_BLOB *lm_pwd,
 112                             DATA_BLOB *nt_pwd,
 113                             const struct samr_Password *lm_interactive_pwd,
 114                             const struct samr_Password *nt_interactive_pwd,
 115                             const char *plaintext,
 116                             enum auth_password_state password_state);
 117 bool make_user_info_netlogon_network(struct auth_usersupplied_info **user_info,
 118                                      const char *smb_name,
 119                                      const char *client_domain,
 120                                      const char *workstation_name,
 121                                      const struct tsocket_address *remote_address,
 122                                      uint32 logon_parameters,
 123                                      const uchar *lm_network_pwd,
 124                                      int lm_pwd_len,
 125                                      const uchar *nt_network_pwd,
 126                                      int nt_pwd_len);
 127 bool make_user_info_netlogon_interactive(struct auth_usersupplied_info **user_info,
 128                                          const char *smb_name,
 129                                          const char *client_domain,
 130                                          const char *workstation_name,
 131                                          const struct tsocket_address *remote_address,
 132                                          uint32 logon_parameters,
 133                                          const uchar chal[8],
 134                                          const uchar lm_interactive_pwd[16],
 135                                          const uchar nt_interactive_pwd[16],
 136                                          const uchar *dc_sess_key);
 137 bool make_user_info_for_reply(struct auth_usersupplied_info **user_info,
 138                               const char *smb_name,
 139                               const char *client_domain,
 140                               const struct tsocket_address *remote_address,
 141                               const uint8 chal[8],
 142                               DATA_BLOB plaintext_password);
 143 NTSTATUS make_user_info_for_reply_enc(struct auth_usersupplied_info **user_info,
 144                                       const char *smb_name,
 145                                       const char *client_domain,
 146                                       const struct tsocket_address *remote_address,
 147                                       DATA_BLOB lm_resp, DATA_BLOB nt_resp);
 148 bool make_user_info_guest(const struct tsocket_address *remote_address,
 149                           struct auth_usersupplied_info **user_info);
 150
 151 struct samu;
 152 NTSTATUS make_server_info_sam(struct auth_serversupplied_info **server_info,
 153                               struct samu *sampass);
 154 NTSTATUS create_local_token(TALLOC_CTX *mem_ctx,
 155                             const struct auth_serversupplied_info *server_info,
 156                             DATA_BLOB *session_key,
 157                             const char *smb_name,
 158                             struct auth_session_info **session_info_out);
 159 NTSTATUS create_token_from_username(TALLOC_CTX *mem_ctx, const char *username,
 160                                     bool is_guest,
 161                                     uid_t *uid, gid_t *gid,
 162                                     char **found_username,
 163                                     struct security_token **token);
 164 bool user_in_group_sid(const char *username, const struct dom_sid *group_sid);
 165 bool user_in_group(const char *username, const char *groupname);
 166 struct passwd;
 167 NTSTATUS make_server_info_pw(struct auth_serversupplied_info **server_info,
 168                              char *unix_username,
 169                              struct passwd *pwd);
 170 NTSTATUS make_session_info_from_username(TALLOC_CTX *mem_ctx,
 171                                          const char *username,
 172                                          bool is_guest,
 173                                          struct auth_session_info **session_info);
 174 struct auth_session_info *copy_session_info(TALLOC_CTX *mem_ctx,
 175                                              const struct auth_session_info *src);
 176 bool init_guest_info(void);
 177 NTSTATUS init_system_info(void);
 178 bool session_info_set_session_key(struct auth_session_info *info,
 179                                  DATA_BLOB session_key);
 180 NTSTATUS make_server_info_guest(TALLOC_CTX *mem_ctx,
 181                                 struct auth_serversupplied_info **server_info);
 182 NTSTATUS make_session_info_guest(TALLOC_CTX *mem_ctx,
 183                                 struct auth_session_info **server_info);
 184 NTSTATUS make_session_info_system(TALLOC_CTX *mem_ctx,
 185                                  struct auth_session_info **session_info);
 186 const struct auth_session_info *get_session_info_system(void);
 187 bool copy_current_user(struct current_user *dst, struct current_user *src);
 188 struct passwd *smb_getpwnam( TALLOC_CTX *mem_ctx, const char *domuser,
 189                              char **p_save_username, bool create );
 190 NTSTATUS make_server_info_info3(TALLOC_CTX *mem_ctx,
 191                                 const char *sent_nt_username,
 192                                 const char *domain,
 193                                 struct auth_serversupplied_info **server_info,
 194                                 struct netr_SamInfo3 *info3);
 195 struct wbcAuthUserInfo;
 196 NTSTATUS make_server_info_wbcAuthUserInfo(TALLOC_CTX *mem_ctx,
 197                                           const char *sent_nt_username,
 198                                           const char *domain,
 199                                           const struct wbcAuthUserInfo *info,
 200                                           struct auth_serversupplied_info **server_info);
 201 void free_user_info(struct auth_usersupplied_info **user_info);
 202 bool is_trusted_domain(const char* dom_name);
 203
 204 /* The following definitions come from auth/user_info.c  */
 205
 206 NTSTATUS make_user_info(struct auth_usersupplied_info **ret_user_info,
 207                         const char *smb_name,
 208                         const char *internal_username,
 209                         const char *client_domain,
 210                         const char *domain,
 211                         const char *workstation_name,
 212                         const struct tsocket_address *remote_address,
 213                         const DATA_BLOB *lm_pwd,
 214                         const DATA_BLOB *nt_pwd,
 215                         const struct samr_Password *lm_interactive_pwd,
 216                         const struct samr_Password *nt_interactive_pwd,
 217                         const char *plaintext_password,
 218                         enum auth_password_state password_state);
 219 void free_user_info(struct auth_usersupplied_info **user_info);
 220
 221 NTSTATUS do_map_to_guest_server_info(NTSTATUS status,
 222                                      struct auth_serversupplied_info **server_info,
 223                                      const char *user, const char *domain);
 224
 225 /* The following definitions come from auth/auth_winbind.c  */
 226
 227 NTSTATUS auth_winbind_init(void);
 228
 229 /* The following definitions come from auth/server_info.c  */
 230
 231 struct netr_SamInfo2;
 232 struct netr_SamInfo3;
 233 struct netr_SamInfo6;
 234
 235 struct auth_serversupplied_info *make_server_info(TALLOC_CTX *mem_ctx);
 236 NTSTATUS serverinfo_to_SamInfo2(struct auth_serversupplied_info *server_info,
 237                                 uint8_t *pipe_session_key,
 238                                 size_t pipe_session_key_len,
 239                                 struct netr_SamInfo2 *sam2);
 240 NTSTATUS serverinfo_to_SamInfo3(const struct auth_serversupplied_info *server_info,
 241                                 uint8_t *pipe_session_key,
 242                                 size_t pipe_session_key_len,
 243                                 struct netr_SamInfo3 *sam3);
 244 NTSTATUS serverinfo_to_SamInfo6(struct auth_serversupplied_info *server_info,
 245                                 uint8_t *pipe_session_key,
 246                                 size_t pipe_session_key_len,
 247                                 struct netr_SamInfo6 *sam6);
 248 NTSTATUS samu_to_SamInfo3(TALLOC_CTX *mem_ctx,
 249                           struct samu *samu,
 250                           const char *login_server,
 251                           struct netr_SamInfo3 **_info3,
 252                           struct extra_auth_info *extra);
 253 struct netr_SamInfo3 *copy_netr_SamInfo3(TALLOC_CTX *mem_ctx,
 254                                          struct netr_SamInfo3 *orig);
 255 struct netr_SamInfo3 *wbcAuthUserInfo_to_netr_SamInfo3(TALLOC_CTX *mem_ctx,
 256                                         const struct wbcAuthUserInfo *info);
 257
 258 /* The following definitions come from auth/auth_wbc.c  */
 259
 260 NTSTATUS auth_wbc_init(void);
 261
 262 /* The following definitions come from auth/pampass.c  */
 263
 264 bool smb_pam_claim_session(char *user, char *tty, char *rhost);
 265 bool smb_pam_close_session(char *user, char *tty, char *rhost);
 266 NTSTATUS smb_pam_accountcheck(const char *user, const char *rhost);
 267 NTSTATUS smb_pam_passcheck(const char * user, const char * rhost,
 268                            const char * password);
 269 bool smb_pam_passchange(const char *user, const char *rhost,
 270                         const char *oldpassword, const char *newpassword);
 271 bool smb_pam_claim_session(char *user, char *tty, char *rhost);
 272 bool smb_pam_close_session(char *in_user, char *tty, char *rhost);
 273
 274 /* The following definitions come from auth/pass_check.c  */
 275
 276 void dfs_unlogin(void);
 277 NTSTATUS pass_check(const struct passwd *pass,
 278                     const char *user,
 279                     const char *rhost,
 280                     const char *password,
 281                     bool run_cracker);
 282
 283 /* The following definitions come from auth/token_util.c  */
 284
 285 bool nt_token_check_sid ( const struct dom_sid *sid, const struct security_token *token );
 286 bool nt_token_check_domain_rid( struct security_token *token, uint32 rid );
 287 struct security_token *get_root_nt_token( void );
 288 NTSTATUS add_aliases(const struct dom_sid *domain_sid,
 289                      struct security_token *token);
 290 struct security_token *create_local_nt_token(TALLOC_CTX *mem_ctx,
 291                                             const struct dom_sid *user_sid,
 292                                             bool is_guest,
 293                                             int num_groupsids,
 294                                             const struct dom_sid *groupsids);
 295 NTSTATUS create_local_nt_token_from_info3(TALLOC_CTX *mem_ctx,
 296                                           bool is_guest,
 297                                           const struct netr_SamInfo3 *info3,
 298                                           const struct extra_auth_info *extra,
 299                                           struct security_token **ntok);
 300 void debug_unix_user_token(int dbg_class, int dbg_lev, uid_t uid, gid_t gid,
 301                            int n_groups, gid_t *groups);
 302
 303 /* The following definitions come from auth/user_util.c  */
 304
 305 bool map_username(TALLOC_CTX *ctx, const char *user_in, char **p_user_out);
 306 bool user_in_netgroup(TALLOC_CTX *ctx, const char *user, const char *ngname);
 307 bool user_in_list(TALLOC_CTX *ctx, const char *user,const char **list);
 308
 309 /* The following definitions come from auth/user_krb5.c  */
 310 struct PAC_LOGON_INFO;
 311 NTSTATUS get_user_from_kerberos_info(TALLOC_CTX *mem_ctx,
 312                                      const char *cli_name,
 313                                      const char *princ_name,
 314                                      struct PAC_LOGON_INFO *logon_info,
 315                                      bool *is_mapped,
 316                                      bool *mapped_to_guest,
 317                                      char **ntuser,
 318                                      char **ntdomain,
 319                                      char **username,
 320                                      struct passwd **_pw);
 321 NTSTATUS make_session_info_krb5(TALLOC_CTX *mem_ctx,
 322                                 char *ntuser,
 323                                 char *ntdomain,
 324                                 char *username,
 325                                 struct passwd *pw,
 326                                 struct PAC_LOGON_INFO *logon_info,
 327                                 bool mapped_to_guest, bool username_was_mapped,
 328                                 DATA_BLOB *session_key,
 329                                 struct auth_session_info **session_info);
 330
 331 #endif /* _AUTH_PROTO_H_ */