数据来源与追溯

1. 图示
   观察依据

   导入幻灯片上标有“数据溯源”字样，并在说明段落中使用缩写“DP”。

DP

数据溯源工具或模块

软件组件名称

1. 图示
   观察依据

   幻灯片文字提到了“IPFS（星际文件系统）”。

2. 图示
   观察依据

   Swagger 页面在“ipfs 星际文件系统 API 端点”下列出了各端点。

IPFS

星际文件系统，用作去中心化存储中间件

分布式文件系统

1. 图示
   观察依据

   GET 端点显示为“/ipfs/dataset/{queryId}”，参数为“queryId * 必填字符串（路径）”。

queryId

用于标识需从 IPFS 中检索的已存储项目的路径参数

字符串

1. 图示
   观察依据

   POST 响应体中包含一个“Hash”字段。

2. 图示
   观察依据

   GET 请求 URL 在“/ipfs/dataset/”之后使用该相同值。

1. 精确的哈希字符串无法从可见帧中完全可靠地获取；仅能明确其作为返回标识符的作用。

Hash

文件上传至IPFS后返回的标识符，用于后续检索该文件

字符串

1. 公式
   观察依据

   GET 接口的路径为 `/ipfs/dataset/{queryId}`，描述为“通过哈希 ID 从 IPFS 获取一个文件”。

2. 声音
   观察依据

   说话人提到使用“相同的那个哈希 ID”，之后将其称为“最先输入的哈希”。

queryId

用作路径参数的 IPFS 哈希标识符，用于从 IPFS 检索数据集或文件。

字符串类型的路径参数；本片段中可见值为一个 IPFS 哈希，例如 `Qmbaba7vv7UC61GyZsthPtcLMntDNQMTwZzyvYmqQuPW`

1. 公式
   观察依据

   POST 响应体显示 `"newHash":"QmcA51TzAF1dwskvhXEhG7LBnqR26ampvkXsYCufFTxPdm"`。

2. 声音
   观察依据

   说话人说：“注意，我们获得了一个新的哈希。”

newHash

将原始 IPFS 哈希发送至水印处理 DP 模块接口后返回的哈希。

字符串类型；可见值为 `QmcA51TzAF1dwskvhXEhG7LBnqR26ampvkXsYCufFTxPdm`

1. 公式
   观察依据

   验证接口将 `key` 列为 `array[string] (query)`，并标记为必填项。

2. 声音
   观察依据

   说话人说：“我们输入私钥”，之后又说：“此处验证时，必须使用相同的密钥。”

1. 该片段未定义私钥除以字符串数组形式提供之外的具体语义类型。

key

用于水印验证的私钥输入，以字符串数组的形式填写在查询参数字段中。

数组字符串查询参数；可见的示例值包括 `-26, -52, 8, 60, 76, 61, -81, -13, -9, -106, -96`

1. 公式
   观察依据

   验证端点将 `alpha` 列为 `整数（查询参数）`，其 `默认值：10`；该字段被编辑为 `7`。

2. 声音
   观察依据

   主讲人解释道：如果文件包含七个网址，且希望验证全部七个网址都正确，则需将 alpha 阈值设为七。

alpha

一个整数型阈值参数，用于控制验证返回 true 所需通过的网址检查数量。

整数型查询参数；默认值显示为 10，在示例中被设为 7

1. 声音
   观察依据

   主讲人说：“如果我们的文件有七个网址，而我们希望验证其中七个全部正确……就将 alpha 阈值设为七。”

1. 数字七以口语形式说出；本片段中并未逐条列出这七个网址。

seven URLs

用作示例的数据集规模，以此说明为何将验证阈值设为最大计数值。

与该数据集/文件关联的网址数量

1. 图示
   观察依据

   Swagger UI 参数表将 `queryId` 显示为必需的 `字符串（路径）` 类型，输入字段中包含 `QmcAS1TZAF1dwsxhXEhG7LBnqR26amp;`。

queryId

用于标识待验证水印的数据集的路径参数。

字符串

1. 图示
   观察依据

   参数表将 `key` 显示为必需的 `字符串数组（查询）` 类型，可见条目为 `-26, -52, 8, 60, 76, 61, -81, -13, -9, -106, -96`。

key

携带用于验证的水印密钥的查询参数。

字符串数组；显示的值为带符号整数

1. 图示
   观察依据

   参数表将 `alpha` 显示为可选的 `整数（查询）` 类型，其值为 7。

alpha

提供给验证端点的可选整数查询参数。

整数

1. 声音
   观察依据

   演讲者表示，该工具展示了如何对个人数据进行水印处理，以验证数据所有权。

2. 图示
   观察依据

   幻灯片标题为‘数据溯源’，段落描述了对浏览类数据集等个人数据进行水印处理，同时兼顾用户对自身数据的所有权。

