C# Activex开发、打包、签名、发布

时间:2022-03-31 21:02:17

一、前言

      最近有这样一个需求,需要在网页上面启动客户端的软件,软件之间的通信、调用,单单依靠HTML是无法实现了,因此必须借用Activex来实现。由于本人主要擅长C#,自然本文给出了用C#实现的范例,本文的预期效果是有一定Winform基础的人可都轻松读懂本文。

文章主要介绍了以下几个部分:   1、用C#制作Activex控件,并发布为msi安装文件   2、将exe打包为cab,达到浏览器自动安装的效果   3、给cab数字签名(可选)   4、将Activex应用到网页上   二、用C#制作Activex控件,并发布为msi安装文件 1、新建window用户控件项目EasyActivex。其实VS2010并没有提供专门的Activex项目模板,所谓的Activex,只要符合com标准即可。 C# Activex开发、打包、签名、发布   2)在EasyActivex项目添加IObjectSafety接口 C# Activex开发、打包、签名、发布 在IObjectSafety接口代码如下,值得注意的是Guid不能随便改,必须为一下代码给出的Guid:  C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布
using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.InteropServices;

namespace EasyActivex
{

[ComImport, GuidAttribute("CB5BDC81-93C1-11CF-8F20-00805F2CD064")]
[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)]
public interface IObjectSafety
{
[PreserveSig]
int GetInterfaceSafetyOptions(ref Guid riid, [MarshalAs(UnmanagedType.U4)] ref int pdwSupportedOptions, [MarshalAs(UnmanagedType.U4)] ref int pdwEnabledOptions);

[PreserveSig()]
int SetInterfaceSafetyOptions(ref Guid riid, [MarshalAs(UnmanagedType.U4)] int dwOptionSetMask, [MarshalAs(UnmanagedType.U4)] int dwEnabledOptions);
}
}
C# Activex开发、打包、签名、发布

 

3)在EasyActivex项目添加EUserControl控件,在控件中实现IObjectSafety接口。 C# Activex开发、打包、签名、发布 在控件上面添加按钮,命名为btnOpenNote C# Activex开发、打包、签名、发布 控件的后台代码必须实现IObjectSafety接口 C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Text;
using System.Windows.Forms;
using System.Runtime.InteropServices;
namespace EasyActivex
{
//这个Guid,网页调用的时候用到,Mark
[Guid("685F0A47-944D-4145-BF4E-76A02A422B02")]
//这里要实现IObjectSafety接口
public partial class EUserControl : UserControl, IObjectSafety
{
public EUserControl()
{
InitializeComponent();
}
#region IObjectSafety 接口成员实现(直接拷贝即可)

private const string _IID_IDispatch = "{00020400-0000-0000-C000-000000000046}";
private const string _IID_IDispatchEx = "{a6ef9860-c720-11d0-9337-00a0c90dcaa9}";
private const string _IID_IPersistStorage = "{0000010A-0000-0000-C000-000000000046}";
private const string _IID_IPersistStream = "{00000109-0000-0000-C000-000000000046}";
private const string _IID_IPersistPropertyBag = "{37D84F60-42CB-11CE-8135-00AA004BB851}";

private const int INTERFACESAFE_FOR_UNTRUSTED_CALLER = 0x00000001;
private const int INTERFACESAFE_FOR_UNTRUSTED_DATA = 0x00000002;
private const int S_OK = 0;
private const int E_FAIL = unchecked((int)0x80004005);
private const int E_NOINTERFACE = unchecked((int)0x80004002);

private bool _fSafeForScripting = true;
private bool _fSafeForInitializing = true;

public int GetInterfaceSafetyOptions(ref Guid riid, ref int pdwSupportedOptions, ref int pdwEnabledOptions)
{
int Rslt = E_FAIL;

string strGUID = riid.ToString("B");
pdwSupportedOptions = INTERFACESAFE_FOR_UNTRUSTED_CALLER | INTERFACESAFE_FOR_UNTRUSTED_DATA;
switch (strGUID)
{
case _IID_IDispatch:
case _IID_IDispatchEx:
Rslt = S_OK;
pdwEnabledOptions = 0;
if (_fSafeForScripting == true)
pdwEnabledOptions = INTERFACESAFE_FOR_UNTRUSTED_CALLER;
break;
case _IID_IPersistStorage:
case _IID_IPersistStream:
case _IID_IPersistPropertyBag:
Rslt = S_OK;
pdwEnabledOptions = 0;
if (_fSafeForInitializing == true)
pdwEnabledOptions = INTERFACESAFE_FOR_UNTRUSTED_DATA;
break;
default:
Rslt = E_NOINTERFACE;
break;
}

return Rslt;
}

public int SetInterfaceSafetyOptions(ref Guid riid, int dwOptionSetMask, int dwEnabledOptions)
{
int Rslt = E_FAIL;
string strGUID = riid.ToString("B");
switch (strGUID)
{
case _IID_IDispatch:
case _IID_IDispatchEx:
if (((dwEnabledOptions & dwOptionSetMask) == INTERFACESAFE_FOR_UNTRUSTED_CALLER) && (_fSafeForScripting == true))
Rslt = S_OK;
break;
case _IID_IPersistStorage:
case _IID_IPersistStream:
case _IID_IPersistPropertyBag:
if (((dwEnabledOptions & dwOptionSetMask) == INTERFACESAFE_FOR_UNTRUSTED_DATA) && (_fSafeForInitializing == true))
Rslt = S_OK;
break;
default:
Rslt = E_NOINTERFACE;
break;
}

return Rslt;
}

#endregion

/// <summary>
/// 打开记事本
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void btnOpenNote_Click(object sender, EventArgs e)
{
System.Diagnostics.Process.Start("notepad.exe");
}
}
}
C# Activex开发、打包、签名、发布

