这是文档下一个版本的Grafana。最新的稳定版本,去最新版本。
签署一个插件
Grafana需要签署所有插件以便我们能验证他们的真实性签名验证。
所有Grbob电竞频道afana Labs-authored后台插件,包括企业插件,签署。通过默认的,Grafana需要所有插件为了签署他们被加载。
签署你的插件之前,您需要决定您是否想要它作为标志公共或者一个私人插件。
让你的插件公开您的组织外,签下你的插件社区或商业签名水平。公共插件可从Grafana插件目录和任何人都可以安装。
如果你只打算使用插件在你的组织下签字私人签名水平。
生成一个API密匙
来验证你的插件的所有权,生成一个API密匙,你将使用每次你需要签署一份新的版本的插件。
确保插件ID匹配的第一部分的蛞蝓Grafana云账户。
你可以找到的插件ID
plugin.json
文件在你的插件目录。例如,如果您的帐户蛞蝓acmecorp
,你需要前缀的插件IDacmecorp -
。创建一个Grafana云API键与PluginPublisher的角色。
签署一份公共插件
公共插件需要Grafana团队复查才能签字。
提交你的插件审查。
如果我们同意你的插件,你获得插件签名的水平。你们需要的这个水平。
在你的插件目录中,您刚才创建的插件API密匙的迹象。Grafana插件创建一个标志MANIFEST.txt文件
经销
你的插件的目录:出口GRAFANA_API_KEY = < YOUR_API_KEY > npx @grafana / sign-plugin@latest
签署一份私人插件
在你的插件目录中,您刚才创建的插件API密匙的迹象。Grafana插件创建一个标志MANIFEST.txt文件
经销
你的插件的目录中。出口GRAFANA_API_KEY = < YOUR_API_KEY > npx @grafana / sign-plugin@latest——rootUrls https://example.com/grafana
后
rootUrls
国旗,为Grafana实例输入一个以逗号分隔的url,你打算安装插件。
插件签名水平
签署一个插件,您需要选择签名水平您想要签字。你的插件的签名水平决定如何分配它。
你可以你的插件在三个不同的标志签名的水平:私人,社区,商业。
插件级 | 需要付费订阅? | 描述 |
---|---|---|
私人 | 没有; 免费的 |
您可以创建并签署任何技术免费私人插件。 私有插件的目的是用于您自己的安装Grafana。它们可能不是分布式Grafana社区,和他们不是发表在《Grafana插件目录。 |
社区 | 没有; 免费的 |
标志,你可以创建和分发插件免费提供所有相关的技术都是开源的,而不是为了利益。 社区插件发表在官方Grafana目录,并可用于整个Grafana社区。 |
商业 | 是的, 商业插件需要订阅 |
标志,你可以创建和分发插件依赖技术闭源或商业支持。为此,进入商业插件订阅Grafana实验室。bob电竞频道 商业插件发布Grafana插件目录,并可用于整个Grafana社区。 |
说明签署一个插件在社区和商业签名水平下,参考签署一份公共插件。
说明签署一个插件在私人签名水平下,参考签署一份私人插件。
插件清单
Grafana验证数字签名的一个插件,该插件必须包括一个清单文件签署,MANIFEST.txt
。签署了清单文件包含两个部分:
- 签名的消息,各自包含插件元数据和插件文件校验和(SHA256)。
- 数字签名,由使用私钥加密签名的消息。Grafana内置有一个公钥,可以用来验证数字签名使用私有密匙加密的预期。
例子
——开始PGP签名的消息- - - - - -哈希:SHA512 {“manifestVersion”:“2.0.0”、“signatureType”:“社区”,“signedByOrg”:“myorgid”、“signedByOrgName”:“我的组织”,“插件”:“myorgid-simple-panel”、“版本”:“1.0.0”,“时间”:1602753404133,“keyId”:“7 e4d0c6a708866e7”、“文件”:{“许可证”:“12 ab7a0961275f5ce7a428e662279cf49bab887d12b2ff7bfde738346178c28c”,“module.js.LICENSE。txt”:“0 d8f66cd4afb566cb5b7e1540c68f43b939d3eba12ace290f18abc4f4cb53ed0”、“module.js。地图”:“8 a4ede5b5847dec1c6c30008d07bef8a049408d2b1e862841e30357f82e0fa19”、“插件。json”:“13 be5f2fd55bee787c5413b5ba6a1fae2dfe8d2df6c867dadc4657b98f821f90”、“README。md”:“2 d90145b28f22348d4f50a81695e888c68ebd4f8baec731fdf2d79c8b187a27f”、“模块。js ": " b4b6945bbf3332b08e5e1cb214a5b85c82557b292577eb58c8eb1703bc8e4577 "}} - - - - -开始PGP签名——版本:OpenPGP。js v4.10.1评论:https://openpgpjs.org wqEEARMKAAYFAl + IE3wACgkQfk0ManCIZudpdwIHTCqjVzfm7DechTa7BTbd + dNIQtwh8Tv2Q9HksgN6c6M9nbQTP0xNHwxSxHOI8EL3euz / OagzWoiIWulG 7 aqo7fyccqgucalppk3tswaefqvky + JtQhrJJui23DAZLSYQYZlKQ + nFqc9x T6scfmuhWC / TOcm83EVoCzIV3R5dOTKHqkjIUg = = = GdNq - - - - - - - - - - -端PGP签名
故障排除
为什么我得到一个“修改签名”的错误吗?
在某些情况下无效MANIFEST.txt
因为生成签名插件在Windows上时的问题。你可以通过更换所有双反斜杠,解决这个问题\ \
正斜杠,/
,在MANIFEST.txt
文件。你需要这样做每次你签署你的插件。
为什么我得到一个”字段是必需的:rootUrls
为我的公共插件”的错误吗?
与一个公共插件,插件没有插件签名水平分配给它。Grafana团队成员将分配一个签名水平你的插件一旦被检查和批准。有关更多信息,请参考签署一份公共插件。
为什么我得到一个”字段是必需的:rootUrls
“我的私人插件误差?
与一个私人插件,您需要添加一个rootUrls
国旗的插件:标志
命令。的rootUrls
必须匹配root_url配置。有关更多信息,请参考签署一份私人插件。
如果你仍然会出现这个错误,确保生成的API密匙是Grafana云帐号相匹配的第一部分插件ID。