视频将数据溯源工具定义为一种对个人数据加水印的系统，以便后续验证其所有权。口述的开场介绍强调了所有者希望对数据进行变现、共享或在同事间传播等使用场景。

1. 适用于浏览类数据集等个人数据。

2. 该工具用于验证所有权，而非完成整个交易流程。

1. 声音
   观察依据

   演讲者指出，Comscore等公司高度重视网页浏览数据，因此用户可为其数据集添加水印，并尝试进一步实现其货币化。

2. 声音
   观察依据

   演讲者补充道，该工具将验证数据所有权，而更进一步的交易则需依赖PIMCity的其他组件。

该片段将水印技术呈现为一种实用方法，用于保留对可能具有商业价值的数据集的所有权证明。同时指出了一项限制：该工具仅能验证所有权，而更广泛的交易活动还需其他组件支持。

1. 适用于希望在未来提供占有或归属证明的数据集所有者。

2. 所有权验证与完整的交易处理相互分离。

1. 数据溯源工具的目的

1. 图示
   观察依据

   浏览器切换至一个标题为“数据溯源 API 文档”的 Swagger UI 页面。

2. 图示
   观察依据

   可见的端点分组包括“wm”、“urls”、“ipfs”和“dataset”。

该演示器是面向数据溯源服务的、基于 Swagger 的 REST API 文档页面。可见界面按功能分组展示了水印操作、URL 操作、IPFS 操作及数据集操作的端点。

1. 该页面是一个 API 文档与测试接口。

2. 端点的可用性取决于 UI 中显示的已部署服务器。

1. 数据溯源工具的目的

1. 图示
   观察依据

   展开的端点为“POST /ipfs/dataset 创建新的 IPFS 文件”。

2. 图示
   观察依据

   请求体字段为“file string(binary)”，内容类型为“multipart/form-data”。

3. 声音
   观察依据

   说话人表示：“您可以将数据集上传至 IPFS。”

演示的上传工作流使用 POST 端点 '/ipfs/dataset'。通过 multipart/form-data 请求体提交二进制文件，服务返回包含所存文件哈希标识符的响应。

1. 需在请求体中选择本地文件。

2. 响应中包含一个 'Hash' 字段，后续用于检索。

1. 演示器采用 Swagger UI 作为在线演示界面。
2. IPFS
3. Hash

1. 图示
   观察依据

   展开后的端点为 'GET /ipfs/dataset/{queryId} 通过哈希 ID 从 IPFS 获取文件'。

2. 图示
   观察依据

   参数表显示 'queryId * 必填 字符串（路径）'。

3. 声音
   观察依据

   主讲人说：'如果我们想查看内容，可以使用 get 端点来获取该内容。'

1. 从可见画面中无法完全可靠地确认输入路径中的确切哈希字符串。

上传完成后，可再次使用 GET 端点 '/ipfs/dataset/{queryId}' 获取该文件。路径参数携带上传步骤返回的标识符，响应体显示所检索到的内容。

1. 需要提供与先前已存储内容相对应的有效 'queryId'。

2. 演示的响应在响应体中返回了文件内容。

1. 将数据集文件上传至 IPFS
2. queryId
3. Hash

1. 公式
   观察依据

   可见端点 `/ipfs/dataset/{queryId}`，其描述为“通过哈希 ID 从 IPFS 获取文件”。

2. 声音
   观察依据

   主讲人表示应使用相同的哈希 ID 访问另一个端点。

该界面演示了如何使用 IPFS 哈希值作为 `queryId` 路径参数来获取数据集/文件。显示的响应包含一组 URL，主讲人将其视为文件内容或相关资源列表。

1. 必须已知该哈希 ID。

2. 该端点为 GET 请求。

3. 响应以包含 URL 的 JSON 格式呈现。

1. 公式
   观察依据

   可见端点 `/ipfs/dataset/{queryId}`，描述为“将 queryId 作为 IPFS 哈希值发送至 DP 模块中的水印功能”。

2. 声音
   观察依据

   主讲人表示，需发送 IPFS 哈希值，并借助 DP 模块的功能对内容添加水印。

一个 POST 端点接收相同的 IPFS 哈希值作为 `queryId`，并将其提交至水印模块。执行该请求后，返回一个包含元数据及 `newHash` 的 JSON 对象，表明原始哈希值已被转换为与水印相关的标识符。

1. 使用此前获取的 IPFS 哈希值作为 `queryId`。

2. 请求方法为 POST。

3. 响应中包含 `newHash` 及其他元数据字段。

1. 通过哈希 ID 从 IPFS 检索文件

1. 公式
   观察依据

   可见端点 `/dp/wm/{queryId}`，描述为“通过 IPFS 哈希值验证水印数据集”。

