onion_ntor.h 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. /* Copyright (c) 2012-2016, The Tor Project, Inc. */
  2. /* See LICENSE for licensing information */
  3. #ifndef TOR_ONION_NTOR_H
  4. #define TOR_ONION_NTOR_H
  5. #include "torint.h"
  6. #include "crypto_curve25519.h"
  7. #include "di_ops.h"
  8. /** State to be maintained by a client between sending an ntor onionskin
  9. * and receiving a reply. */
  10. typedef struct ntor_handshake_state_t ntor_handshake_state_t;
  11. /** Length of an ntor onionskin, as sent from the client to server. */
  12. #define NTOR_ONIONSKIN_LEN 84
  13. /** Length of an ntor reply, as sent from server to client. */
  14. #define NTOR_REPLY_LEN 64
  15. void ntor_handshake_state_free(ntor_handshake_state_t *state);
  16. int onion_skin_ntor_create(const uint8_t *router_id,
  17. const curve25519_public_key_t *router_key,
  18. ntor_handshake_state_t **handshake_state_out,
  19. uint8_t *onion_skin_out);
  20. int onion_skin_ntor_server_handshake(const uint8_t *onion_skin,
  21. const di_digest256_map_t *private_keys,
  22. const curve25519_keypair_t *junk_keypair,
  23. const uint8_t *my_node_id,
  24. uint8_t *handshake_reply_out,
  25. uint8_t *key_out,
  26. size_t key_out_len);
  27. int onion_skin_ntor_client_handshake(
  28. const ntor_handshake_state_t *handshake_state,
  29. const uint8_t *handshake_reply,
  30. uint8_t *key_out,
  31. size_t key_out_len,
  32. const char **msg_out);
  33. #ifdef ONION_NTOR_PRIVATE
  34. /** Storage held by a client while waiting for an ntor reply from a server. */
  35. struct ntor_handshake_state_t {
  36. /** Identity digest of the router we're talking to. */
  37. uint8_t router_id[DIGEST_LEN];
  38. /** Onion key of the router we're talking to. */
  39. curve25519_public_key_t pubkey_B;
  40. /**
  41. * Short-lived keypair for use with this handshake.
  42. * @{ */
  43. curve25519_secret_key_t seckey_x;
  44. curve25519_public_key_t pubkey_X;
  45. /** @} */
  46. };
  47. #endif
  48. #endif