source3/include/rpc_dce.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    SMB parameters and setup
   4    Copyright (C) Andrew Tridgell 1992-1997
   5    Copyright (C) Luke Kenneth Casson Leighton 1996-1997
   6    Copyright (C) Paul Ashton 1997
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 2 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program; if not, write to the Free Software
  20    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21 */
  22
  23 #ifndef _DCE_RPC_H /* _DCE_RPC_H */
  24 #define _DCE_RPC_H
  25
  26 #include "rpc_misc.h"  /* this only pulls in STRHDR */
  27
  28
  29 /* DCE/RPC packet types */
  30
  31 enum RPC_PKT_TYPE
  32 {
  33         RPC_REQUEST = 0x00,
  34         RPC_RESPONSE = 0x02,
  35         RPC_FAULT    = 0x03,
  36         RPC_BIND     = 0x0B,
  37         RPC_BINDACK  = 0x0C,
  38         RPC_BINDNACK = 0x0D,
  39         RPC_ALTCONT  = 0x0E,
  40         RPC_ALTCONTRESP = 0x0F,
  41         RPC_BINDRESP = 0x10 /* not the real name!  this is undocumented! */
  42 };
  43
  44 /* DCE/RPC flags */
  45 #define RPC_FLG_FIRST 0x01
  46 #define RPC_FLG_LAST  0x02
  47 #define RPC_FLG_NOCALL 0x20
  48
  49 #define SMBD_NTLMSSP_NEG_FLAGS 0x000082b1 /* ALWAYS_SIGN|NEG_NTLM|NEG_LM|NEG_SEAL|NEG_SIGN|NEG_UNICODE */
  50
  51 /* NTLMSSP signature version */
  52 #define NTLMSSP_SIGN_VERSION 0x01
  53
  54 /* NTLMSSP auth type */
  55 #define NTLMSSP_AUTH_TYPE 0xa
  56
  57 /* DCE-RPC standard identifiers to indicate
  58    signing or sealing of an RPC pipe */
  59 #define RPC_PIPE_AUTH_SIGN_LEVEL 0x5
  60 #define RPC_PIPE_AUTH_SEAL_LEVEL 0x6
  61
  62 /* Netlogon schannel auth type and level */
  63 #define NETSEC_AUTH_TYPE 0x44
  64 #define NETSEC_SIGN_SIGNATURE { 0x77, 0x00, 0xff, 0xff, 0xff, 0xff, 0x00, 0x00 }
  65 #define NETSEC_SEAL_SIGNATURE { 0x77, 0x00, 0x7a, 0x00, 0xff, 0xff, 0x00, 0x00 }
  66 #define RPC_AUTH_NETSEC_CHK_LEN 0x20
  67
  68 /* The 7 here seems to be required to get Win2k not to downgrade us
  69    to NT4.  Actually, anything other than 1ff would seem to do... */
  70 #define NETLOGON_NEG_AUTH2_FLAGS 0x000701ff
  71
  72 #define NETLOGON_NEG_SCHANNEL    0x40000000
  73
  74 enum netsec_direction
  75 {
  76         SENDER_IS_INITIATOR,
  77         SENDER_IS_ACCEPTOR
  78 };
  79
  80 /* Internal Flags to indicate what type of authentication on the pipe */
  81 #define AUTH_PIPE_SIGN    0x0001
  82 #define AUTH_PIPE_SEAL    0x0002
  83 #define AUTH_PIPE_NTLMSSP 0x0004
  84 #define AUTH_PIPE_NETSEC  0x0008
  85
  86 /* Maximum PDU fragment size. */
  87 /* #define MAX_PDU_FRAG_LEN 0x1630              this is what wnt sets */
  88 #define MAX_PDU_FRAG_LEN 0x10b8                 /* this is what w2k sets */
  89
  90 /*
  91  * Actual structure of a DCE UUID
  92  */
  93
  94 typedef struct rpc_uuid
  95 {
  96   uint32 time_low;
  97   uint16 time_mid;
  98   uint16 time_hi_and_version;
  99   uint8 remaining[8];
 100 } RPC_UUID;
 101
 102 #define RPC_UUID_LEN 16
 103
 104 /* RPC_IFACE */
 105 typedef struct rpc_iface_info
 106 {
 107   RPC_UUID uuid;    /* 16 bytes of rpc interface identification */
 108   uint32 version;    /* the interface version number */
 109
 110 } RPC_IFACE;
 111
 112 #define RPC_IFACE_LEN (RPC_UUID_LEN + 4)
 113
 114 struct pipe_id_info
 115 {
 116         /* the names appear not to matter: the syntaxes _do_ matter */
 117
 118         const char *client_pipe;
 119         RPC_IFACE abstr_syntax; /* this one is the abstract syntax id */
 120
 121         const char *server_pipe;  /* this one is the secondary syntax name */
 122         RPC_IFACE trans_syntax; /* this one is the primary syntax id */
 123 };
 124
 125 /* RPC_HDR - dce rpc header */
 126 typedef struct rpc_hdr_info
 127 {
 128   uint8  major; /* 5 - RPC major version */
 129   uint8  minor; /* 0 - RPC minor version */
 130   uint8  pkt_type; /* RPC_PKT_TYPE - RPC response packet */
 131   uint8  flags; /* DCE/RPC flags */
 132   uint8  pack_type[4]; /* 0x1000 0000 - little-endian packed data representation */
 133   uint16 frag_len; /* fragment length - data size (bytes) inc header and tail. */
 134   uint16 auth_len; /* 0 - authentication length  */
 135   uint32 call_id; /* call identifier.  matches 12th uint32 of incoming RPC data. */
 136
 137 } RPC_HDR;
 138
 139 #define RPC_HEADER_LEN 16
 140
 141 /* RPC_HDR_REQ - ms request rpc header */
 142 typedef struct rpc_hdr_req_info
 143 {
 144   uint32 alloc_hint;   /* allocation hint - data size (bytes) minus header and tail. */
 145   uint16 context_id;   /* presentation context identifier */
 146   uint16  opnum;       /* opnum */
 147
 148 } RPC_HDR_REQ;
 149
 150 #define RPC_HDR_REQ_LEN 8
 151
 152 /* RPC_HDR_RESP - ms response rpc header */
 153 typedef struct rpc_hdr_resp_info
 154 {
 155   uint32 alloc_hint;   /* allocation hint - data size (bytes) minus header and tail. */
 156   uint16 context_id;   /* 0 - presentation context identifier */
 157   uint8  cancel_count; /* 0 - cancel count */
 158   uint8  reserved;     /* 0 - reserved. */
 159
 160 } RPC_HDR_RESP;
 161
 162 #define RPC_HDR_RESP_LEN 8
 163
 164 /* RPC_HDR_FAULT - fault rpc header */
 165 typedef struct rpc_hdr_fault_info
 166 {
 167   NTSTATUS status;
 168   uint32 reserved; /* 0x0000 0000 */
 169 } RPC_HDR_FAULT;
 170
 171 #define RPC_HDR_FAULT_LEN 8
 172
 173 /* this seems to be the same string name depending on the name of the pipe,
 174  * but is more likely to be linked to the interface name
 175  * "srvsvc", "\\PIPE\\ntsvcs"
 176  * "samr", "\\PIPE\\lsass"
 177  * "wkssvc", "\\PIPE\\wksvcs"
 178  * "NETLOGON", "\\PIPE\\NETLOGON"
 179  */
 180 /* RPC_ADDR_STR */
 181 typedef struct rpc_addr_info
 182 {
 183   uint16 len;   /* length of the string including null terminator */
 184   fstring str; /* the string above in single byte, null terminated form */
 185
 186 } RPC_ADDR_STR;
 187
 188 /* RPC_HDR_BBA */
 189 typedef struct rpc_hdr_bba_info
 190 {
 191   uint16 max_tsize;       /* maximum transmission fragment size (0x1630) */
 192   uint16 max_rsize;       /* max receive fragment size (0x1630) */
 193   uint32 assoc_gid;       /* associated group id (0x0) */
 194
 195 } RPC_HDR_BBA;
 196
 197 #define RPC_HDR_BBA_LEN 8
 198
 199 /* RPC_HDR_AUTHA */
 200 typedef struct rpc_hdr_autha_info
 201 {
 202         uint16 max_tsize;       /* maximum transmission fragment size (0x1630) */
 203         uint16 max_rsize;       /* max receive fragment size (0x1630) */
 204
 205         uint8 auth_type; /* 0x0a */
 206         uint8 auth_level; /* 0x06 */
 207         uint8 stub_type_len; /* don't know */
 208         uint8 padding; /* padding */
 209
 210         uint32 unknown; /* 0x0014a0c0 */
 211
 212 } RPC_HDR_AUTHA;
 213
 214 #define RPC_HDR_AUTHA_LEN 12
 215
 216 /* RPC_HDR_AUTH */
 217 typedef struct rpc_hdr_auth_info
 218 {
 219         uint8 auth_type; /* 0x0a */
 220         uint8 auth_level; /* 0x06 */
 221         uint8 padding;
 222         uint8 reserved; /* padding */
 223
 224         uint32 auth_context; /* pointer */
 225
 226 } RPC_HDR_AUTH;
 227
 228 #define RPC_HDR_AUTH_LEN 8
 229
 230 /* this is TEMPORARILY coded up as a specific structure */
 231 /* this structure comes after the bind request */
 232 /* RPC_AUTH_NETSEC_NEG */
 233 typedef struct rpc_auth_netsec_neg_info
 234 {
 235         uint32 type1;   /* Always zero ? */
 236         uint32 type2;   /* Types 0x3 and 0x13 seen. Check AcquireSecurityContext() docs.... */
 237         fstring domain; /* calling workstations's domain */
 238         fstring myname; /* calling workstation's name */
 239 } RPC_AUTH_NETSEC_NEG;
 240
 241 /* attached to the end of encrypted rpc requests and responses */
 242 /* RPC_AUTH_NETSEC_CHK */
 243 typedef struct rpc_auth_netsec_chk_info
 244 {
 245         uint8 sig  [8]; /* 77 00 7a 00 ff ff 00 00 */
 246         uint8 packet_digest[8]; /* checksum over the packet, MD5'ed with session key */
 247         uint8 seq_num[8]; /* verifier, seq num */
 248         uint8 confounder[8]; /* random 8-byte nonce */
 249 } RPC_AUTH_NETSEC_CHK;
 250
 251 struct netsec_auth_struct
 252 {
 253         uchar sess_key[16];
 254         uint32 seq_num;
 255         int auth_flags;
 256 };
 257
 258 /* RPC_BIND_REQ - ms req bind */
 259 typedef struct rpc_bind_req_info
 260 {
 261   RPC_HDR_BBA bba;
 262
 263   uint32 num_elements;    /* the number of elements (0x1) */
 264   uint16 context_id;      /* presentation context identifier (0x0) */
 265   uint8 num_syntaxes;     /* the number of syntaxes (has always been 1?)(0x1) */
 266
 267   RPC_IFACE abstract;     /* num and vers. of interface client is using */
 268   RPC_IFACE transfer;     /* num and vers. of interface to use for replies */
 269
 270 } RPC_HDR_RB;
 271
 272 /*
 273  * The following length is 8 bytes RPC_HDR_BBA_LEN, 8 bytes internals
 274  * (with 3 bytes padding), + 2 x RPC_IFACE_LEN bytes for RPC_IFACE structs.
 275  */
 276
 277 #define RPC_HDR_RB_LEN (RPC_HDR_BBA_LEN + 8 + (2*RPC_IFACE_LEN))
 278
 279 /* RPC_RESULTS - can only cope with one reason, right now... */
 280 typedef struct rpc_results_info
 281 {
 282 /* uint8[] # 4-byte alignment padding, against SMB header */
 283
 284   uint8 num_results; /* the number of results (0x01) */
 285
 286 /* uint8[] # 4-byte alignment padding, against SMB header */
 287
 288   uint16 result; /* result (0x00 = accept) */
 289   uint16 reason; /* reason (0x00 = no reason specified) */
 290
 291 } RPC_RESULTS;
 292
 293 /* RPC_HDR_BA */
 294 typedef struct rpc_hdr_ba_info
 295 {
 296   RPC_HDR_BBA bba;
 297
 298   RPC_ADDR_STR addr    ;  /* the secondary address string, as described earlier */
 299   RPC_RESULTS  res     ; /* results and reasons */
 300   RPC_IFACE    transfer; /* the transfer syntax from the request */
 301
 302 } RPC_HDR_BA;
 303
 304 /* RPC_AUTH_VERIFIER */
 305 typedef struct rpc_auth_verif_info
 306 {
 307         fstring signature; /* "NTLMSSP".. Ok, not quite anymore */
 308         uint32  msg_type; /* NTLMSSP_MESSAGE_TYPE (1,2,3) and 5 for schannel */
 309
 310 } RPC_AUTH_VERIFIER;
 311
 312 /* this is TEMPORARILY coded up as a specific structure */
 313 /* this structure comes after the bind request */
 314 /* RPC_AUTH_NTLMSSP_NEG */
 315 typedef struct rpc_auth_ntlmssp_neg_info
 316 {
 317         uint32  neg_flgs; /* 0x0000 b2b3 */
 318
 319         STRHDR hdr_myname; /* offset is against START of this structure */
 320         STRHDR hdr_domain; /* offset is against START of this structure */
 321
 322         fstring myname; /* calling workstation's name */
 323         fstring domain; /* calling workstations's domain */
 324
 325 } RPC_AUTH_NTLMSSP_NEG;
 326
 327 /* this is TEMPORARILY coded up as a specific structure */
 328 /* this structure comes after the bind acknowledgement */
 329 /* RPC_AUTH_NTLMSSP_CHAL */
 330 typedef struct rpc_auth_ntlmssp_chal_info
 331 {
 332         uint32 unknown_1; /* 0x0000 0000 */
 333         uint32 unknown_2; /* 0x0000 0028 */
 334         uint32 neg_flags; /* 0x0000 82b1 */
 335
 336         uint8 challenge[8]; /* ntlm challenge */
 337         uint8 reserved [8]; /* zeros */
 338
 339 } RPC_AUTH_NTLMSSP_CHAL;
 340
 341
 342 /* RPC_AUTH_NTLMSSP_RESP */
 343 typedef struct rpc_auth_ntlmssp_resp_info
 344 {
 345         STRHDR hdr_lm_resp; /* 24 byte response */
 346         STRHDR hdr_nt_resp; /* 24 byte response */
 347         STRHDR hdr_domain;
 348         STRHDR hdr_usr;
 349         STRHDR hdr_wks;
 350         STRHDR hdr_sess_key; /* NULL unless negotiated */
 351         uint32 neg_flags; /* 0x0000 82b1 */
 352
 353         fstring sess_key;
 354         fstring wks;
 355         fstring user;
 356         fstring domain;
 357         fstring nt_resp;
 358         fstring lm_resp;
 359
 360 } RPC_AUTH_NTLMSSP_RESP;
 361
 362 /* attached to the end of encrypted rpc requests and responses */
 363 /* RPC_AUTH_NTLMSSP_CHK */
 364 typedef struct rpc_auth_ntlmssp_chk_info
 365 {
 366         uint32 ver; /* 0x0000 0001 */
 367         uint32 reserved;
 368         uint32 crc32; /* checksum using 0xEDB8 8320 as a polynomial */
 369         uint32 seq_num;
 370
 371 } RPC_AUTH_NTLMSSP_CHK;
 372
 373 #define RPC_AUTH_NTLMSSP_CHK_LEN 16
 374
 375 #endif /* _DCE_RPC_H */