小提示:EUserControl代码的Guid可以用VS附带的Guid生成工具生成:

C# Activex开发、打包、签名、发布

 4)在EasyActivex项目AssemblyInfo.cs文件中添加代码  C# Activex开发、打包、签名、发布 
//用户添加
[assembly: AllowPartiallyTrustedCallers()]

 

5)设置EasyActivex项目项目属性为com互操作 C# Activex开发、打包、签名、发布 6)新建windows程序安装项目EasySetup C# Activex开发、打包、签名、发布 7)将EasyActivex项目生产的dll添加到EasySetup项目中。下图的EasyActivex.dll为已经添加进去了的文件。 C# Activex开发、打包、签名、发布 8)在EasySetup项目中,设置EasyActivex.dll文件属性为vsdraCOM。 C# Activex开发、打包、签名、发布 完成以上步骤,生成下即可得到msi安装文件 三、将msi安装文件打包为cab,达到在浏览器中自动安装的效果 如果只是生成了msi文件,用户安装的时候比较麻烦,像安装一般软件一样,需要用户慢慢点击下一步,慢慢安装,在本项目中采用打包成cab文件的方式,做到用户点击运行后,即可自动安装。在这里需要准备文件有:    cabarc.exe:微软提供的cab打包工具    EasySetup.msi:  本案例中EasySetup项目生成的windows部署安装文件    install.inf : 需要跟EasySetup.msi打包在一起的文件,制作方法请见下文    build.bat:  打包的批处理命令,制作方法请见下文 1)  install.inf制作。新建txt文件,加入以下内容,将文件名重新命名为install.inf即可。其中EasyZSetup.msi即是要打包的安装程序的名称。C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布
[version]  
signature="$CHICAGO$"
AdvancedINF=2.0

[Setup Hooks]
hook1=hook1

[hook1]
run=msiexec.exe /i "%EXTRACT_DIR%\EasySetup.msi" /qn
C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布

 

2)   build.bat制作。新建txt文件,加入以下内容,将文件名重新命名build.bat即可。其中EasyActivex.cab是生成目标cab的名称;install.inf是第一步生成的文件名,而EasySetup.msi是需要打包的安装程序名;第二条ping命令仅仅是让批处理不要那么快退出,起到更利于观察生成结果的作用。

