mirror of
https://github.com/libp2p/go-libp2p.git
synced 2025-09-26 20:21:26 +08:00
43 lines
1.6 KiB
Go
43 lines
1.6 KiB
Go
// Package sec provides secure connection and transport interfaces for libp2p.
|
|
package sec
|
|
|
|
import (
|
|
"context"
|
|
"net"
|
|
|
|
"github.com/libp2p/go-libp2p/core/network"
|
|
"github.com/libp2p/go-libp2p/core/peer"
|
|
)
|
|
|
|
// SecureConn is an authenticated, encrypted connection.
|
|
type SecureConn interface {
|
|
net.Conn
|
|
network.ConnSecurity
|
|
}
|
|
|
|
// A SecureTransport turns inbound and outbound unauthenticated,
|
|
// plain-text, native connections into authenticated, encrypted connections.
|
|
type SecureTransport interface {
|
|
// SecureInbound secures an inbound connection.
|
|
// If p is empty, connections from any peer are accepted.
|
|
SecureInbound(ctx context.Context, insecure net.Conn, p peer.ID) (SecureConn, error)
|
|
|
|
// SecureOutbound secures an outbound connection.
|
|
SecureOutbound(ctx context.Context, insecure net.Conn, p peer.ID) (SecureConn, error)
|
|
}
|
|
|
|
// A SecureMuxer is a wrapper around SecureTransport which can select security protocols
|
|
// and open outbound connections with simultaneous open.
|
|
type SecureMuxer interface {
|
|
// SecureInbound secures an inbound connection.
|
|
// The returned boolean indicates whether the connection should be treated as a server
|
|
// connection; in the case of SecureInbound it should always be true.
|
|
// If p is empty, connections from any peer are accepted.
|
|
SecureInbound(ctx context.Context, insecure net.Conn, p peer.ID) (SecureConn, bool, error)
|
|
|
|
// SecureOutbound secures an outbound connection.
|
|
// The returned boolean indicates whether the connection should be treated as a server
|
|
// connection due to simultaneous open.
|
|
SecureOutbound(ctx context.Context, insecure net.Conn, p peer.ID) (SecureConn, bool, error)
|
|
}
|