2. 声音
   观察依据

   说话人表示，新生成的哈希值将与另外两个参数共同用于验证该数据集确实属于我们自己。

验证步骤将新生成的哈希值用作路径参数 `queryId`，并额外要求提供一个 `key` 数组和一个整数 `alpha`。用户界面将这些显示为对 `/dp/wm/{queryId}` 发起 GET 请求时的查询参数。

1. 将水印嵌入步骤中得到的 `newHash` 用作 `queryId`。

2. 提供水印生成阶段所使用的同一私钥。

3. 根据所需的验证阈值设置 `alpha`。

1. 向水印 DP 模块发送一个 IPFS 哈希值

1. 声音
   观察依据

   说话人指出，当有七个 URL 时，要求全部七个都通过检查，即需将 alpha 阈值设为七。

2. 公式
   观察依据

   在执行前，`alpha` 字段从默认值 `10` 更改为 `7`。

在此示例中，`alpha` 表示验证返回 true 所需成功通过的 URL 检查的最少数量。若数据集包含七个 URL，且目标是确认全部七个均正确无误并属于用户，则阈值应设为七；设得更低会放宽要求，而设得高于七则无法满足。

1. 该数据集/文件被描述为包含七个 URL。

2. 预期的验证目标是：全部七个 URL 均正确且归属用户。

3. alpha 是一个整数型查询参数。

1. 水印验证端点

1. 图示
   观察依据

   页面标题为“用于数据集水印验证的 Wm 端点”，操作行显示为“GET /dp/wm/{queryId} 通过 IPFS 哈希值验证水印数据集”

视频展示了一个 Swagger UI 操作，该操作通过路径中指定的 IPFS 哈希值发起 GET 请求，以验证带水印的数据集。

1. 该界面是 `/provenancedocs` 的 Swagger UI 页面。

2. 该操作标记为 `GET /dp/wm/{queryId}`。

1. 图示
   观察依据

   参数表列出了 `queryId`（字符串，路径参数，必填）、`key`（字符串数组，查询参数，必填）和 `alpha`（整数，查询参数，可选）。

所显示的请求模式区分了一个必填的路径字符串、一个必填的查询数组，以及一个可选的整数查询参数。

1. `queryId` 是必填参数，属于路径参数。

2. `key` 是必填参数，属于查询参数。

3. `alpha` 是可选参数，属于查询参数。

1. 水印验证端点

1. 图示
   观察依据

   “服务器响应”部分显示 HTTP 状态码200，且“响应正文”中包含 `true`。

2. 声音
   观察依据

   说话人说：“这自然是对的，该数据集属于我们。”

在此示例中，成功的所有权检查由布尔值 `true` 表示，并伴随状态码200返回。

1. 该请求已被执行。

2. 服务器返回状态码200。

1. 水印验证端点

1. 声音
   观察依据

   主讲人说：“请记住，此工具仅用于验证数据所有权。若您希望进一步交易您的数据，可使用其他PIMCity组件。”

此处展示的数据溯源工具用于验证数据所有权；其本身并不处理数据的完整后续交易流程。

1. 用户所指为本视频中演示的PIMCity数据溯源组件。

针对本片段中所演示的工具。

1. 声音
   观察依据

   讲话者说：“那么，此处验证时自然必须使用相同的密钥。”

为使水印验证步骤成功，向 `/dp/wm/{queryId}` 提供的 `key` 必须与生成水印时所用的私钥相同。

1. 水印是使用一个私钥生成的。

2. 调用验证端点时传入该与水印相关的哈希值。

在所演示的工作流程中，验证时必须复用同一密钥。

1. 声音
   观察依据

   讲话者说：“超过七个在此情况下将无法奏效。”

若文件包含七个 URL，则在所述‘全部七个检查’场景中，选择大于七的 `alpha` 阈值无法实现成功验证。

1. 该数据集/文件恰好包含七个 URL。

2. 验证需统计成功通过的 URL 检查次数，并与 `alpha` 进行比对。

在七网址示例中，任何大于七的阈值都是不可行的。

1. 声音
   观察依据

   说话人说：“这自然是对的，该数据集属于我们。”

2. 图示
   观察依据

   屏幕上显示的响应正文为 `true`。

1. 该片段未定义得出此结论所依据的形式化验证算法。

当验证端点返回 `true` 时，说话人将其理解为确认该数据集归属于请求方。

1. 所展示的响应来自水印验证请求。

2. 响应体为 `true`。

针对本片段中演示的请求。

1. 声音
   观察依据

   说话人说：“通过这种方式，我们借助文件水印与所有权验证，演示了数据溯源工具。”

该片段将工作流程作为基于水印与所有权验证的数据溯源工具的演示进行呈现。

1. 所展示的 Swagger 请求是本次演示工作流程的一部分。

针对本片段中演示的工具使用方式。