"cabarc.exe" -s 6144 n EasyActivex.cab install.inf EasySetup.msi
ping -n 20 127.0.0.1 >nul

 

 把以上四个文件复制到同一个文件夹中,双击build.bat批处理命令即可生成cab文件 C# Activex开发、打包、签名、发布 双击bat后的运行结果如下,其中EasyActivex.cab即是生成的目标cab文件。 C# Activex开发、打包、签名、发布  三、给cab数字签名(可选)      由于处于安全问题考虑,IE浏览器设置默认是禁用未签名的Activex控件的,不过想想也知道,假如打开个未知网页,“网页”就能随便调用计算机本地的东西是多么恐怖的事情,因此,浏览器运行的Activex必须是签名了的,也符合常理。     如果不怕用户麻烦,不采用cab签名的方式的话,也可以通过设置浏览器安全性来运行Activex。设置方法:打开浏览器--浏览器Internet选项--安全选项卡--自定义级别按钮-下载未签名的Activex控件设置为提示,保存即可。等安装完毕后,可以将“下载未签名的Activex控件”设置回禁用。   以下为给cab签名的方法,具体方法,数字认证网上面已经介绍得很详细:    1)申请、安装证书。上中国数字认证网(http://www.ca365.com/)申请一个免费数字证书(试用期为1年,如果企业用的话需要购买)。         操作方法:http://www.ca365.com/forward.do?pageurl=/ca/yhsc/4.jsp ,值得注意的是证书用途必须选择代码签名证书。        申请成功后的证书,由于是不带密钥的,因此下载完毕后只能够在申请证书的机器上安装、使用(签名文件),如果需要在其他机器上使用的话需要将密钥导出,操作方法为: http://www.ca365.com/forward.do?pageurl=/ca/yhsc/5.jsp 。   2)用证书给cab包签名:http://www.ca365.com/forward.do?pageurl=/ca/thsc/7.jsp  四、在解决方案中添加EasyWeb项目     终于到了最后一步,发布鸟。在解决方案中添加EasyWeb项目 C# Activex开发、打包、签名、发布  在网页目录中新建Activex文件夹,并将EasyActivex.cab文件拷贝进去 C# Activex开发、打包、签名、发布 在网页中添加以下代码,即可调用Activex控件了。值得注意的是codebase是cab包的相对路径;clsid是EUserControl控件的Guid。 
 <object id="csharpActiveX" codebase="Activex/EasyActivex.cab" classid="clsid:685F0A47-944D-4145-BF4E-76A02A422B02"></object>

运行效果如下:

C# Activex开发、打包、签名、发布

点击即可在网页中打开记事本了。

 

五、本案例源码+cab打包工具+数字签名工具下载

 

 

前言

ActiveX控件以前也叫做OLE控件,它是微软IE支持的一种软件组件或对象,可以将其插入到Web页面中,实现在浏览器端执行动态程序功能,以增强浏览器端的动态处理能力。通常ActiveX控件都是用C++或VB语言开发,本文介绍另一种方式,在.NET Framework平台上,使用C#语言开发ActiveX控件。

虽然本文通篇都在讲如何使用C#语言开发ActiveX控件,但我并不极力推荐使用这种技术,因为该技术存在明显的局限,即需要浏览器端安装.NET Framework(版本取决于开发ActiveX控件使用的.NET Framework版本),该局限对于挑剔的互联网用户,几乎是不可接受的。所以,我建议以下几条均满足时,方可考虑使用该技术:

  • 开发团队中没有人掌握使用C++/VB开发ActiveX控件技术;
  • 该ActiveX控件不用于互联网;
  • 用户对仅能使用IE浏览器访问表示可以接受;
  • 用户对在浏览器端安装.NET Framework组件表示可以接受。

