# Auth.md


> Veri5的代理注册元数据。AI 代理和自动化客户端可使用本文档了解如何注册、认证和与Veri5交互。


## Agent Registration / 代理注册


AI 代理可通过 `/.well-known/oauth-authorization-server` 处的 OAuth 授权服务器以编程方式注册访问Veri5服务。


### Registration / 注册方式


联系运营方 [ryder@hefes.net](mailto:ryder@hefes.net) 以注册您的客户端/代理并获取凭证。




### Identity Types / 身份类型


- **OAuth Client** — 适用于服务端到服务端和自动化代理访问
- **did:web** — 基于域名所有权的去中心化标识符
- **did:key** — 基于公钥的去中心化标识符





### Credential Types / 凭证类型


- `client_secret_basic` — 使用客户端 ID 和密钥的 HTTP Basic 认证
- `client_secret_post` — POST 请求体中的客户端 ID 和密钥
- `urn:ietf:params:oauth:client-assertion-type:jwt-bearer` — JWT bearer 断言





### Supported Grants / 支持的授权类型


| 授权类型 | 使用场景 |
|---|---|
| `authorization_code` | 用户交互流程（网页、移动端） |
| `client_credentials` | 服务端到服务端 / 代理到代理 |


### Scopes / 作用域


| 作用域 | 访问权限 |
|---|---|
| `veri5:read` | 读取区块链状态（区块、交易、账户） |
| `veri5:write` | 提交交易并与链交互 |
| `veri5:admin` | 管理操作 |
















## Agent Discovery / 代理发现


### Well-Known Discovery


| 路径 | 描述 |
|---|---|
| `/.well-known/mcp/server-card.json` | MCP 服务器卡片 |
| `/.well-known/api-catalog` | API 服务目录 |
| `/.well-known/openid-configuration` | OpenID Connect 发现 |
| `/.well-known/oauth-authorization-server` | OAuth/OIDC 提供者元数据 |
| `/.well-known/oauth-protected-resource` | 受保护资源元数据 |
| `/.well-known/agent-skills/index.json` | 代理技能索引 |
| `/.well-known/jwks.json` | JWKS 公钥 |
| `/auth.md` | 本文档 — 代理注册说明 |



## 联系方式 / Auto-Discovery


代理注册咨询：

| 方式 | 联系方式 |
|------|----------|
| **邮箱** | [ryder@hefes.net](mailto:ryder@hefes.net) |
| **Telegram** | [@hefes838](https://t.me/hefes838) |
| **运营方** | [赫菲有限责任公司（Hefes LLC）](https://hefes.net) |

运营方将在 1 个工作日内回复。







## Agent Discovery


### Well-Known Discovery


| Path | Description |
|---|---|
| `/.well-known/mcp/server-card.json` | MCP server card |
| `/.well-known/api-catalog` | API service catalog |
| `/.well-known/openid-configuration` | OpenID Connect discovery |
| `/.well-known/oauth-authorization-server` | OAuth/OIDC provider metadata |
| `/.well-known/oauth-protected-resource` | Protected resource metadata |
| `/.well-known/agent-skills/index.json` | Agent skills index |
| `/.well-known/jwks.json` | JWKS public keys |
| `/auth.md` | This file — agent registration docs |



## Contact / Auto-Discovery


For agent registration inquiries:

| Method | Contact |
|--------|---------|
| **Email** | [ryder@hefes.net](mailto:ryder@hefes.net) |
| **Telegram** | [@hefes838](https://t.me/hefes838) |
| **Organization** | [Hefes LLC](https://hefes.net) |

Operators respond within 1 business day.