安装

活字格安全提供程序是一个类似插件的C#程序集，需要您在运行时上传到活字格服务器中。因此，如果想要集成您的系统用户数据，就需要您编写代码来实现，并且最终安装到活字格服务器中。

通过本节文档，您可以了解到如何从零开始初始化一个安全系统程序集。

如何从零开始初始化一个安全系统程序

活字格安全提供程序是一个 C# 程序集，当您想要开发之前，可以先从葡萄城的 官方Gitee 下载一个安全提供程序的构建工具。

下载并解压产物后，您将会看到安全提供程序构建工具主要由两个文件夹构成：

其中，“bin” 目录下是安全提供程序构建工具的主要核心程序。“ForguncyTemplateSecurityProvider” 目录下主要用于存放默认的构建模板。

“ForguncyTemplateSecurityProvider” 目录下的内容无需您修改，您可以直接打开 “bin” 目录下的 “ForguncySecurityProviderCreator.exe” 运行构建工具：

构建时，您需要输入如下三个参数：

安全提供程序的名称

如“DingTalk”，当您输入名称后，工具会自动帮您生成一个名为**“DingTalkSecurityProvider”**的程序集，内部的 class 名称、命名空间等都会为“DingTalkSecurityProvider”。

因此，名称非常重要，同时也建议您最好起英文名称。

活字格设计器安装路径

提供该路径的目的是为了加载安全提供程序的引用依赖项，构建后的安全提供程序集内的 dll 引用都需要从此目录加载。

因此如果您没有安装活字格设计器，请先 下载安装 活字格设计器。

保存安全提供程序至文件夹

这里需要填写您想要创建的目标文件夹，比如“D:\”，当您选择“D:\”后，工具会为您在“D:\DingTalk”目录下创建安全提供程序解决方案。

如上正确填写了参数后，单击“确定”按钮，即会在目标位置 比如“D:\DingTalk” 下初始化安全提供程序：

您可以使用您常用的开发工具（如：VS、Rider、VsCode）打开此工程，本示例中将使用 Rider 进行演示：

程序集主要由三个文件组成：

1. DependenceVersion.json：活字格依赖版本，此文件由您上一步选择的活字格设计器的版本确定，您无需修改，最终会在 AdminPortal 中进行展示。

2. DingTalkSecurityProvider.cs：安全提供程序代码，是您需要实现的部分。

3. LICENSE.txt：License文件，您无需修改。

至此，您已经成功初始化安装了活字格安全提供程序，之后您就可以根据自己的需求，来实现 ISecurityProvider 接口提供第三方用户程序了。

下一节

此章节仅是为您展示如何初始化安装一个活字格安全提供程序集，之后，您就可以正式进入安全提供程序的开发了。

在下一节，您将了解到安全提供程序的主要概念，包括安全提供程序目前所支持的类型、主要数据结构介绍、常见的安全提供程序的实现等，为您全方位的介绍安全提供程序的开发流程。