另外,我建议如果不是因为控件的依赖库基于更高版本的.NET Framework,或需要更高版本的.NET Framework提供的扩展功能(如需要WCF等),尽量在.NET Framework 2.0上开发ActiveX控件,因为.NET Framework 2.0只有20M,相比300M的.NET Framework 3.5和40M的.NET Framework 4.0都要小很多,对客户端操作系统的要求也要低很多,并且随着Windows版本的不断升级换代,Windows Vista以后的版本已经内置了.NET Framework 2.0。等到Windows XP系统寿终正寝之时,也将迎来该技术的春天。所以,别被我上面的建议夯退了,掌握该技术其实还是蛮有实用价值的,毕竟,C#高效的开发效率很有吸引力。

本文接下来将使用C#语言开发一个ActiveX控件,实现对浏览器端的MAC地址遍历功能;另外,提供一个在Web静态页面中调用该控件的测试实例。本实例的开发环境为Visual Studio 2010旗舰版(SP1),目标框架为.NET Framework 2.0;浏览器端测试环境为Windows 7旗舰版,IE8。

控件开发

使用C#进行ActiveX控件开发过程其实很简单。首先,在解决方案中添加一个类库项目,目标框架使用.NET Framework 2.0,如图1所示:

C# Activex开发、打包、签名、发布 

1创建ActiveX控件类库

此处有一个关键操作,需要设置类库项目属性->程序集信息->使程序集COM可见,如图2所示:

C# Activex开发、打包、签名、发布 

2设置ActiveX控件类库程序集COM可见

ActiveX类库的内容大致包括两部分,IObjectSafety接口和实现该接口的控件类。考虑所有控件类都要实现IObjectSafety接口,可以将该接口的实现抽象为一个控件基类。

一、IObjectSafety接口

为了让ActiveX控件获得客户端的信任,控件类还需要实现一个名为“IObjectSafety”的接口。先创建该接口(注意,不能修改该接口的GUID值),接口内容如下:

C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布
 1 [ComImport, Guid("CB5BDC81-93C1-11CF-8F20-00805F2CD064")]
