solidtestsuite/webid-provider-tests

webid-provider-tests

镜像概述

webid-provider-tests是一个测试套件，用于对基于DPop的WebID-OIDC身份提供者进行基本的正常流程检查。该测试套件旨在验证WebID-OIDC实现是否符合规范，确保核心功能按预期工作。

核心功能

• 提供基本的"正常流程"（happy-path）测试用例
• 支持针对开发环境和生产环境的WebID-OIDC提供者进行测试
• 通过环境变量灵活配置测试参数
• 验证DPop-based WebID-OIDC认证流程的关键环节

使用场景

• WebID-OIDC身份提供者开发过程中的功能验证
• 第三方WebID-OIDC服务的兼容性测试
• 开发环境中自签名证书服务的测试验证
• 生产环境中WebID-OIDC服务的功能确认

使用方法

前提条件

确保系统已安装git和node环境。

基础设置

1. 克隆仓库并安装依赖：

sh
git clone https://github.com/solid/webid-provider-tests
cd webid-provider-tests
npm install

开发环境测试

当测试本地开发环境中的服务器（使用自签名证书，运行在localhost:443）时：

sh
NODE_TLS_REJECT_UNAUTHORIZED=0 SERVER_ROOT=https://localhost ALICE_WEBID=https://localhost/profile/card#me npm run jest

说明：NODE_TLS_REJECT_UNAUTHORIZED=0用于禁用TLS证书验证，适用于自签名证书的开发环境。

生产环境测试

针对生产环境的WebID-OIDC提供者进行测试，需通过POST请求到{SERVER}/login获取用户凭证对应的cookie：

直接指定cookie方式

sh
SERVER_ROOT=https://solid.community ALICE_WEBID=https://alice.solid.community/profile/card#me COOKIE=... npm run jest

环境变量方式

sh
export NODE_TLS_REJECT_UNAUTHORIZED=0
export SERVER_ROOT="https://localhost"
export ALICE_WEBID="https://localhost/apps/solid/@alice/turtle#me"
export COOKIE="ocwz72epe95s=366f700021bef2b4c9788e841c92959b; oc_sessionPassphrase=QbOq65GfHgCSvTW8pZRPU%2FPRwdgt5Bp9VRFJMYqRdpqCAGuc74mKc1ot1EXB10FCbWA8DbNmU7FN21iojpTyEa8BMPlgFeTc4JwAx4FbpVUnEKd5nrdGkbj1UTnX6SGl; __Host-nc_sameSiteCookielax=true; __Host-nc_sameSiteCookiestrict=true; nc_username=alice; nc_token=va79N4xcZhBeEOYHbHHMPUgF57Gc83Ks; nc_session_id=366f700021bef2b4c9788e841c92959b"
npm run jest

获取测试用Cookie

可使用辅助镜像获取服务器的测试用Cookie，具体参考：https://github.com/pdsinterop/test-suites/tree/master/servers

环境变量说明