1. 图示
   观察依据

   用户界面首先展开“POST /ipfs/dataset”，随后显示一个已选文件及包含“Hash”的响应内容。

2. 图示
   观察依据

   用户界面接着展开“GET /ipfs/dataset/{queryId}”，填入路径参数，执行请求，并显示所检索到的内容。

1. 具体哈希字符未能完全清晰辨识，但“上传→获取哈希→凭该标识符检索”的流程十分明确。

1. 公式

   $$$$
   解释

   在Swagger UI中打开POST端点“/ipfs/dataset”。

   步骤依据

   该端点标注为“创建新的IPFS文件”。

   视频直接表达
2. 公式

   $$$$
   解释

   在请求体字段“file string(binary)”中选择一个本地文件。

   步骤依据

   可见界面接受 multipart/form-data 格式的二进制文件。

   视频直接表达
3. 公式

   $$$$
   解释

   执行该请求并读取响应体。

   步骤依据

   成功响应包含一个带有 'Hash' 字段的 JSON 对象。

   视频直接表达
4. 公式

   $$$$
   解释

   将返回的标识符用作 GET 端点 '/ipfs/dataset/{queryId}' 中的 'queryId'。

   步骤依据

   该 GET 端点的说明指出：它通过哈希 ID 从 IPFS 检索文件。

   视频直接表达
5. 公式

   $$$$
   解释

   执行 GET 请求并检查响应体。

   步骤依据

   显示的响应体中包含所检索文件的内容，从而验证了完整的往返流程。

   视频直接表达

本片段演示了一个具体的两步 API 工作流：先上传数据集以获取 IPFS 哈希标识符，再利用该标识符检索已存储的内容。

1. 动画
   观察依据

   屏幕从 GET IPFS 响应滚动到 POST 水印添加端点，执行该请求，然后滚动至验证端点并填写其参数。

2. 声音
   观察依据

   讲解词明确串联了各步骤：使用相同的哈希 ID，将其发送至水印添加模块，获得一个新的哈希，再用另外两个参数进行验证。

1. 公式

   $$$$
   解释

   从已获取的 IPFS 数据集响应出发，其中原始哈希 ID 已通过 GET 请求获知。

   步骤依据

   演示完 GET 响应后，讲解者指出要使用“那个相同的哈希 ID”。

   视频直接表达
2. 公式

   $$$$
   解释

   调用 POST 端点 `/ipfs/dataset/{queryId}`，将原始 IPFS 哈希作为 `queryId` 发送给水印添加差分隐私模块。

   步骤依据

   端点说明及实际执行的请求均清晰显示，原始哈希被用作 `queryId`。

   视频直接表达
3. 公式

   $$newHash = QmcA51TzAF1dwskvhXEhG7LBnqR26ampvkXsYCufFTxPdm$$
   解释

   读取响应体，并识别返回的 `newHash` 值。

   步骤依据

   响应 JSON 明确包含 `"newHash":"QmcA51TzAF1dwskvhXEhG7LBnqR26ampvkXsYCufFTxPdm"`。

   视频直接表达
4. 公式

   $$$$
   解释

   切换至验证端点 `/dp/wm/{queryId}`，并将 `newHash` 用作路径中的 `queryId`。

   步骤依据

   讲解者指出新哈希将用于验证该数据集，且界面显示验证端点接受 `queryId` 参数。

   视频直接表达
5. 公式

   $$key = [-26, -52, 8, 60, 76, 61, -81, -13, -9, -106, -96], \quad alpha = 7$$
   解释

   提供私钥数组，并将阈值设为七，以对应七个 URL 的示例。

   步骤依据

   这些值在执行前输入到可见的参数字段中。

   视频直接表达

所演示的流程串联了三个 API 操作：先通过 IPFS 哈希检索内容，再将该哈希提交至水印服务以获取 `newHash`，最后使用 `newHash`、相同的私钥 `key` 以及适当的 `alpha` 阈值验证所有权。

1. 图示
   观察依据

   `Curl` 代码块显示：`curl -X GET "https://easypims.pimcity-h2020.eu/provenance/dp/wm/QmcAS1TZAF1dwsxhXEhG7LBnqR26amp;?key=-26&key=-52&key=8&key=60&key=76&key=61&key=-81&key=-13&key=-9&key=-106&key=-96&alpha=7" -H "accept: application/json"`。

2. 图示
   观察依据

   `请求 URL` 代码块以相同 URL 形式重复呈现，但不包含 `curl` 封装。

1. 片段中未解释每个重复出现的 `key` 参数项的具体内部含义。

1. 公式

   $$/dp/wm/{queryId}$$
   解释

   端点模板将数据集标识符置于路径中。

   步骤依据

   在 Swagger 操作标题中可见：`GET /dp/wm/{queryId}`。

   视频直接表达