2 [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
3 public interface IObjectSafety
4 {
5 [PreserveSig]
6 int GetInterfaceSafetyOptions(ref Guid riid, [MarshalAs(UnmanagedType.U4)] ref int pdwSupportedOptions, [MarshalAs(UnmanagedType.U4)] ref int pdwEnabledOptions);
7
8 [PreserveSig()]
9 int SetInterfaceSafetyOptions(ref Guid riid, [MarshalAs(UnmanagedType.U4)] int dwOptionSetMask, [MarshalAs(UnmanagedType.U4)] int dwEnabledOptions);
10 }
C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布

二、ActiveXControl控件基类

C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布
 1 public abstract class ActiveXControl : IObjectSafety
2 {
3 #region IObjectSafety 成员
4
5 private const string _IID_IDispatch = "{00020400-0000-0000-C000-000000000046}";
6 private const string _IID_IDispatchEx = "{a6ef9860-c720-11d0-9337-00a0c90dcaa9}";
7 private const string _IID_IPersistStorage = "{0000010A-0000-0000-C000-000000000046}";
8 private const string _IID_IPersistStream = "{00000109-0000-0000-C000-000000000046}";
9 private const string _IID_IPersistPropertyBag = "{37D84F60-42CB-11CE-8135-00AA004BB851}";
10
11 private const int INTERFACESAFE_FOR_UNTRUSTED_CALLER = 0x00000001;
12 private const int INTERFACESAFE_FOR_UNTRUSTED_DATA = 0x00000002;
13 private const int S_OK = 0;
14 private const int E_FAIL = unchecked((int)0x80004005);
15 private const int E_NOINTERFACE = unchecked((int)0x80004002);
16
17 private bool _fSafeForScripting = true;
18 private bool _fSafeForInitializing = true;
19
20
21 public int GetInterfaceSafetyOptions(ref Guid riid, ref int pdwSupportedOptions, ref int pdwEnabledOptions)
22 {
23 int Rslt = E_FAIL;
24
25 string strGUID = riid.ToString("B");
26 pdwSupportedOptions = INTERFACESAFE_FOR_UNTRUSTED_CALLER | INTERFACESAFE_FOR_UNTRUSTED_DATA;
27 switch (strGUID)
28 {
29 case _IID_IDispatch:
30 case _IID_IDispatchEx:
31 Rslt = S_OK;
32 pdwEnabledOptions = 0;
33 if (_fSafeForScripting == true)
34 pdwEnabledOptions = INTERFACESAFE_FOR_UNTRUSTED_CALLER;
35 break;
36 case _IID_IPersistStorage:
37 case _IID_IPersistStream:
38 case _IID_IPersistPropertyBag:
39 Rslt = S_OK;
40 pdwEnabledOptions = 0;
41 if (_fSafeForInitializing == true)
42 pdwEnabledOptions = INTERFACESAFE_FOR_UNTRUSTED_DATA;
43 break;
44 default:
45 Rslt = E_NOINTERFACE;
46 break;
47 }
48
49 return Rslt;
50 }
51
52 public int SetInterfaceSafetyOptions(ref Guid riid, int dwOptionSetMask, int dwEnabledOptions)
53 {
54 int Rslt = E_FAIL;
55
56 string strGUID = riid.ToString("B");
57 switch (strGUID)
58 {
59 case _IID_IDispatch:
60 case _IID_IDispatchEx:
61 if (((dwEnabledOptions & dwOptionSetMask) == INTERFACESAFE_FOR_UNTRUSTED_CALLER) &&
62 (_fSafeForScripting == true))
63 Rslt = S_OK;
64 break;
65 case _IID_IPersistStorage:
66 case _IID_IPersistStream:
67 case _IID_IPersistPropertyBag:
68 if (((dwEnabledOptions & dwOptionSetMask) == INTERFACESAFE_FOR_UNTRUSTED_DATA) &&
69 (_fSafeForInitializing == true))
70 Rslt = S_OK;
71 break;
72 default:
73 Rslt = E_NOINTERFACE;
74 break;
75 }
76
77 return Rslt;
78 }
79
80 #endregion
81 }
C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布

三、MacActiveX控件类

C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布
 1 [Guid("65D8E97F-D3E2-462A-B389-241D7C38C518")]
2 public class MacActiveX : ActiveXControl
3 {
4 public string GetMacAddress()
5 {
6 var mc = new ManagementClass("Win32_NetworkAdapterConfiguration");
7 var mos = mc.GetInstances();
8 var sb = new StringBuilder();
9
10 foreach (ManagementObject mo in mos)
11 {
12 var macAddress = mo["MacAddress"];
13
14 if (macAddress != null)
15 sb.AppendLine(macAddress.ToString());
16 }
17
18 return sb.ToString();
19 }
20 }
C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布

注意,第一行指定的Guid值即为该ActiveX控件的唯一标识,请保证其唯一性。Guid的生成有多种方法,你可以在系统目录的Program Files目录搜索一个名为guidgen.exe的工具,用该工具产生;也可以写一段测试代码,调用Guid.NewGuid()方法产生;有的Visual Studio版本也提供了快捷方式,在“工具->生成GUID”菜单下。另外,访问MAC需要添加对System.Management系统组件的引用。

到此,控件类库的开发工作就做完了,整个实现过程确实很简单。

发布

C#开发的ActiveX控件类库不像OCX那样可以直接通过regsvr32.exe注册(实际上,微软提供了替工具regasm.exe,但由于这种方式要不能实现自动升级,所以本文就不介绍了),要使控件类库运行于浏览器端,可以采取两种方式,一种是将控件类库打包为MSI安装包,然后直接在浏览器端安装;另一种是将MSI再封装为一个CAB包,这个CAB包就是一个ActiveX控件了,可以将它随应用程序一并发布,浏览器端访问包含有该控件的页面时,就会自动提示安装了。接下来就后一种发布方式进行详细讲解。

一、安装项目

在解决方案中添加一个安装项目,如图3所示:

 C# Activex开发、打包、签名、发布

3添加安装项目

右键点击新添加的安装项目,依次选择“添加->项目输出”菜单,打开添加项目输出组对话框,并选择ActiveX控件类库“CSharpActiveX”作为主输出,如图4所示:

 C# Activex开发、打包、签名、发布

4添加项目输出

双击安装项目检测到的依赖项“Microsoft .NET Framework”,打开安装项目的启动条件界面,选中“.NET Framework”项,如图5所示:

C# Activex开发、打包、签名、发布 

5安装项目启动条件

按F4快捷键,打开属性窗口,设置.NET Framework项的Version为“.NET Framework 2.0”,如图6所示:

C# Activex开发、打包、签名、发布 

6设置安装项目的依赖框架

下面这步很关键,选中“主输出来自CSharpActiveX(活动)”项,如图7所示:

C# Activex开发、打包、签名、发布 

7主输出内容项

设置主输出项内容的Register属性值为vsdrpCOM,如图8所示:

C# Activex开发、打包、签名、发布 

8设置主输出项属性

二、制作CAB包

Visual Studio 2010提供了CAB项目模板,但非常遗憾,无论我怎么设置,其生成的CAB安装包都不能在终端成功安装,最终只能放弃,转而选择了makecab.exe工具。源码提供了该打包工具,位于CAB目录下,共包含makecab.exe、cab.ddf、installer.inf和makecab.bat四个文件,其中cab.ddf和installer.inf文件需要简单说明下。

cab.ddf文件定义了CAB文件的打包行为,内容包括打包参数,打包内容项以及输出文件等。需要指出的是,使用C#开发的ActiveX控件CAB包中需要包含MSI文件和installer.inf安装文件两部分。cab.ddf文件内容如下:

C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布
.OPTION   EXPLICIT
.Set Cabinet=on
.Set Compress=on
.Set MaxDiskSize=CDROM
.Set ReservePerCabinetSize=6144
.Set DiskDirectoryTemplate="."
.Set CompressionType=MSZIP
.Set CompressionLevel=7
.Set CompressionMemory=21
.Set CabinetNameTemplate="CSharpActiveX.CAB"
"installer.inf"
"CSharpActiveX.msi"
C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布

installer.inf文件定义了CAB文件的安装行为,作为控件的一部分打入CAB包中,其内容如下:

C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布
[Setup Hooks]
hook1=hook1

[hook1]
run=msiexec /i %EXTRACT_DIR%\CSharpActiveX.msi /qn

[Version]
Signature= "$CHICAGO$"
AdvancedInf=2.0
C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布

makecab.bat文件是调用makecab.exe进行打包的批处理文件,内容如下:

makecab.exe   /f   "cab.ddf"

当生成安装项目后,将CSharpActiveX.msi文件拷贝到CAB目录下,就可以双击makecab.exe文件进行打包了,执行完成后会输出CSharpActiveX.CAB文件,这就是所谓的ActiveX控件了。

三、签名

IE采用了AuthentiCode代码签名技术,对浏览器端安装ActiveX控件行为进行了控制。上面生成的ActiveX控件如果想在浏览器端成功安装,需要对浏览器进行设置,具体操作参见部署章节。

让所有用户都对IE进行设置,显得不太友好,为此,我们可以考虑使用AuthentiCode技术对ActiveX控件进行签名。Visual Studio 2010附带的signtool.exe(以前版本的VS提供的是另一个工具signcode.exe)代码签名工具可以完成该工作(注意,并非一定要用微软提供的工具进行签名,只要按照AuthentiCode技术标准,使用 PKCS#7标准定义的数据结构生成待签名文件的数字签名,并加入到待签名文件的PE结构中即可)。但需要先准备一个PKCS#12(证书及私钥)文件(.pfx),注意,该证书的增强型密钥用法须包含代码签名这项,如图9所示:

C# Activex开发、打包、签名、发布 

9代码签名证书

本文源码提供了一份测试PKCS#12文件Apollo.pfx,PIN码为11111111。在Visual Studio命令提示(2010)中,进入源码的CAB目录,输入如下命令即可对ActiveX控件进行签名操作了:

signtool sign –f Apollo.pfx –p 11111111 CSharpActiveX.CAB

图10对比了签名前后的ActiveX控件文件属性,可以看出,签名后的ActiveX控件属性中已经多了一项数字签名,表示该文件已经过签名。

C# Activex开发、打包、签名、发布 

10签名前后的ActiveX控件属性对比

出于方便考虑,本文源码的CAB目录下提供了一份signtool.exe工具的拷贝,这样就可以将签名命令加入makecab.bat文件中,修改后的makecab.bat我将其命名为makecabsigned.bat,内容如下:

makecab.exe   /f   "cab.ddf"
signtool sign -f Apollo.pfx -p 11111111 CSharpActiveX.CAB

 

应用

ActiveX控件用于HTML静态页面,执行于IE浏览器端。需要以<object>标签的形式引入页面文件,然后使用Javascript语言调用它。测试代码如下:

C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布
 1 <html>
2 <head>
3 <title>CSharpActiveX测试</title>
4 </head>
5 <body>
6 <object id="cSharpActiveX" classid="clsid:65D8E97F-D3E2-462A-B389-241D7C38C518" codebase="CSharpActiveX.CAB#version=1,0,0" ></object>
7 <script type="text/javascript" language="javascript" defer="defer">
8 var activeX = document.getElementById("cSharpActiveX");
9 alert(activeX.GetMacAddress());
10 </script>
11 </body>
12 </html>
C# Activex开发、打包、签名、发布C# Activex开发、打包、签名、发布

注意,<object>标签的classid属性值即为MacActiveX类的Guid特性值。

部署

ActiveX控件在IE浏览器端的部署会因ActiveX控件是否签名而有所区别。下面就以此分类进行说明。当然,首先需要将test.htm和CSharpActiveX.CAB文件部署到服务器上,假设部署后的访问地址为http://192.168.1.1/test.htm。

一、部署未签名的ActiveX控件

未签名的ActiveX控件不受浏览器端信任,默认是不被允许安装的。需要先将站点添加为可信站点,具体步骤为:依次打开IE“工具->Internet选项”,在“安全”选项卡中,选中“可信站点”,如图11所示:

C# Activex开发、打包、签名、发布 

11 Internet安全选项

点击“站点”按钮,打开可信站点管理对话框,将服务器站点添加到可信站点列表中,如图12所示:

C# Activex开发、打包、签名、发布 

12可信站点对话框

回到“Internet选项”对话框,点击“自定义级别”选项卡,打开可信站点的安全设置对话框,如图13所示:

 C# Activex开发、打包、签名、发布

13可信站点安全设置对话框

确认“对未标记为可安全执行脚本的ActiveX控件初始化并执行脚本”项设置为“启用”,“下载未签名的ActiveX控件”项设置为“提示”。

IE设置完成后,访问http://192.168.1.1/test.htm测试页面(注意,Windows 7需要“以管理员身份运行”IE方可成功安装ActiveX控件),IE便会提示加载ActiveX控件,如图14所示:

C# Activex开发、打包、签名、发布 

14首次访问提示加载ActiveX控件

点击“为此计算机上的所有用户安装此加载项”,IE将弹出安全警告,确认是否要安装该ActiveX控件,如图15所示:

 C# Activex开发、打包、签名、发布

15 ActiveX控件安装安全警告

点击“安装”按钮,确认安装该ActiveX控件,待IE状态栏进度条完成,说明控件已安装完成,可以通过查看“卸载或更改程序”项来确认是否安装成功,如图16所示:

C# Activex开发、打包、签名、发布 

16确认ActiveX控件成功安装

我们可以从ActiveX控件安装过程看出,浏览器端其实是以静默安装的方式完成对CAB包中的MSI安装文件的安装(有点拗口J)。安装完成后,页面成功调用ActiveX控件,弹出接口调用结果(注意Windows 7需要重启IE,且不能用“以管理员身份运行”方式启动,否则会再次提示安装ActiveX控件,但其实控件已经成功安装了,这个问题很奇怪),效果如图17所示:

 C# Activex开发、打包、签名、发布

17成功调用ActiveX控件接口

二、部署已签名的ActiveX控件

因为IE默认允许安装并运行收信任的已签名ActiveX控件,所以通过对ActiveX控件签名,可以有效简化浏览器端的配置工作。你仅需要安装签名所用的证书及其证书链文件(本文源码提供的签名文件所含证书是自签名证书,所以它的证书链就只是它自己)。打开源码CAB目录下的Apollo.cer(与Apollo.pfx文件对应的数字证书文件)代码签名证书文件,如图18所示:

C# Activex开发、打包、签名、发布 

18签名证书文件

点击“安装证书”按钮,将该证书安装到“受信任的根证书颁发机构”,如图19所示:

C# Activex开发、打包、签名、发布 

19安装代码签名证书

打开IE的“工具->Internet选项”对话框,选择“内容”选项卡,点击“证书”按钮,打开IE证书对话框,确认在“受信任的根证书颁发机构”选项卡中包含刚才导入的代码签名证书,如图20所示:

C# Activex开发、打包、签名、发布 

20成功导入代码签名证书

此时,再访问测试页面http://192.168.1.1/test.htm,IE就会提示安装ActiveX控件了,而不再需要将站点添加到可信站点并设置IE选项了。

但是,如果用户不能接受初次安装需要导入代码签名证书及其证书链的方式,怎么办呢?从图20可以看到,Windows其实默认内置了一些权威的CA机构证书,可以向这些机构申请一份代码签名证书及私钥文件来对ActiveX控件签名,这样就可以避免该问题了。但是,向权威的CA机构申请证书是需要付费的,所以需要权衡成本和易用性后,再做出选择。

升级

要使C#编写的ActiveX控件支持自动升级,需要做四件事情,即升级ActiveX控件库版本、升级安装项目版本、设置安装项目注册表项版本和升级网页<object>版本。

一、升级ActiveX控件版本

打开ActiveX控件项目的“程序集信息”对话框,升级程序集版本和文件版本,如图21所示:

C# Activex开发、打包、签名、发布 

21升级ActiveX控件版本

二、升级安装项目版本

选中安装项目,按F4快捷键打开安装项目的属性窗口,升级安装项目的版本,如图22所示:

C# Activex开发、打包、签名、发布 

22升级安装项目版本

注意,此处还有一项关键工作要做,就是设置RemovePreviousVersions属性值为True,这样就会在升级时先自动卸载之前版本的控件。

三、设置安装项目注册表项版本

浏览器端检测ActiveX控件是否需要升级,是通过比对<object>标签的codebase属性值和本地HKEY_CLASSES_ROOT/CLSID/{GUID}/InstalledVersion键值是否相等来判断的。所以,如果要实现自动更新,需要手动添加该注册表项,并在每次升级控件时,相应更改该项键值。

右键点击安装项目,依次选择“视图->注册表”菜单,打开安装项目的注册表编辑界面,并在HKEY_CLASSES_ROOT节点下,建立CLSID/{GUID}/InstalledVersion注册表键路径,如图23所示:

C# Activex开发、打包、签名、发布 

23创建注册表键路径

右键点击InstalledVersion键节点,选择“新建->字符串值”菜单,新建一个名称为空(空名称会显示为“(默认值)”),值为当前控件版本号的键值,如图24所示:

C# Activex开发、打包、签名、发布 

24添加InstalledVersion默认键值

该步骤有几个地方需要特别说明。首先,{GUID}指的是ActiveX控件类的GUID,对应本文MacActiveX类指定的GUID,且该项需要包括左右花括号;其次,如果该安装项目用于发布多个ActiveX控件(类),需要创建多个{GUID}/InstalledVersion路径;最后,InstalledVersion的默认键值的主次版本号间是用“,”分隔,而不是“.”,后续升级时,需要同步升级该键值版本号。

四、升级网页<object>版本

最后,需要升级网页中的ActiveX对象引用版本号,如下用下划线标识部分:

<object id="csharpActiveX" classid="clsid:65D8E97F-D3E2-462A-B389-241D7C38C518" codebase="CSharpActiveX.CAB#version=1,0,1" ></object>

重新生成安装程序,打CAB包,将升级的页面及ActiveX控件(CAB包)更新到服务器。此时,浏览器端重新访问时,就会提示/自动升级ActiveX控件了。