跳到主要内容

Signature

ONLYOFFICE 文档服务器使用 令牌，这些令牌是使用 JSON Web Tokens 标准生成的。当执行客户端浏览器请求到 ONLYOFFICE 文档，或与 ONLYOFFICE 文档 之间进行 HTTP 请求 时，会发送这些令牌。

此功能从 ONLYOFFICE 文档 4.2 版本开始使用。

对于验证设置，需要编辑位于配置文件中的 secret key 和 token参数，配置文件可在以下路径找到(或创建)：

对于 Linux - /etc/onlyoffice/documentserver/local.json.

对于 Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json.

默认值存储在 default.json 配置文件中，该文件位于上述文件夹中（适用于 Linux 和 Windows）。请不要直接编辑 default.json 文件的内容。每次重启 Docker 容器或将 ONLYOFFICE 文档升级到新版本时，默认值将被恢复，您所做的所有更改将会丢失。

重新启动服务以使配置更改生效：

对于 RPM/DEB 软件包：

systemctl restart ds-*

对于 Docker:

supervisorctl restart all

参数​

参数类型示例描述
services.CoAuthoring.secret.browser.stringstringsecret定义用于在客户端浏览器请求中生成发送到 ONLYOFFICE 文档的令牌的密钥。
services.CoAuthoring.secret.inbox.stringstringsecret定义用于生成传入 HTTP 请求中的令牌的密钥，这些请求带有来自文档存储服务到文档命令服务、文档转换服务和文档生成服务的命令。
services.CoAuthoring.secret.outbox.stringstringsecret定义 密钥 用以通过文档编辑服务的在outgoing HTTP requests 到 callbackUrl* 地址中生成令牌。
services.CoAuthoring.token.enable.browserbooleanfalse定义是否启用客户端浏览器请求中的令牌。
services.CoAuthoring.token.enable.request.inboxbooleanfalse定义是否启用 传入HTTP请求中的令牌。
services.CoAuthoring.token.enable.request.outboxbooleanfalse定义传出HTTP请求 中的令牌是否已启用。

示例 local.json 配置​

{
  "services": {
    "CoAuthoring": {
      "secret": {
        "inbox": {
          "string": "secret"
        },
        "outbox": {
          "string": "secret"
        }
      },
      "token": {
        "enable": {
          "browser": true,
          "request": {
            "inbox": true,
            "outbox": true
          }
        }
      }
    }
  }
}

用于生成签名的代码示例​

下面是为初始化设置和请求生成签名的示例。它们取自不同编程语言的测试范例。我们建议您在项目中使用此代码来生成签名。

示例 C#​

public static class JwtManager
{
    private static readonly string Secret;
    public static readonly bool Enabled;

    static JwtManager()
    {
        Secret = WebConfigurationManager.AppSettings["files.docservice.secret"] ?? "";
        Enabled = !string.IsNullOrEmpty(Secret);
    }

    public static string Encode(IDictionary<string, object> payload)
    {
        var encoder = new JwtEncoder(new HMACSHA256Algorithm(),
                                        new JsonNetSerializer(),
                                        new JwtBase64UrlEncoder());
        return encoder.Encode(payload, Secret);
    }
}

示例 Java​

public static String CreateToken(Map payloadClaims)
{
    try
    {
        String secret = ConfigManager.GetProperty("files.docservice.secret");
        Signer signer = HMACSigner.newSHA256Signer(secret);
        JWT jwt = new JWT();
        for (String key : payloadClaims.keySet())
        {
            jwt.addClaim(key, payloadClaims.get(key));
        }
        return JWT.getEncoder().encode(jwt, signer);
    }
    catch (Exception e)
    {
        return "";
    }
}

示例 Node.js​

import config from "config"

const configServer = config.get("server")
const cfgSignatureSecretExpiresIn = configServer.get("token.expiresIn")
const cfgSignatureSecret = configServer.get("token.secret")
const cfgSignatureSecretAlgorithmRequest = configServer.get("token.algorithmRequest")
documentService.getToken = function getToken(data) {
  const options = {algorithm: cfgSignatureSecretAlgorithmRequest,
    expiresIn: cfgSignatureSecretExpiresIn}
  return jwt.sign(data, cfgSignatureSecret, options)
}

示例 PHP​

<?php
function jwtEncode($payload) {
    return \Firebase\JWT\JWT::encode($payload, $GLOBALS["DOC_SERV_JWT_SECRET"]);
}
?>

示例 Python​

def encode(payload):
    return jwt.encode(payload, config.DOC_SERV_JWT_SECRET, algorithm='HS256')

示例 Ruby​

@jwt_secret = Rails.configuration.jwtSecret

class << self
    def encode(payload)
        return JWT.encode payload, @jwt_secret, 'HS256'
    end
end

示例 Go​

type onlyofficeJwtManager struct {
    key []byte
}

func (j onlyofficeJwtManager) Sign(payload interface {
    Valid() error
}) (string, error) {
    token := jwt.NewWithClaims(jwt.SigningMethodHS256, payload)
    ss, err := token.SignedString(j.key)

    if err != nil {
        return "", errors.New("could not generate a new jwt")
    }

    return ss, nil
}