锟斤拷锟斤拷位锟矫ｏ拷锟斤拷页 > 锟斤拷锟斤拷锟教筹拷 > 锟教筹拷 > IceRPC之锟斤拷锟斤拷锟斤拷锟斤拷址锟斤拷TLS锟侥帮拷全锟斤拷->锟斤拷锟街碉拷RPC

IceRPC之锟斤拷锟斤拷锟斤拷锟斤拷址锟斤拷TLS锟侥帮拷全锟斤拷->锟斤拷锟街碉拷RPC

锟斤拷源锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷|锟斤拷时锟戒：2024-05-12 11:48:43 |锟斤拷锟侥讹拷锟斤拷120锟斤拷|锟斤拷锟斤拷签锟斤拷 T 全锟斤拷址 S C 锟斤拷锟斤拷锟斤拷锟斤拷 PC 锟斤拷锟斤拷锟斤拷锟斤拷全锟斤拷 |锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷

锟斤拷锟斤拷锟斤拷锟斤拷 .Net 8.0 锟铰碉拷锟斤拷RPC 锟杰革拷锟剿帮拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷IceRPC之锟斤拷锟斤拷锟斤拷锟斤拷址锟斤拷TLS锟侥帮拷全锟斤拷->锟斤拷锟街碉拷RPC, 锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟窖诧拷锟斤拷锟斤拷茫锟斤拷锟斤拷锟街的筹拷锟斤拷锟斤拷锟界。锟斤拷锟斤拷锟斤拷锟斤拷址 ServerAddress 锟剿斤拷锟斤拷锟斤拷锟斤拷锟街凤拷母锟斤拷锟斤拷锟斤法锟斤拷锟斤法锟斤拷锟斤拷锟斤拷锟斤拷址URI锟斤拷锟斤拷锟斤拷锟斤拷锟斤法: protocol:/

锟斤拷锟斤拷锟斤拷锟斤拷 `.Net 8.0 锟铰碉拷锟斤拷RPC`

锟杰革拷锟剿帮拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷IceRPC之锟斤拷锟斤拷锟斤拷锟斤拷址锟斤拷TLS锟侥帮拷全锟斤拷->锟斤拷锟街碉拷RPC, 锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟窖诧拷锟斤拷锟斤拷茫锟斤拷锟斤拷锟街的筹拷锟斤拷锟斤拷锟界。

锟斤拷锟斤拷锟斤拷锟斤拷址 `ServerAddress`

锟剿斤拷锟斤拷锟斤拷锟斤拷锟街凤拷母锟斤拷锟斤拷锟斤法锟斤拷

锟斤法

锟斤拷锟斤拷锟斤拷锟斤拷址 URI 锟斤拷锟斤拷锟斤拷锟斤拷锟斤法: protocol://host[:port][?name=value][&name=value...]

protocol 协锟斤拷 (URI锟斤拷锟斤拷)锟斤拷目前支锟斤拷 ice 锟斤拷 icerpc
host DNS 锟斤拷锟斤拷锟斤拷 IP 锟斤拷址
port 锟剿口猴拷; 未指锟斤拷时锟斤拷默锟较端匡拷为 4061 ice 锟斤拷 4062 icerpc

锟斤拷锟斤拷锟斤拷锟斤拷址 URI 锟斤拷锟斤拷锟斤拷锌锟铰凤拷锟斤拷锟矫伙拷锟狡拷巍锟斤拷锟斤拷锟斤拷锟斤拷胁锟窖拷锟斤拷锟斤拷锟斤拷锟叫╋拷锟斤拷锟酵拷锟斤拷锟斤拷囟锟斤拷诖锟斤拷锟侥★拷

锟斤拷询锟斤拷锟斤拷锟斤拷锟斤拷 transport 指锟斤拷锟阶层传锟斤拷锟斤拷锟斤拷啤锟斤拷锟斤拷锟斤拷应锟矫筹拷锟斤拷使锟矫碉拷锟斤拷锟斤拷锟戒，锟斤拷锟斤拷锟剿达拷锟斤拷锟斤拷锟斤拷锟斤拷为锟斤拷锟角匡拷锟斤拷使锟矫碉拷唯一锟斤拷锟戒。锟斤拷耍锟斤拷诜锟斤拷锟斤拷锟斤拷锟街凤拷锟绞★拷源锟斤拷锟� transport 锟角很筹拷锟斤拷锟侥★拷

