如何在 FileMaker Server 上安装 SSL 证书

在本教程中，您将学习如何在 Claris FileMaker Server 上安装 SSL 证书。我们将介绍使用 fmsadmin 命令行方法和 Admin Console 界面两种安装方式。

注意：FileMaker 现已成为 Claris 产品（Claris International Inc.，苹果公司的子公司）。您可能仍会在软件中看到 “FileMaker” 名称；最新版本的版本号为 FileMaker Server 2024（21.x）。

在 FileMaker Server 上生成 CSR 代码

要获取由受信任证书颁发机构（CA）签发的商业 SSL 证书，您必须先生成证书签名请求（CSR），并将其发送给您的 CA 进行验证。

CSR 是一段编码文本，包含您的联系信息，如域名和公司身份信息。生成 CSR 的同时也会创建对应的私钥，您在下方的安装过程中将需要用到它。您有两种选择：

• 使用我们的CSR 生成器自动创建 CSR。
• 参照我们的分步教程如何在 FileMaker Server 上生成 CSR。

当您在服务器上创建 CSR 时，FileMaker 会在 CStore 文件夹中写入两个文件：serverRequest.pem（CSR）和 serverKey.pem（私钥）。请用纯文本编辑器（如 Notepad 或 TextEdit）打开 serverRequest.pem，复制其全部内容，并粘贴到您从 SSL 供应商订购证书时的相应输入框中。请妥善保管 serverKey.pem，您将在下一节中导入它。

CStore 文件夹的位置取决于您的操作系统：

• macOS： /Library/FileMaker Server/CStore/
• Windows： [drive]:Program FilesFileMakerFileMaker ServerCStore
• Linux： /opt/FileMaker/FileMaker Server/CStore/

在 FileMaker Server 上安装 SSL 证书

当您的 CA 将 SSL 证书发送到您的邮箱后，打开 ZIP 压缩包并将文件提取到您的设备上。根据您的 SSL 提供商不同，您应该会收到：

• 您的已签名 SSL 证书（例如，yourdomain.crt）。
• 包含根证书和中间证书的中间证书或 CA 证书包。

证书必须使用Base64（PEM）编码，且文件名不应包含星号（*）等不受支持的字符。您可以通过两种方式安装证书，请任选其一。

方法一：使用 fmsadmin 命令行导入（推荐）

命令行是最可靠的方法，在 macOS、Windows 和 Linux 上操作方式相同。请在运行 FileMaker Server 的机器上打开终端（在 Windows 上以管理员身份打开命令提示符）。

步骤 1：导入证书。 让命令指向您的已签名证书、私钥以及中间（CA 证书包）文件。请根据您的实际文件调整路径：

fmsadmin certificate import /path/to/yourdomain.crt --keyfile /path/to/serverKey.pem --intermediateCA /path/to/intermediate.crt

• –keyfile 指向随 CSR 一起创建的私钥（serverKey.pem）。只要证书不是通过本服务器上的 fmsadmin certificate create 生成的，就应包含此参数。
• –intermediateCA 指向中间证书，或者如果您的供应商提供了单一证书包文件，则指向该 CA 证书包。请始终包含中间证书，否则浏览器会报告证书链不完整。
• 如果您的私钥受密码保护，请添加 –keyfilepass 并在其后跟上密码。

对于加密私钥，命令变为：

fmsadmin certificate import /path/to/yourdomain.crt --keyfile /path/to/serverKey.pem --intermediateCA /path/to/intermediate.crt --keyfilepass yourPrivateKeyPassword

FileMaker 会将已签名证书与您的私钥合并，并在 CStore 文件夹中写入一个新的 serverCustom.pem 文件。

步骤 2：重启 FileMaker Server。 证书只有在数据库服务器重启后才会生效：

fmsadmin restart server

系统会提示您输入 Admin Console 用户名和密码。服务重启后，FileMaker Server 就会使用您的新证书并通过 HTTPS 路由连接。

方法二：使用 Admin Console（图形界面）导入

如果您更喜欢图形化操作流程，可以使用 Admin Console。首次连接到全新部署时，FileMaker Server 会提示您导入 SSL 证书；之后您也可以随时导入证书。

1. 打开 Admin Console，进入配置 > SSL 证书选项卡。
2. 点击导入自定义证书并填写相应字段：
   • 已签名证书文件：点击“浏览”并选择您的主 SSL 证书文件。
   • 私钥文件：点击“浏览”并从 CStore 文件夹中选择您的私钥（serverKey.pem）。如果您是在其他平台上生成 CSR 的，请改为上传该平台生成的私钥。
   • 中间证书文件：点击“浏览”并选择您的中间证书或 CA 证书包文件。
   • 私钥密码：如果您为私钥设置了密码，请在此处输入；否则留空。
3. 点击导入。
4. 重启 FileMaker Server以激活证书。

恭喜，您已成功在 FileMaker Server 上安装了 SSL 证书。

使用的是较旧版本？ 在 FileMaker Server 17 及更高版本中，流程是相同的：通过 Admin Console（配置 > SSL 证书）或 fmsadmin 命令行导入已签名证书、私钥和中间证书文件，然后重启。我们建议从已停止支持的版本（如 FileMaker Server 15、16 和 17）升级到当前受支持的版本，以获得安全更新和现代 TLS 支持。

测试您的 SSL 安装

在 FileMaker Server 上安装证书后，请检查新安装是否存在错误和配置弱点。使用我们的 SSL 检测工具即时扫描并生成关于您证书及其证书链状态的报告。您还可以在浏览器中打开您的 FileMaker Server 地址（例如 Admin Console 或 WebDirect 网址），确认锁形图标以及完整且受信任的证书链。

在哪里购买最适合 FileMaker Server 的 SSL 证书？

购买适用于 FileMaker Server 的 SSL 证书的最佳去处是像SSL Dragon这样的信誉良好的 SSL 供应商。我们的价格在市场上属于最低之列，但优势远不止于此：我们全线产品定期提供折扣和专属优惠，更重要的是，我们提供专属客户支持。我们所有产品都与 FileMaker Server 兼容。

SSL Dragon 悉心守护您的敏感数据安全，助力您的网站或业务在网络世界中取得成功。

您还可以使用我们的辅助工具——SSL 向导，为您的项目找到最合适的 SSL 产品。

常见问题