SPICE协议-----基本简介及普通协议定义

1 SPICE协议简介

SPICE协议定义了一组协议消息来访问、控制、和接收通过网络从远程计算机设备（如：键盘、视频、鼠标）的操作，并回复发送输出。控制设备既可以在客户端，也可以在服务端。另外，协议定义了一组支持远程服务器从一个网络地址迁移到另一个网络地址。加密传输数据，有一个例外，在选择加密方法上比较灵活。SPICE使用简单的消息传递和不依赖于任何RPC标准或特定的传输层。

SPICE通信会话分为多种沟通通道道（每个通道针对一个远程设备）为了有能力控制通信和执行根据通道类型的消息（如QOS加密），并在运行时添加和删除通道（支持SPICE自定义）。

1）主通道作为主要的SPICE会话通道

2）显示通道接收远程显示更新

3）输入通道发送鼠标和键盘事件

4）光标通道接收指针形状和位置

5）播放通道接收音频流

6）录音通道发送客户端音频输入。

随着协议的发展将添加更多的通道类型，SPICE还定义了一组协议同步信道在远程站点上执行。

2 普通协议定义

2.2协议版本

协议版本定义为两个UINT32值，主要协议版本和次要协议版本。服务器和客户端拥有相同的主要版本，为了保持兼容性不管次要版本号。

?RED_VERSION_MAJOR = 1

?RED_VERSION_MINOR = 0

2.3通道类型-UINT8

?RED_CHANNEL_MAIN = 1

?RED_CHANNEL_DISPLAY = 2

?RED_CHANNEL_INPUTS = 3

? RED_CHANNEL_CURSOR = 4

?RED_CHANNEL_PLAYBACK = 5

?RED_CHANNEL_RECORD = 6

通道连接过程是由客户端发起。客户端发送RedLinkMess，作为回应服务器发送RedLinkReply。当客户端接收到RedLinkReply时，它检查返回错误代码，如果没有错误它会加密公钥密码在RedLinkReply并将其发送到服务器。服务器接收密码并将链接的结果发给客户端。客户端检查连接的结果，如果结果为RED_ERROR_OK，建立一个有效的链接。除了RED_CHANNEL_MAIN以外其他的通道类型只允许在客户端主动连接RED_CHANNEL_MAIN。仅仅在RED_CHANNEL_MAIN通道被允许后，才会建立起与远程服务器的会话。

2.4.2 Ticketing

Ticketing是SPICE协议的一种实现机制目的是为了确保只允许有授权的来源连接。为了确保这种机制，Ticketing是一个在SPICE服务器端有密码和有效时间段的组成。时间过期后，这个Ticketing也就过期了。这个Ticketing是加密的。为了使用加密，服务器生成一个1024位的RSA密钥并向客户端发送公钥（通过RedLinkInfo）。客户端使用这个公钥加密密码并将其发回服务器（RedLinkMess之后）。服务器解密密码，比较它的ticketing和确保在允许的时间框架内。

2.4.3 RedLinkMess定义

typedef structSPICE_ATTR_PACKED SpiceLinkHeader {

uint32_t magic; //必须为RED_MAGIC

uint32_t major_version; //客户端主版本号

uint32_t minor_version;//客户端次版本号

uint32_t size; //后续数据的大小

}SpiceLinkHeader;

typedef structSPICE_ATTR_PACKED SpiceLinkMess {

uint32_t connection_id; //针对一个新的会话（例如RED_CHANNEL_MAIN）这个数值被设置为0，服务器将分配会话ID并在RedLinkMess消息中发给客户端。其他通道类型。使用分配的会话ID。

uint8_t channel_type; //通道类型

uint8_t channel_id; //通道ＩＤ，同一个ＩＤ可能有多个通道。

uint32_t num_common_caps;//普通客户端通道功能词数量

uint32_t num_channel_caps; //特殊客户端通道功能词数量

uint32_t caps_offset; //这个结构体的大小。后续还有能力集数值

} SpiceLinkMess;

2.4.4 RedLinkReply定义

typedef structSPICE_ATTR_PACKED SpiceLinkHeader {
   uint32_t magic;             //必须为RED_MAGIC
    uint32_t major_version; //服务器主版本号
    uint32_t minor_version;// 服务器次版本号
    uint32_t size;                     //后续数据的大小
}SpiceLinkHeader;
typedef structSPICE_ATTR_PACKED SpiceLinkReply {
    uint32_t error;          //版本号协商结果，错误码
    uint8_t pub_key[SPICE_TICKET_PUBKEY_BYTES];//公钥
    uint32_t num_common_caps;  //普通服务器通道功能词数量
    uint32_t num_channel_caps;   //普通服务器通道功能词数量
    uint32_t caps_offset;         //偏移量
}SpiceLinkReply;