C# 锟叫ｏ拷锟结构锟斤拷 ServerAddress 锟角凤拷锟斤拷锟斤拷锟斤拷址 URI 锟侥斤拷锟斤拷锟斤拷锟斤拷证锟斤拷锟斤拷锟节憋拷锟斤拷URI锟斤拷息锟饺★拷

锟酵伙拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷

锟酵伙拷锟斤拷锟斤拷锟接碉拷锟斤拷要锟斤拷锟斤拷锟角凤拷锟斤拷锟斤拷锟侥碉拷址锟斤拷锟斤拷锟斤拷锟竭客伙拷锟斤拷锟斤拷锟斤拷锟斤拷蔚锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷DNS 锟斤拷锟斤拷锟斤拷锟斤拷些锟斤拷锟斤拷锟斤拷锟斤拷址锟斤拷锟角很筹拷锟斤拷锟侥★拷

锟斤拷锟斤拷:

锟斤拷锟斤拷锟斤拷锟斤拷址	说锟斤拷
`icerpc://hello.zeroc.com`	使锟斤拷 `icerpc` 协锟斤拷锟斤拷锟接碉拷锟剿匡拷 4062 锟较碉拷 `hello.zeroc.com` 锟斤拷未指锟斤拷锟阶层传锟戒。
`icerpc://192.168.100.10:10000?transport=quic`	使锟斤拷 QUIC 锟较碉拷 `icerpc` 协锟介，锟斤拷锟接端匡拷 10000 锟较碉拷 `192.168.100.10` Ip锟斤拷址
`ice://hello.zeroc.com`	使锟斤拷 ice 协锟斤拷锟斤拷锟接端匡拷 4061 锟较碉拷 `hello.zeroc.com` 锟斤拷址

锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷

指锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷时锟斤拷要锟斤拷锟斤拷锟侥凤拷锟斤拷锟斤拷锟斤拷址锟斤拷

锟斤拷锟斤拷锟街革拷锟斤拷锟斤拷锟斤拷锟斤拷锟街凤拷锟侥拷锟街滴� icerpc://[::0] 锟斤拷锟斤拷锟斤拷味锟脚ｏ拷锟斤拷锟斤拷默锟斤拷 icerpc 锟剿匡拷 (4062) 锟斤拷锟斤拷锟叫接匡拷锟较碉拷 icerpc 锟斤拷锟接★拷

锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷时锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷址锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷 [::0] 锟斤拷锟斤拷锟斤拷通锟斤拷锟絠p锟斤拷址锟斤拷锟斤拷锟斤拷锟角碉拷前系统锟斤拷锟截讹拷锟接口碉拷ip锟斤拷址锟斤拷

锟斤拷锟斤拷丝诤锟街革拷锟� 0锟斤拷锟斤拷锟斤拷系统锟斤拷锟皆讹拷锟斤拷锟斤拷锟斤拷锟斤拷莘锟轿э拷诘亩丝诤拧锟斤拷锟轿拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷 tcp 锟斤拷 udp 锟剿匡拷 0锟斤拷

锟斤拷锟斤拷锟斤拷一些示锟斤拷:

锟斤拷锟斤拷锟斤拷锟斤拷址	说锟斤拷
`icerpc://192.168.100.10`	使锟斤拷默锟斤拷 `icerpc` 锟剿匡拷 4062锟斤拷锟斤拷锟斤拷锟斤拷 `192.168.100.10` 锟斤拷锟斤拷锟侥接匡拷锟较碉拷 `icerpc` 锟斤拷锟接★拷
`icerpc://[::0]:0`	锟斤拷锟斤拷锟斤拷锟叫接匡拷锟较碉拷 `icerpc` 锟斤拷锟接ｏ拷锟斤拷锟斤拷系统锟皆讹拷选锟斤拷要使锟矫的端口号★拷
`ice://0.0.0.0:10000`	10000 锟剿匡拷锟斤拷 IPv4 锟斤拷址锟斤拷锟斤拷锟叫接匡拷锟较硷拷锟斤拷 ice 锟斤拷锟接★拷

C# 锟叫ｏ拷锟斤拷锟节凤拷锟斤拷锟斤拷锟斤拷址锟斤拷指锟斤拷锟剿匡拷 0 时锟斤拷 Listen 锟结返锟斤拷一锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷址锟斤拷锟斤拷锟叫帮拷锟斤拷 OS 选锟斤拷亩丝诤牛锟�

using IceRpc;

await using var server = new Server(...,new Uri("icerpc://[::1]:0"));
ServerAddress actualServerAddress = server.Listen();
Console.WriteLine($"server is now listening on {actualServerAddress}"); // shows actual port
// then somehow share this server address with the clients

TLS 锟侥帮拷全锟斤拷

锟剿斤拷锟斤拷锟绞癸拷锟絋LS锟斤拷锟斤拷锟斤拷锟斤拷

TLS - 锟斤拷锟戒功锟斤拷

Ice 锟斤拷 icerpc 协锟斤拷劝锟饺诧拷锟斤拷遣锟斤拷锟饺�,锟斤拷为使锟斤拷 TLS 锟斤拷锟斤拷通锟脚ｏ拷锟角底层传锟斤拷锟斤拷锟斤拷巍锟�

icerpc 协锟斤拷没锟斤拷锟斤拷锟斤拷 https "s"锟戒化,也没锟斤拷锟斤拷锟节帮拷全 icerpc 锟斤拷锟接的讹拷锟截帮拷全锟剿口★拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷址 icerpc://hello.zeroc.com 时, 锟斤拷锟皆匡拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟节硷拷锟斤拷默锟较碉拷 icerpc 锟剿口ｏ拷锟斤拷锟睫凤拷锟叫讹拷锟斤拷锟接碉拷锟矫凤拷锟斤拷锟斤拷锟斤拷锟斤拷锟接ｏ拷锟斤拷使锟斤拷锟斤拷锟街达拷锟戒，锟皆硷拷锟矫达拷锟斤拷锟角凤拷使锟斤拷锟斤拷 TLS 锟斤拷

Quic

Quic 锟斤拷锟斤拷协锟介，始锟斤拷锟角帮拷全锟侥★拷锟斤拷锟斤拷锟斤拷突锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟轿癸拷锟� Quic ,锟斤拷锟斤拷锟斤拷咏锟绞癸拷锟� TLS 锟斤拷

锟斤拷锟斤拷:

// Always uses TLS.
await using var connection = new ClientConnection(
    "icerpc://hello.zeroc.com",
    multiplexedClientTransport: new QuicClientTransport());

同锟斤拷锟斤拷锟竭硷拷也锟斤拷锟斤拷锟节凤拷锟斤拷锟斤拷:锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟轿癸拷锟� Quic ,锟斤拷梅锟斤拷锟斤拷锟斤拷锟斤拷艿锟斤拷魏锟斤拷锟斤拷佣锟斤拷锟绞癸拷锟� TLS 锟斤拷

锟斤拷 C# 锟斤拷,锟斤拷要为锟轿猴拷使锟斤拷 Quic 锟侥凤拷锟斤拷锟斤拷指锟斤拷 TLS 锟斤拷锟矫ｏ拷锟截憋拷锟斤拷 X.509 证锟介。

锟斤拷锟斤拷:

// SslServerAuthenticationOptions is required with QuicServerTransport.
await using var server = new Server(
    new Chatbot(),
    new SslServerAuthenticationOptions
    {
        ServerCertificate = new X509Certificate2("server.p12")
    },
    multiplexedServerTransport: new QuicServerTransport());

Tcp

Tcp 锟斤拷锟斤拷锟斤拷锟绞癸拷锟�,也锟斤拷锟皆诧拷使锟斤拷 TLS 锟斤拷锟斤拷锟斤拷锟轿� Tcp 锟斤拷锟斤拷锟酵伙拷锟斤拷锟斤拷锟斤拷时指锟斤拷 TLS 锟斤拷锟斤拷,锟斤拷锟斤拷锟斤拷咏锟绞癸拷锟� TLS 锟斤拷锟斤拷锟斤拷锟街革拷锟� TLS 锟斤拷锟矫ｏ拷锟斤拷锟接斤拷锟斤拷锟斤拷使锟斤拷 TLS 锟斤拷

锟斤拷 C# 锟斤拷,锟矫客伙拷锟斤拷 TLS 锟斤拷锟斤拷锟斤拷 SslClientAuthenticationOptions 锟斤拷锟斤拷锟结供锟斤拷锟斤拷锟斤拷:

// The default multiplexed transport for icerpc is tcp (implemented by SlicClientTransport over TcpClientTransport).
// This connection does not use TLS since we don't pass a SslClientAuthenticationOptions parameter.
await using var plainTcpConnection = new ClientConnection("icerpc://hello.zeroc.com");

