AGENTS.md

1# Security Handshakers
2 
3This directory contains the implementation of the security handshakers, which are responsible for performing TLS and ALTS handshakes.
4 
5## Overarching Purpose
6 
7The security handshakers are responsible for establishing a secure connection between a client and a server. They use a transport security mechanism, such as TLS or ALTS, to authenticate the server and encrypt all communication between the client and the server.
8 
9## Files
10 
11- **`security_handshaker.h` / `security_handshaker.cc`**: Defines the `SecurityHandshaker` class, which is the base class for all security handshakers.
12- **`secure_endpoint.h` / `secure_endpoint.cc`**: Defines the `SecureEndpoint` class, which is a wrapper around a `grpc_endpoint` that provides a secure channel.
13- **`pipelined_secure_endpoint.cc`**: A `SecureEndpoint` implementation that supports pipelining.
14 
15## Notes
16 
17- The security handshakers are a critical component of gRPC's security infrastructure.
18- They are responsible for ensuring that all connections are properly authenticated and encrypted.
19- The `SecurityHandshaker` class is designed to be extensible, allowing new security mechanisms to be added easily.
20