2. 公式

   $$https://easypims.pimcity-h2020.eu/provenance/dp/wm/QmcAS1TZAF1dwsxhXEhG7LBnqR26amp;$$
   解释

   基础服务器 URL 和具体的 `queryId` 值将替换路径模板。

   步骤依据

   显示在自动生成的 `Curl` 和 `Request URL` 区块中。

   视频直接表达
3. 解释

   数组参数通过为每个元素重复 `key=` 进行序列化，可选整数则以 `alpha=7` 的形式追加。

   步骤依据

   直接显示在自动生成的请求字符串中。

   视频直接表达

用户界面将输入的参数转换为一个单一的 GET 请求 URL，其中包含重复的 `key` 查询字段和一个 `alpha` 查询字段。

1. 图示
   观察依据

   在上传表单中选中了一个名为 'sample_urls_seven.txt' 的文件。

2. 图示
   观察依据

   POST 响应体显示一个 JSON 对象，其中包含 'Name': 'sample_urls_seven.txt' 及一个 'Hash' 字段。

3. 图示
   观察依据

   GET 响应体中显示了所检索文件中的多行 URL。

1. 从可见画面中无法完全可靠地确认确切的哈希字符串。

2. 部分检索到的 URL 行在不同帧中存在遮挡或清晰度不一致的问题。

展示如何将本地数据集文件上传至 IPFS，再通过数据溯源 API 进行检索。

1. 一个名为 'sample_urls_seven.txt' 的本地文本文件已就绪。

2. Swagger UI 提供了 POST '/ipfs/dataset' 和 GET '/ipfs/dataset/{queryId}' 两个接口。

上传该文件，获取其哈希标识符，并检索已存储的内容。

1. 公式

   $$$$
   解释

   展开 POST '/ipfs/dataset' 接口，并选择文件 'sample_urls_seven.txt'。

   步骤依据

   请求体要求传入二进制文件。

   视频直接表达
2. 公式

   $$$$
   解释

   执行上传请求。

   步骤依据

   此举将所选文件发送至服务器。

   视频直接表达
3. 公式

   $$$$
   解释

   读取响应体以获取返回的 'Hash' 值。

   步骤依据

   成功的 POST 响应中包含已存储文件的标识符。

   视频直接表达
4. 公式

   $$$$
   解释

   展开 GET 请求 '/ipfs/dataset/{queryId}'，并将返回的标识符填入 'queryId'。

   步骤依据

   该 GET 接口通过哈希 ID 从 IPFS 检索文件。

   视频直接表达
5. 公式

   $$$$
   解释

   执行该 GET 请求，并检查响应体。

   步骤依据

   响应体显示所检索到的文本内容，包括若干 URL 行。

   视频直接表达

文件成功上传后，再通过其哈希标识符被检出，由此通过 API 展示了具备所有权保留特性的存储访问机制。

在上传步骤返回匹配标识符后，检出的响应体中清晰可见该文件的内容。

1. 声音
   观察依据

   讲话者描述了一个包含七个 URL 的文件，并指出应将 alpha 阈值设为七，以实现七选七的验证。

2. 公式
   观察依据

   验证表单中显示 `alpha` 已更改为 `7`，并点击了执行按钮。

1. 最终的验证响应未在所提供的 120 秒片段中显示。

给定一个包含七个 URL 的数据集或文件，请配置验证请求，使得验证成功意味着全部七个 URL 均被正确检查且均属于该用户。

1. 水印步骤生成了 `newHash` = `QmcA51TzAF1dwskvhXEhG7LBnqR26ampvkXsYCufFTxPdm`。

2. 验证端点为 `/dp/wm/{queryId}`。

3. 私钥以字符串数组形式输入。

4. 该文件明确包含七个 URL。

选择所需的参数值，以验证七个URL全部正确。

1. 公式

   $$queryId = QmcA51TzAF1dwskvhXEhG7LBnqR26ampvkXsYCufFTxPdm$$
   解释

   将水印响应中的 `newHash` 用作验证路径参数。

   步骤依据

   讲话者表示，新哈希值将用于验证数据集。

   视频直接表达
2. 公式

   $$key = [-26, -52, 8, 60, 76, 61, -81, -13, -9, -106, -96]$$
   解释

   输入用于生成水印的同一私钥。

   步骤依据

   旁白指出，验证必须使用相同的密钥。

   视频直接表达
3. 公式

   $$alpha = 7$$
   解释

   当要求全部七个URL均通过时，将阈值设为URL总数。

   步骤依据

   讲话者明确指出，对于七个URL全部通过的情况，应将 alpha 阈值设为七。

   视频直接表达
4. 公式

   $$$$
   解释

   执行 GET 验证请求。

   步骤依据

   光标在视频片段结束时点击“Execute”。

   视频直接表达

