Linux notation 的 --oci-layout 与 notation cert 信任链配置

阿婷君_7509

阿婷君_7509

2026-02-25

161人浏览

原创

notation cert add 只支持 PEM 格式证书文件路径,不支持 OCI layout 目录;需先用 notation inspect 提取 issuer,再用对应 CA 证书执行 notation cert add --type ca --trust-store ,verify 时必须显式指定相同 --trust-store 名称。

linux notation 的 --oci-layout 与 notation cert 信任链配置

notation cert add 时提示 “OCI layout not found”

这是因为 notation cert add 默认只认本地文件系统路径,而 --oci-layout 是 notation sign 的参数,不是 cert add 的合法选项——它压根不接受 OCI layout 路径作为证书信任源。

常见错误是把签名时用的 --oci-layout 想当然套到证书管理命令上,结果命令直接报错或静默失败。

  • notation cert add 只支持添加 PEM 格式证书文件(.crt 或 .pem),路径必须指向具体文件,不能是目录
  • OCI layout 是一个带 index.json 和 blobs/ 的目录结构,notation cert 命令完全不解析它
  • 如果证书是随签名一起存进 OCI layout 的(比如用 notation sign --oci-layout 生成的),得先从 blobs/ 里手动提取证书,再单独 add

如何从 OCI layout 中提取并信任签名用的证书

OCI layout 本身不存储“可信任的证书”,它只存签名(signature.json)和签名人公钥(通常嵌在 signature 内)。要建立信任链,你得拿到签名人自己的 CA 证书(即 issuer 的 root 或 intermediate cert),而不是签名 blob 里的公钥片段。

实操分两步:先确认签名中声明的 issuer,再用该 issuer 的 PEM 证书调用 notation cert add。

  • 用 notation inspect --oci-layout 查看签名元数据,重点关注 issuer 字段(如 https://notary.example.com)和 subject
  • 根据 issuer 找到对应 CA 证书文件(比如 notary-ca.crt),确保它是 PEM 格式、无密码、且未被截断
  • 运行 notation cert add --type ca --trust-store notary notary-ca.crt;其中 notary 是自定义 trust store 名,后续 verify 必须用同一个名字

notation verify --oci-layout 失败:trusted store 名字不匹配

notation verify 不会自动查默认 trust store,它必须显式指定 --trust-store,否则即使证书已 add,也会报 no matching certificate found。

Obsidian (Linux)
Obsidian (Linux)

操作 Obsidian 库(纯 Markdown 笔记),并通过 notesmd-cli 实现自动化。

下载

这个参数名容易误解:“trust store” 不是目录路径,而是你在 cert add 时用 --trust-store 定义的逻辑名称(比如 notary),它背后对应 $HOME/.config/notation/truststore/certs/notary/ 下的文件。

  • verify 命令必须带 --trust-store ,且 与 cert add 时完全一致(大小写敏感)
  • 如果不指定 --issuer,verify 会尝试匹配签名中 issuer 字段与 trust store 中证书的 Subject 或 URI SAN,不匹配就失败
  • OCI layout 路径本身不影响信任验证逻辑,它只是告诉 verify 去哪读 index.json 和 signature.json

为什么 verify 成功但容器运行时仍报 “untrusted image”

因为 notation 的信任配置只影响 notation verify 命令本身,对 podman、nerdctl 或 containerd 无任何作用。这些运行时有自己的签名验证机制(比如 cosign 或 in-toto),不读 ~/.config/notation/。

换言之:notation 是独立的签名工具链,不是容器运行时的插件。想让运行时认可,得走对应生态的流程。

  • Podman 需要配置 /etc/containers/policy.json 并启用 cosign 插件,或用 podman image trust
  • nerdctl + containerd 目前不原生支持 notation 签名,需转换为 cosign 格式或等 upstream 支持
  • OCI layout 路径对运行时也无效——它们只认 registry 地址(如 localhost:5000/myapp:v1),不认本地目录

信任链真正起作用的地方,是 notation verify 命令执行时对签名 payload 的逐层解包和证书链校验。其他所有环节——包括你把证书文件放在哪、OCI layout 目录结构多规范、甚至 sign 时用了什么 key——都不影响 verify 是否成功,只要最终传给 verify 的 issuer 字符串能跟 trust store 里某张证书的标识对上就行。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

linux

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2195

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3482

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1176

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4019

7

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1818

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2884

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6204

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

6009

6

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

2024.03.22

7614

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习