（一） CloudStack 生成 Signature 调用API （C#）
一：前言
撸主刚开始尝试使用CloudStack API时； 查阅相关资料，网上基本是官方的一个版本。大多都是复制内容；没有任何帮助。且撸主是在 .NET 的框架下操作；资料更少，目前经过学习摸索 系统基本处于稳定，故将前期遇到的问题整理一二，望能对大家有所帮助。
/***************该段-官话********************/
CloudStack API 也是基于 Web Service，可以使用任何一种支持 HTTP 调用的语言（例如 Java，PHP）编写代码。
调用代码（caller）首先需要在管理服务器进行认证。目前 CloudStack 采用两种认证方式：
Session 认证：通过 login API，获得一个 JSESSIONID cookie 和一个 SESSIONKEY token。
API Key 认证。
/***************该段-官话********************/
二：撸主采用 API Key 进行认证：
1、生成Signature 之前，我们得先拥有[API Key] & [Security Key]，该文主要记录Signature 加密实现，如何生成这两个Key 撸主 便不再赘述。
2、官方提供生成Signature 的语言是Perl：地址如下，可自行观摩：
https://github.com/snumano/CloudStack-API/blob/master/generate-url.pl
3、进而撸主又找到了 Python 版本：地址如下：
https://github.com/jasonhancock/cloudstack-pythonclient/blob/master/CloudStack/BaseClient.py
4、当然也少不了Java 版本的：CloudStack 开源包里应该能找到，在此撸主分享一篇帖文：
http://blog.csdn.net/rishengcsdn/article/details/38387721
三：使用C# 生成 Signature，有了以上资料，写起C# 版本的，自是得心应手，当然也有些许差异，几个问题需要注意：
1、[ApiKey] & [SecretKey] 字符串较长，切勿出错
2、参数加密时以小些形式
3、参数加密时，需要对其进行排序（以参数第一个字母为准）
4、加密前统一编码：UTF8
5、加密方式为：HmacSha1
6、加密后信息确认编码为： UTF8
7、组合字符串
四：代码实现（仅供参考，测试代码）
如：获取云主机的状态信息
参数信息：
调用地址：“http://*.*.*.*:**/client/api?”
API 名称： “listVirtualMachines”
参 数：
details=stats 状态
account=admin 操作人账号
id=**** 虚拟主机编号
API KEY：“******************”
SecretKey： “****************”
/// <summary> 生成 CloudStack Signature 可执行Url
/// 生成 CloudStack 可执行Url
/// </summary>
/// <returns></returns>
public string GetSignatureApiUrl()
{
/* 调用CloudStack API 生成Signature 并组合完整URL
* 1、根据配置获取参数
* 2、有效性验证
* 3、参数信息排序
* 4、统一编码 UTF-8
* 5、使用HmacSha1 编码加密
* 6、加密后内容再次转UTF-8
* 7、组合
*/
var ApiKey="*********************";
var SecretKey="******************";
//CloudStack API 调用地址
var DeveloperServer ="http://*.*.*.*:**/client/api?";
//ApiKey 统一编码
Encoding enc = new UTF8Encoding();
string encodedApiKey = HttpUtility.UrlEncode(ApiKey, enc);
string encodedSecreKey = HttpUtility.UrlEncode(SecretKey, enc);
//参数，传递过来
List<string> Args = new List<string>();
Args.Add("command="+Command)
Args.Add("details=stats");
Args.Add("account=admin");
Args.Add("id=****");
//有效性验证
//略
var oldparmsString=string.Join("&",Args);
Args.Add("apikey="+ApiKey)
//参数信息进行排序
Args = Args.OrderBy(o=>o).ToList();
//参数拼接
var paramsString = string.Join("&",Args);
//对执行信息进行加密
string signature = new HashEncryptHelp().HmacSha1(encodedSecreKey, paramsString.Tolower());
//加密信息转UTF-8
string encodedSignature = HttpUtility.UrlEncode(signature, enc);
//组合URL字符
string url = DeveloperServer + oldparmsString+ "&apikey=" + encodedApiKey + "&signature=" + encodedSignature;
return url;
}
输出：http://*.*.*.*:**/client/api?command=listVirtualMachines&details=stats&account=admin&id=****&apikey=****&signature=****
测试执行：成功.