source/include/rpc_dce.h

   1 /*
   2    Unix SMB/Netbios implementation.
   3    Version 1.9.
   4    SMB parameters and setup
   5    Copyright (C) Andrew Tridgell 1992-1997
   6    Copyright (C) Luke Kenneth Casson Leighton 1996-1997
   7    Copyright (C) Paul Ashton 1997
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22 */
  23
  24 #ifndef _DCE_RPC_H /* _DCE_RPC_H */
  25 #define _DCE_RPC_H
  26
  27 #include "rpc_misc.h" /* this only pulls in STRHDR */
  28
  29
  30 /* DCE/RPC packet types */
  31
  32 enum RPC_PKT_TYPE
  33 {
  34         RPC_REQUEST = 0x00,
  35         RPC_RESPONSE = 0x02,
  36         RPC_FAULT    = 0x03,
  37         RPC_BIND     = 0x0B,
  38         RPC_BINDACK  = 0x0C,
  39         RPC_BINDRESP = 0x10 /* not the real name!  this is undocumented! */
  40 };
  41
  42 /* DCE/RPC flags */
  43 #define RPC_FLG_FIRST 0x01
  44 #define RPC_FLG_LAST  0x02
  45
  46 /* NTLMSSP message types */
  47 enum NTLM_MESSAGE_TYPE
  48 {
  49         NTLMSSP_NEGOTIATE = 1,
  50         NTLMSSP_CHALLENGE = 2,
  51         NTLMSSP_AUTH      = 3,
  52         NTLMSSP_UNKNOWN   = 4
  53 };
  54
  55 /* NTLMSSP negotiation flags */
  56 #define NTLMSSP_NEGOTIATE_UNICODE          0x00000001
  57 #define NTLMSSP_NEGOTIATE_OEM              0x00000002
  58 #define NTLMSSP_REQUEST_TARGET             0x00000004
  59 #define NTLMSSP_NEGOTIATE_SIGN             0x00000010
  60 #define NTLMSSP_NEGOTIATE_SEAL             0x00000020
  61 #define NTLMSSP_NEGOTIATE_LM_KEY           0x00000080
  62 #define NTLMSSP_NEGOTIATE_NTLM             0x00000200
  63 #define NTLMSSP_NEGOTIATE_00001000         0x00001000
  64 #define NTLMSSP_NEGOTIATE_00002000         0x00002000
  65 #define NTLMSSP_NEGOTIATE_ALWAYS_SIGN      0x00008000
  66 #define NTLMSSP_NEGOTIATE_NTLM2            0x00080000
  67 #define NTLMSSP_NEGOTIATE_TARGET_INFO      0x00800000
  68 #define NTLMSSP_NEGOTIATE_128              0x20000000
  69 #define NTLMSSP_NEGOTIATE_KEY_EXCH         0x40000000
  70
  71 /* NTLMSSP signature version */
  72 #define NTLMSSP_SIGN_VERSION 0x01
  73
  74 /*
  75  * Actual structure of a DCE UUID
  76  */
  77
  78 typedef struct rpc_uuid
  79 {
  80   uint32 time_low;
  81   uint16 time_mid;
  82   uint16 time_hi_and_version;
  83   uint8 remaining[8];
  84 } RPC_UUID;
  85
  86 /* RPC_IFACE */
  87 typedef struct rpc_iface_info
  88 {
  89   RPC_UUID uuid;    /* 16 bytes of rpc interface identification */
  90   uint32 version;    /* the interface version number */
  91
  92 } RPC_IFACE;
  93
  94 struct pipe_id_info
  95 {
  96         /* the names appear not to matter: the syntaxes _do_ matter */
  97
  98         char *client_pipe;
  99         RPC_IFACE abstr_syntax; /* this one is the abstract syntax id */
 100
 101         char *server_pipe;  /* this one is the secondary syntax name */
 102         RPC_IFACE trans_syntax; /* this one is the primary syntax id */
 103 };
 104
 105 /* RPC_HDR - dce rpc header */
 106 typedef struct rpc_hdr_info
 107 {
 108   uint8  major; /* 5 - RPC major version */
 109   uint8  minor; /* 0 - RPC minor version */
 110   uint8  pkt_type; /* RPC_PKT_TYPE - RPC response packet */
 111   uint8  flags; /* DCE/RPC flags */
 112   uint8  pack_type[4]; /* 0x1000 0000 - little-endian packed data representation */
 113   uint16 frag_len; /* fragment length - data size (bytes) inc header and tail. */
 114   uint16 auth_len; /* 0 - authentication length  */
 115   uint32 call_id; /* call identifier.  matches 12th uint32 of incoming RPC data. */
 116
 117 } RPC_HDR;
 118
 119 /* RPC_HDR_REQ - ms request rpc header */
 120 typedef struct rpc_hdr_req_info
 121 {
 122   uint32 alloc_hint;   /* allocation hint - data size (bytes) minus header and tail. */
 123   uint16 context_id;   /* 0 - presentation context identifier */
 124   uint16  opnum;        /* opnum */
 125
 126 } RPC_HDR_REQ;
 127
 128 /* RPC_HDR_RESP - ms response rpc header */
 129 typedef struct rpc_hdr_resp_info
 130 {
 131   uint32 alloc_hint;   /* allocation hint - data size (bytes) minus header and tail. */
 132   uint16 context_id;   /* 0 - presentation context identifier */
 133   uint8  cancel_count; /* 0 - cancel count */
 134   uint8  reserved;     /* 0 - reserved. */
 135
 136 } RPC_HDR_RESP;
 137
 138 /* this seems to be the same string name depending on the name of the pipe,
 139  * but is more likely to be linked to the interface name
 140  * "srvsvc", "\\PIPE\\ntsvcs"
 141  * "samr", "\\PIPE\\lsass"
 142  * "wkssvc", "\\PIPE\\wksvcs"
 143  * "NETLOGON", "\\PIPE\\NETLOGON"
 144  */
 145 /* RPC_ADDR_STR */
 146 typedef struct rpc_addr_info
 147 {
 148   uint16 len;   /* length of the string including null terminator */
 149   fstring str; /* the string above in single byte, null terminated form */
 150
 151 } RPC_ADDR_STR;
 152
 153 /* RPC_HDR_BBA */
 154 typedef struct rpc_hdr_bba_info
 155 {
 156   uint16 max_tsize;       /* maximum transmission fragment size (0x1630) */
 157   uint16 max_rsize;       /* max receive fragment size (0x1630) */
 158   uint32 assoc_gid;       /* associated group id (0x0) */
 159
 160 } RPC_HDR_BBA;
 161
 162 /* RPC_HDR_AUTHA */
 163 typedef struct rpc_hdr_autha_info
 164 {
 165         uint16 max_tsize;       /* maximum transmission fragment size (0x1630) */
 166         uint16 max_rsize;       /* max receive fragment size (0x1630) */
 167
 168         uint8 auth_type; /* 0x0a */
 169         uint8 auth_level; /* 0x06 */
 170         uint8 stub_type_len; /* don't know */
 171         uint8 padding; /* padding */
 172
 173         uint32 unknown; /* 0x0014a0c0 */
 174
 175 } RPC_HDR_AUTHA;
 176
 177 /* RPC_HDR_AUTH */
 178 typedef struct rpc_hdr_auth_info
 179 {
 180         uint8 auth_type; /* 0x0a */
 181         uint8 auth_level; /* 0x06 */
 182         uint8 stub_type_len; /* don't know */
 183         uint8 padding; /* padding */
 184
 185         uint32 unknown; /* pointer */
 186
 187 } RPC_HDR_AUTH;
 188
 189 /* RPC_BIND_REQ - ms req bind */
 190 typedef struct rpc_bind_req_info
 191 {
 192   RPC_HDR_BBA bba;
 193
 194   uint32 num_elements;    /* the number of elements (0x1) */
 195   uint16 context_id;      /* presentation context identifier (0x0) */
 196   uint8 num_syntaxes;     /* the number of syntaxes (has always been 1?)(0x1) */
 197
 198   RPC_IFACE abstract;     /* num and vers. of interface client is using */
 199   RPC_IFACE transfer;     /* num and vers. of interface to use for replies */
 200
 201 } RPC_HDR_RB;
 202
 203 /* RPC_RESULTS - can only cope with one reason, right now... */
 204 typedef struct rpc_results_info
 205 {
 206 /* uint8[] # 4-byte alignment padding, against SMB header */
 207
 208   uint8 num_results; /* the number of results (0x01) */
 209
 210 /* uint8[] # 4-byte alignment padding, against SMB header */
 211
 212   uint16 result; /* result (0x00 = accept) */
 213   uint16 reason; /* reason (0x00 = no reason specified) */
 214
 215 } RPC_RESULTS;
 216
 217 /* RPC_HDR_BA */
 218 typedef struct rpc_hdr_ba_info
 219 {
 220   RPC_HDR_BBA bba;
 221
 222   RPC_ADDR_STR addr    ;  /* the secondary address string, as described earlier */
 223   RPC_RESULTS  res     ; /* results and reasons */
 224   RPC_IFACE    transfer; /* the transfer syntax from the request */
 225
 226 } RPC_HDR_BA;
 227
 228 /* RPC_AUTH_VERIFIER */
 229 typedef struct rpc_auth_verif_info
 230 {
 231         fstring signature; /* "NTLMSSP" */
 232         uint32  msg_type; /* NTLMSSP_MESSAGE_TYPE (1,2,3) */
 233
 234 } RPC_AUTH_VERIFIER;
 235
 236 /* this is TEMPORARILY coded up as a specific structure */
 237 /* this structure comes after the bind request */
 238 /* RPC_AUTH_NTLMSSP_NEG */
 239 typedef struct rpc_auth_ntlmssp_neg_info
 240 {
 241         uint32  neg_flgs; /* 0x0000 b2b3 */
 242
 243         STRHDR hdr_myname; /* offset is against START of this structure */
 244         STRHDR hdr_domain; /* offset is against START of this structure */
 245
 246         fstring myname; /* calling workstation's name */
 247         fstring domain; /* calling workstations's domain */
 248
 249 } RPC_AUTH_NTLMSSP_NEG;
 250
 251 /* this is TEMPORARILY coded up as a specific structure */
 252 /* this structure comes after the bind acknowledgement */
 253 /* RPC_AUTH_NTLMSSP_CHAL */
 254 typedef struct rpc_auth_ntlmssp_chal_info
 255 {
 256         uint32 unknown_1; /* 0x0000 0000 */
 257         uint32 unknown_2; /* 0x0000 0028 */
 258         uint32 neg_flags; /* 0x0000 82b1 */
 259
 260         uint8 challenge[8]; /* ntlm challenge */
 261         uint8 reserved [8]; /* zeros */
 262
 263 } RPC_AUTH_NTLMSSP_CHAL;
 264
 265
 266 /* RPC_AUTH_NTLMSSP_RESP */
 267 typedef struct rpc_auth_ntlmssp_resp_info
 268 {
 269         STRHDR hdr_lm_resp; /* 24 byte response */
 270         STRHDR hdr_nt_resp; /* 24 byte response */
 271         STRHDR hdr_domain;
 272         STRHDR hdr_usr;
 273         STRHDR hdr_wks;
 274         STRHDR hdr_sess_key; /* NULL unless negotiated */
 275         uint32 neg_flags; /* 0x0000 82b1 */
 276
 277         fstring sess_key;
 278         fstring wks;
 279         fstring user;
 280         fstring domain;
 281         fstring nt_resp;
 282         fstring lm_resp;
 283
 284 } RPC_AUTH_NTLMSSP_RESP;
 285
 286
 287 /* attached to the end of encrypted rpc requests and responses */
 288 /* RPC_AUTH_NTLMSSP_CHK */
 289 typedef struct rpc_auth_ntlmssp_chk_info
 290 {
 291         uint32 ver; /* 0x0000 0001 */
 292         uint32 reserved;
 293         uint32 crc32; /* checksum using 0xEDB8 8320 as a polynomial */
 294         uint32 seq_num;
 295
 296 } RPC_AUTH_NTLMSSP_CHK;
 297
 298 #endif /* _DCE_RPC_H */
 299