src/rxkad/private_data.h

   1 /*
   2  * Copyright 2000, International Business Machines Corporation and others.
   3  * All Rights Reserved.
   4  *
   5  * This software has been released under the terms of the IBM Public
   6  * License.  For details, see the LICENSE file in the top-level source
   7  * directory or online at http://www.openafs.org/dl/license10.html
   8  */
   9
  10 /* Declarations of data structures associated with rxkad security objects. */
  11
  12 #ifndef RXKAD_PRIVATE_DATA_H
  13 #define RXKAD_PRIVATE_DATA_H
  14
  15 #include "rxkad.h"
  16
  17
  18 #include "fcrypt.h"
  19
  20 struct connStats {
  21     afs_uint32 bytesReceived, bytesSent, packetsReceived, packetsSent;
  22 };
  23
  24 /* Private data structure representing an RX server end point for rxkad.
  25  * This structure is encrypted in network byte order and transmitted as
  26  * part of a challenge response.  It is also used as part of the per-packet
  27  * checksum sent on every packet, to ensure that the per-packet checksum
  28  * is not used in the context of another end point.
  29  *
  30  * THIS STRUCTURE MUST BE A MULTIPLE OF 8 BYTES LONG SINCE IT IS
  31  * ENCRYPTED IN PLACE!
  32  */
  33 struct rxkad_endpoint {
  34     afs_int32 cuid[2];          /* being used for connection routing */
  35     afs_uint32 cksum;           /* cksum of challenge response */
  36     afs_int32 securityIndex;    /* security index */
  37 };
  38
  39 /* structure used for generating connection IDs; must be encrypted in network
  40  * byte order.  Also must be a multiple of 8 bytes for encryption to work
  41  * properly.
  42  */
  43 struct rxkad_cidgen {
  44     struct clock time;          /* time now */
  45     afs_int32 random1;          /* some implementation-specific random info */
  46     afs_int32 random2;          /* more random info */
  47     afs_int32 counter;          /* a counter */
  48     afs_int32 ipAddr;           /* or an approximation to it */
  49 };
  50
  51 #define PDATA_SIZE(l) (sizeof(struct rxkad_cprivate) - MAXKTCTICKETLEN + (l))
  52
  53 /* private data in client-side security object */
  54 /* type and level offsets should match sprivate */
  55 struct rxkad_cprivate {
  56     rxkad_type type;            /* always client */
  57     rxkad_level level;          /* minimum security level of client */
  58     afs_int32 kvno;             /* key version of ticket */
  59     afs_int32 ticketLen;        /* length of ticket */
  60     fc_KeySchedule keysched;    /* the session key */
  61     fc_InitializationVector ivec;       /* initialization vector for cbc */
  62     char ticket[MAXKTCTICKETLEN];       /* the ticket for the server */
  63 };
  64
  65 /* Per connection client-side info */
  66 struct rxkad_cconn {
  67     fc_InitializationVector preSeq;     /* used in computing checksum */
  68     struct connStats stats;
  69     char cksumSeen;             /* rx: header.spare is a checksum */
  70 };
  71
  72 /* private data in server-side security object */
  73 /* type and level offsets should match cprivate */
  74 struct rxkad_sprivate {
  75     rxkad_type type;            /* always server */
  76     rxkad_level level;          /* minimum security level of server */
  77     char *get_key_rock;         /* rock for get_key function */
  78     int (*get_key) ();          /* func. of kvno and server key ptr */
  79     int (*user_ok) ();          /* func called with new client name */
  80     afs_uint32 flags;           /* configuration flags */
  81 };
  82
  83 /* private data in server-side connection */
  84 struct rxkad_sconn {
  85     rxkad_level level;          /* security level of connection */
  86     char tried;                 /* did we ever try to auth this conn */
  87     char authenticated;         /* connection is good */
  88     char cksumSeen;             /* rx: header.spare is a checksum */
  89     afs_uint32 expirationTime;  /* when the ticket expires */
  90     afs_int32 challengeID;      /* unique challenge */
  91     struct connStats stats;     /* per connection stats */
  92     fc_KeySchedule keysched;    /* session key */
  93     fc_InitializationVector ivec;       /* initialization vector for cbc */
  94     fc_InitializationVector preSeq;     /* used in computing checksum */
  95     struct rxkad_serverinfo *rock;      /* info about client if saved */
  96 };
  97
  98 struct rxkad_serverinfo {
  99     int kvno;
 100     struct ktc_principal client;
 101 };
 102
 103 #define RXKAD_CHALLENGE_PROTOCOL_VERSION 2
 104
 105 /* An old style (any version predating 2) challenge packet */
 106 struct rxkad_oldChallenge {
 107     afs_int32 challengeID;
 108     afs_int32 level;            /* minimum security level */
 109 };
 110
 111 /* A version 2 challenge */
 112 struct rxkad_v2Challenge {
 113     afs_int32 version;
 114     afs_int32 challengeID;
 115     afs_int32 level;
 116     afs_int32 spare;
 117 };
 118
 119 /* An old challenge response packet */
 120 struct rxkad_oldChallengeResponse {
 121     struct {                    /* encrypted with session key */
 122         afs_int32 incChallengeID;
 123         afs_int32 level;
 124     } encrypted;
 125     afs_int32 kvno;
 126     afs_int32 ticketLen;
 127 };
 128 /*  <ticketLen> bytes of ticket follow here */
 129
 130 /* A version 2 challenge response also includes connection routing (Rx server
 131  * end point) and client call number state as well as version and spare fields.
 132  * The encrypted part probably doesn't need to start on an 8 byte boundary, but
 133  * just in case we put in a spare. */
 134 struct rxkad_v2ChallengeResponse {
 135     afs_int32 version;
 136     afs_int32 spare;
 137     struct {                    /* encrypted with session key */
 138         struct rxkad_endpoint endpoint; /* for connection routing */
 139         afs_int32 callNumbers[RX_MAXCALLS];     /* client call # state */
 140         afs_int32 incChallengeID;
 141         afs_int32 level;
 142     } encrypted;
 143     afs_int32 kvno;
 144     afs_int32 ticketLen;
 145 };
 146 /*  <ticketLen> bytes of ticket follow here */
 147 #if RX_MAXCALLS != 4
 148 The above structure requires
 149 that(RX_MAXCALLS == 4).
 150 #endif
 151 #endif /* RXKAD_PRIVATE_DATA_H */