CommunicationSecrets.h

Go to the documentation of this file.

/*
 * Copyright (C) 1996-2025 The Squid Software Foundation and contributors
 *
 * Squid software is distributed under GPLv2+ license and includes
 * contributions from numerous individuals and organizations.
 * Please see the COPYING and CONTRIBUTORS files for details.
 */
 
#ifndef SQUID_SRC_SECURITY_COMMUNICATIONSECRETS_H
#define SQUID_SRC_SECURITY_COMMUNICATIONSECRETS_H
 
#include "sbuf/SBuf.h"
#include "security/Session.h"
 
#include <iosfwd>
 
namespace Security {
 
class CommunicationSecrets
{
public:
    CommunicationSecrets() = default;
    explicit CommunicationSecrets(const Connection &sconn);
 
    bool gotAll() const;
 
    bool learnNew(const CommunicationSecrets &news);
 
    void record(std::ostream &) const;
 
private:
#if USE_OPENSSL
    void getClientRandom(const Connection &sconn);
    void getSessionId(const Session &session);
    void getMasterKey(const Session &session);
#else
    // Secret extraction is not supported in builds using other TLS libraries.
    // Secret extraction is impractical in builds without TLS libraries.
#endif
 
    SBuf id; 
    SBuf random; 
    SBuf key; 
};
 
} // namespace Security
 
#endif /* SQUID_SRC_SECURITY_COMMUNICATIONSECRETS_H */