所配置的验证请求使用 `queryId` 等于返回的 `newHash`、所列的私钥数组，以及 `alpha = 7`。

预期结果被口头表述为：若全部七个URL均正确且属于该用户，则结果为 true；但在视频片段结束前，实际响应体内容不可见。

1. 图示
   观察依据

   响应区域显示 `Code 200` 和 `Response body true`。

2. 声音
   观察依据

   讲解者说：“响应体为 true。这自然正确，该数据集属于我们。”

对所展示的数据集执行水印验证请求，并检查服务器响应。

1. 查询ID = QmcAS1TZAF1dwsxhXEhG7LBnqR26amp;

2. 键 = [-26, -52, 8, 60, 76, 61, -81, -13, -9, -106, -96]

3. α 等于7

4. HTTP 方法 `GET`

确定验证端点返回的响应正文。

1. 解释

   请求使用根据表单输入构建的显示 URL 发送。

   步骤依据

   在 `Curl` 和 `请求 URL` 面板中可见。

   视频直接表达
2. 公式

   $$200$$
   解释

   服务器返回 HTTP 状态码 200。

   步骤依据

   显示在 `服务器响应` 下方。

   视频直接表达
3. 公式

   $$true$$
   解释

   响应正文为布尔值 `true`。

   步骤依据

   在 `响应正文` 面板中显示，并由讲解者朗读。

   视频直接表达

示例请求返回状态 200，响应正文为 `true`。

讲解者明确指出结果正确，因为该数据集属于用户本人。

1. 图示
   观察依据

   一张静态幻灯片持续显示，标题为 'PIMCity 演示'，副标题为 '构建下一代个人数据平台'，章节标题为 '数据溯源'。

2. 图示
   观察依据

   左侧显示一个绿色指纹图标，标注为 '数据溯源'；右侧为说明性文字及三列内容：'访问数据平台用户界面'、'源代码' 和 '许可证'。

1. 标题横幅

2. 指纹图标

3. 说明性段落

4. 三个信息栏

1. 此时间段内未发生任何视觉变化。

1. 幻灯片内容保持固定，同时旁白讲解该工具的用途。

视觉部分作为静态概览卡片呈现，而音频则提供关于数据溯源与水印技术的概念性阐释。

1. 图示
   观察依据

   浏览器从幻灯片跳转至标题为“数据溯源 API 文档”的 Swagger UI 页面。

2. 图示
   观察依据

   随着页面加载与滚动，端点分组“wm”、“urls”、“ipfs”和“dataset”依次显现。

1. 浏览器标签页

2. Swagger 页眉

3. 端点分组

1. 幻灯片被 API 文档页面所取代。

2. 视图滚动以展示端点分类。

1. 该页面始终是一个 API 文档界面。

这一视觉变化标志着从概念讲解转向操作演示。

1. 图示
   观察依据

   “POST /ipfs/dataset”行被展开。

2. 图示
   观察依据

   文件选择器打开，并选中了“sample_urls_seven.txt”。

3. 图示
   观察依据

   点击执行按钮，随后出现一个响应面板，其 JSON 正文中包含“Hash”。

1. 从可见帧中无法完全可靠地读取确切的哈希字符。

1. POST 端点面板

2. 文件输入

3. 执行按钮

4. 响应正文

1. 该端点被展开。

2. 选择一个本地文件。

3. 执行该请求。

4. 响应中显示一个哈希标识符。

1. 界面保持在 ipfs 端点组内。

类似动画的用户界面状态变化，展示了存储工作流的前半部分：将本地文件转换为一个由 IPFS 寻址的对象。

1. 图示
   观察依据

   展开 'GET /ipfs/dataset/{queryId}' 端点。

2. 图示
   观察依据

   在 'queryId' 字段中填入此前获得的标识符。

3. 图示
   观察依据

   执行后，响应体中显示了检索到的文本行，其中包括 URL。

1. 部分检索到的 URL 行在各帧中呈现为部分遮挡或可读性不一致。

1. GET 端点面板

2. queryId 输入框

3. 执行按钮

4. 响应正文

1. GET 端点展开。

2. 输入标识符。

3. 执行请求。

4. 检索到的文件内容显示在响应中。

1. 该操作始终位于 ipfs 端点组内。

此可视化序列展示了工作流的后半部分：利用已存储的标识符恢复原始数据集内容。

1. 动画
   观察依据

   浏览器视图滚动展示 Swagger UI 的各个部分，依次为 IPFS 端点和水印 POST 端点。

1. Swagger UI 页面

2. GET `/ipfs/dataset/{queryId}` 章节

3. POST `/ipfs/dataset/{queryId}` 章节

4. 端点描述

1. 视图从已完成的 GET 响应切换至 IPFS 端点列表。