// We pass a non-null SslClientAuthenticationOptions so the connection uses TLS.
await using var secureTcpConnection = new ClientConnection(
    "icerpc://hello.zeroc.com",
    new SslClientAuthenticationOptions());

锟斤拷锟斤拷 Tcp 锟侥凤拷锟斤拷锟斤拷锟斤拷说锟斤拷锟斤拷一锟斤拷锟侥★拷锟斤拷锟斤拷诖锟斤拷锟斤拷朔锟斤拷锟斤拷锟绞憋拷锟街革拷锟� TLS 锟斤拷锟矫ｏ拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟� TLS 锟斤拷锟斤拷锟斤拷锟斤拷锟接★拷锟斤拷锟斤拷诖锟斤拷锟斤拷朔锟斤拷锟斤拷锟绞蔽粗革拷锟� TLS 锟斤拷锟矫ｏ拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷芗虻サ锟� tcp 锟斤拷锟接★拷

SSL (锟斤拷锟斤拷 `ice` )

Ice 锟斤拷锟斤拷锟斤拷锟斤拷址锟斤拷锟斤拷指锟斤拷ssl锟斤拷锟戒，锟斤拷锟斤拷 ice://hello.zeroc.com?transport=ssl . 锟斤拷锟斤拷 Ice 锟截讹拷锟斤拷 ssl 锟斤拷锟斤拷锟斤拷 tcp 锟斤拷锟斤拷锟斤拷同锟斤拷锟斤拷锟斤拷始锟秸帮拷全锟斤拷锟斤拷锟解方锟芥， ssl 锟斤拷锟斤拷 quic 锟斤拷

锟斤拷锟斤拷:

// Uses the default client transport, TcpClientTransport.
await using var connection = new ClientConnection("ice://hello.zeroc.com?transport=ssl");

锟洁当锟斤拷:

await using var connection = new ClientConnection(
    "ice://hello.zeroc.com?transport=tcp",
    new SslClientAuthenticationOptions());

ssl 锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟� Ice : Ice 应锟矫筹拷锟斤拷锟斤拷锟斤拷全锟斤拷锟接的憋拷准锟斤拷式锟斤拷使锟矫撅拷锟斤拷 ssl 锟斤拷锟斤拷锟斤拷锟斤拷址锟侥达拷锟斤拷锟斤拷

IceRPC + Slice 锟斤拷锟斤拷锟斤拷锟� ssl 锟斤拷锟斤拷锟斤拷锟斤拷址锟侥凤拷锟斤拷锟街肥�, ssl 锟斤拷锟戒捕锟斤拷锟斤拷锟较�("锟斤拷要 TLS ")锟斤拷确锟斤拷锟酵伙拷锟斤拷锟节碉拷锟矫此凤拷锟斤拷锟街肥憋拷锟斤拷锟斤拷锟饺拷锟斤拷印锟�

锟斤拷锟斤拷 Ice , tcp 锟斤拷锟斤拷锟斤拷味锟斤拷"锟斤拷使锟斤拷 TLS ". 锟斤拷锟斤拷 IceRPC , tcp 锟斤拷锟斤拷锟斤拷味锟斤拷锟斤拷通 tcp 锟斤拷 tcp + tls ,锟斤拷锟斤拷取锟斤拷锟斤拷 TLS 锟斤拷锟矫★拷

Icerpc 协锟斤拷,锟酵伙拷锟剿和凤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷同锟斤拷 TLS 锟斤拷锟斤拷锟斤拷锟斤拷,锟斤拷锟揭达拷锟斤拷 transport=tcp 锟斤拷 icerpc 锟斤拷锟斤拷锟斤拷锟斤拷址,锟斤拷锟斤拷锟斤拷指锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷要 TLS 锟斤拷

coloc 锟斤拷锟斤拷

锟斤拷锟节诧拷锟皆碉拷 coloc 锟斤拷锟戒，锟斤拷支锟斤拷 TLS 锟斤拷锟斤拷锟绞癸拷锟� coloc 指锟斤拷 TLS 锟斤拷锟斤拷,锟斤拷锟秸碉拷锟斤拷锟斤拷

// Does not work: can't get a TLS connection with a transport that doesn't support TLS.
await using var connection = new ClientConnection(
    "icerpc://colochost",
    new SslClientAuthenticationOptions()
    multiplexedClientTransport: new SlicClientTransport(colocClientTransport));