2. 选中并展开 POST 水印端点。

1. 同一基础 API 文档页面持续显示在屏幕上。

2. 端点名称与描述在滚动过程中始终保持可见。

视觉顺序明确了操作流程：先通过哈希值检索，再将该哈希值发送至水印模块。

1. 动画
   观察依据

   点击 POST 端点的“执行”按钮后，响应面板出现，其中包含含 `newHash` 字段的 JSON。

1. POST 请求面板

2. 响应体 JSON

3. `newHash` 字段

1. 执行后，响应区域自动填充内容。

2. `newHash` 字符串随之显示，并由讲解者通过口述强调。

1. 请求 URL 的路径参数中仍保留原始的 IPFS 哈希值。

该事件表明，水印嵌入步骤将原始 IPFS 哈希值转换为下游使用的全新标识符。

1. 动画
   观察依据

   验证端点被打开，字段 `queryId`、`key` 和 `alpha` 已填写；点击“执行”前，`alpha` 从10变为7。

1. GET `/dp/wm/{queryId}` 表单

2. `queryId` 输入框

3. `key` 数组输入框

4. α 为整数输入

5. 执行按钮

1. queryId 被粘贴为 newHash 的值。

2. key 被填充为一个由负整数和正整数字符串组成的列表。

3. α 从默认值10编辑为7。

4. 最后按下执行按钮。

1. 在整个表单填写过程中，端点始终为 /dp/wm/{queryId}。

动画展示了验证所需的具象输入结构，以及与七网址示例关联的阈值选择。

1. 图示
   观察依据

   屏幕滚动至 Swagger 操作的下半部分，显示 `Curl`、`请求 URL`、`服务器响应`、`响应正文` 和 `响应头`。

1. “Curl”代码块

2. “请求URL”代码块

3. “服务器响应”区域

4. “响应正文”面板

5. “响应头”面板

1. 当显示的响应值保持为 `true` 时，鼠标光标移至响应区域附近。

1. 状态码保持为200。

2. 响应正文保持为 `true`。

该视图记录的是已执行验证请求的结果，而非输入表单本身。

1. 动画
   观察依据

   页面从响应区域向上滚动至参数表单。

2. 图示
   观察依据

   “参数”表格完整显示，包含 `queryId`、`key` 和 `alpha`。

1. Swagger 操作标题

2. “参数”表格

3. 用于 `queryId`、`key` 和 `alpha` 的输入字段

1. 视口向上移动。

2. 请求输入取代响应面板，成为主要焦点。

1. 同一端点 `/dp/wm/{queryId}` 保持打开状态。

2. 先前输入的值仍可见。

视觉过渡将返回的结果与生成该结果的确切输入关联起来。

1. 动画
   观察依据

   页面再次向下滚动，光标悬停在“下载”按钮上，随后视图向上滚动至页面标题处。

2. 图示
   观察依据

   标题区域显示为“Swagger”、“Data Provenance API Docs”、“alpha0.3”、“OAS3”以及“Sample REST API documentation”。

3. 声音
   观察依据

   说话人说：“如果需要，我们还可以直接从 Swagger API 工具下载该文件。谢谢。”

1. 将鼠标悬停在“下载”按钮上后，不会显示任何实际下载文件的内容。

1. “下载”按钮

2. 页面标题横幅

3. 服务器选择器

1. 视口向下移动至响应控制区。

2. 光标指向“下载”。

3. 视口向上移动至文档页眉。

1. 同一份 API 文档页面保持在视图中。

2. 服务器 URL 保持为 `https://easypims.pimcity-h2020.eu/provenance`。

结尾强调 Swagger 界面也可用于检索该文件，随后通过展示整体 API 文档上下文结束。

1. 声音
   观察依据

   讲话者明确指出，该工具‘仅会验证数据所有权’，而‘进一步交易您的数据’则需借助 PIMCity 的其他组件。

人们可能误以为所演示的数据溯源工具本身即可完成整个数据市场交易。

视频指出，该组件仅负责验证所有权；更广泛的数据交易需依赖 PIMCity 的其他组件。

1. 声音
   观察依据

   说话人说：“注意，目前我们出于隐私原因不记录私钥……您必须向我们提供私钥，否则我们将即时为您生成一个。”

人们可能认为水印服务会保留私钥以供后续自动验证。

视频明确指出，出于隐私原因私钥不会被记录；用户必须再次提供相同的密钥，否则系统可能在创建水印时即时生成一个。

1. 声音
   观察依据

   主讲人指出，α 可设为小于或等于七，而大于七在此情况下将无法奏效。

将 α 设为超过 URL 数量的值看似更安全，但却可能导致验证无法进行。

对于包含七个 URL 的文件，在‘全部七个检查’场景中，最大有意义的阈值为七；超过七的值无法被满足。

1. 声音
   观察依据

   旁白仅将工作流程概括为水印添加与验证。

2. 图示
   观察依据

   屏幕上显示了API的输入和输出，但未展示内部验证公式或证明。

观众可能从该片段推断出底层水印验证的数学过程已完整呈现。

视频仅演示了请求参数、生成的URL以及布尔型响应；并未呈现验证算法、证明或误差模型。

1. 声音
   观察依据

   旁白在画面切换至演示者之前，先介绍了该工具的用途。

2. 图示
   观察依据

   幻灯片切换为 Swagger API 页面。

水印嵌入与权属验证这一抽象目标，通过具体的 Swagger API 界面得以实现。

1. 图示
   观察依据

   POST 响应提供一个“Hash”，该值随后被用作 GET 请求路径参数。

依据标识符进行检索，依赖于此前已成功上传并生成该标识符的操作。

1. 图示
   观察依据

   同一标识符既出现在 POST 响应中，也出现在 GET 请求的 URL 中。

1. 从可见帧中无法完全可靠地识别哈希值的全部字符。

在所演示的工作流中，返回的哈希值即作为 queryId，用于检索已存储的文件。

1. 声音
   观察依据

   主讲人表示应使用相同的哈希 ID 跳转至新端点。

2. 动画
   观察依据

   用户界面从 GET 响应跳转至 POST 水印端点。

在检索步骤中获取或使用的 IPFS 哈希值，将直接复用为水印 POST 端点的输入。

1. 公式
   观察依据

   POST 响应中包含 `newHash`。

2. 声音
   观察依据

   主讲人表示，该新哈希值将有助于验证数据集。

水印步骤生成的 `newHash` 将作为验证端点的 `queryId`。

1. 声音
   观察依据

   主讲人将七个 URL 的示例与将 `alpha` 设为七关联起来。

阈值规则是所演示工作流中验证端点配置方式的一部分。

1. 图示
   观察依据

   操作标题 `GET /dp/wm/{queryId}` 后直接跟有参数表，其中列出了 `queryId`、`key` 和 `alpha`。

端点定义包含了发起验证请求所需的参数模式。

1. 图示
   观察依据

   生成的 `Curl` 命令和 `Request URL` 中所含数值，与后续参数表中显示的数值一致。

2. 图示
   观察依据

   响应部分显示了 `200` 和 `true`。

所显示的参数值被应用于验证端点，从而得出所示的布尔型结果。

1. 声音
   观察依据

   讲解者将 `响应体为 true` 与 `该数据集属于我们` 关联起来。

所有权解释依赖于验证调用所观察到的布尔型响应。

1. 声音
   观察依据

   开场旁白说明了该工具的用途。

2. 图示
   观察依据

   幻灯片标题与正文定义了数据溯源（Data Provenance）。

1. 数据溯源工具的目的

1. 声音
   观察依据

   主讲人探讨了浏览数据集的变现、共享及权属验证。

1. 面向所有权验证与货币化场景的数据水印
2. 将所有权验证与完整的数据交易混淆

1. 图示
   观察依据

   POST '/ipfs/dataset' 面板及文件选择界面可见。

1. 将数据集文件上传至 IPFS

1. 图示
   观察依据

   GET '/ipfs/dataset/{queryId}' 面板及响应体可见。

1. 通过哈希标识符检索已存储的内容
2. 所演示的上传与检索工作流

1. 声音
   观察依据

   演讲者将该工具的功能限定于所有权验证。

1. 所演示工具的作用范围限制
2. 将所有权验证与完整的数据交易混淆

1. 公式
   观察依据

   端点文字“通过哈希 ID 从 IPFS 获取文件”可见。

1. 通过哈希 ID 从 IPFS 检索文件
2. queryId

1. 公式
   观察依据

   响应体在 POST 请求后显示 `newHash`。

1. 向水印 DP 模块发送一个 IPFS 哈希值
2. newHash

1. 声音
   观察依据

   讲话者指出，验证必须使用相同的密钥。

1. 水印验证端点
2. 验证需要使用与添加水印时相同的私钥
3. key

1. 声音
   观察依据

   讲话者解释将 alpha 阈值设为七，以对应七个 URL。

1. URL 验证中 alpha 的阈值规则
2. alpha
3. 七个 URL 的水印验证设置

1. 图示
   观察依据

   参数表将 `queryId` 标注为 `string (path)`，并显示了一个类似IPFS的可见值。

1. queryId
2. 水印验证端点
3. 端点参数模式

1. 图示
   观察依据

   生成的 URL 对每个数组元素都重复出现 `key=`。

1. key
2. 从表单参数到请求 URL

1. 声音
   观察依据

   说话人称响应体为 true，且该数据集属于他们。

1. 验证成功的输出
2. 对布尔型响应的解释