开发人员(证书)
Yuno 面板中的 "开发人员"部分为集成 Yuno 服务提供安全的验证凭证(也称为密钥)。Yuno 为测试环境和实时环境维护不同的密钥,以确保强大的安全性和平稳的运行。
证书结构
Yuno 实现了双层身份验证层次结构:
-
组织机构密钥
- 主要验证层为您的总体运行提供gateway
- 授权访问与组织相关的所有账户
- 在 Yuno 注册后分配给您的组织
-
账户密钥
- 您组织内的每个账户都是独一无二的
- 可在测试和实时模式之间独立运行
- 提供细粒度访问控制
访问证书
您可以通过两种方式访问身份验证凭据:
- 账户管理:Yuno 面板的 账户管理部分包含每个帐户的凭证。点击每个账户名称,即可访问其密钥。
- 开发人员部分: 您还可以从 "开发人员"部分访问您的身份验证凭据。默认情况下打开的 "身份验证"选项卡将显示账户、组织和自定义 API 密钥。您的权限将决定哪些密钥可见。在将 Yuno 功能集成到您的应用程序或系统中时,该区域尤为重要。
定制的应用程序接口密钥
Yuno 可让您创建自定义 API 密钥,以提高安全性和控制力,确保只有经过授权的成员才能通过 API 访问数据和报告。
在 "开发人员 "部分的 "身份验证 "选项卡中,查找 "自定义 API 密钥",然后单击旁边的 "创建密钥"。在这里,你可以设置各种参数:
- 密钥名称和可以访问该密钥的成员。
- 与新密钥相关的账户。
- 密钥可访问的产品,如订阅、付款、分期付款计划等。
自定义 API 密钥的灵活性简化了访问和权限控制,可通过 Yuno 面板轻松、安全地管理 API 集成。
重要提示:API密钥显示创建自定义 API 密钥时,密钥值仅在创建过程中显示一次。请务必立即复制并安全存储该密钥,因为您将无法再次查看它。若密钥丢失或因安全原因需要轮换,可执行密钥轮换(重新生成)操作,此操作将使原有密钥失效并生成新密钥。
保护您的证书
保护身份验证凭据对维护安全运行至关重要。请遵循以下准则:
- 将凭证视为敏感信息
- 切勿与未经授权方共享凭证
- 监控凭证使用情况
安全警报如果您怀疑存在凭证暴露或未经授权的访问,请立即联系我们的支持团队。及时行动有助于维护您的操作安全。
允许的IP地址
您可以配置允许的IP地址列表,将API访问权限限制在特定IP地址或IP地址段内。此举通过确保API请求仅能来自已批准的IP地址,为系统增添了额外的安全保障层。
重要提示:IP验证若未添加任何IP地址,系统将默认不验证IP。添加新IP时请务必谨慎,此操作属于敏感变更,可能影响支付处理流程。
要配置允许的IP地址:
- 在Yuno仪表盘中导航至开发者部分。
- 转到“身份验证”选项卡。
- 点击“允许的IP列表”按钮(位于“身份验证”选项卡右上角区域)。
- 在弹出的模态窗口中,输入IP地址或IP地址范围。 输入IP地址 字段。您可以:
- 输入单个IP地址(例如:
192.168.1.1) - 使用CIDR表示法输入IP地址范围(例如:
192.168.1.0/24) - 通过逗号、分号、空格分隔或按下回车键添加多个IP地址。
- 输入单个IP地址(例如:
- 请查阅下表中允许的IP地址列表。
- 点击“保存更改”以应用配置。
配置完成后,来自未列入允许列表的IP地址的API请求将被拒绝,从而增强API集成的安全性。
IP地址管理您可以添加多个IP地址或地址段,并根据需要进行更新或删除。对允许IP列表的修改将立即生效。
网络钩子
在开发者部分的Webhooks选项卡中,您可以创建和管理Webhooks,以便接收有关您Yuno账户中事件的实时通知。
创建一个 webhook
要创建一个新的Webhook:
- 在Yuno仪表盘中导航至开发者部分。
- 点击Webhooks选项卡。
- 点击“添加 webhook”以打开 webhook 创建表单。
- 在以下表格中填写所需信息: 详情 章节:
- 名称:为您的 webhook 提供一个描述性名称。
- Endpoint :输入Yuno应发送webhook通知的目标URL地址。
- x-api-key和x-secret:设置用于 webhook 验证的身份验证凭据(可选但推荐)。
- 使用 OAuth2 认证:为 webhook 验证启用 OAuth2 认证(可选)。
- 使用 HMAC 认证:为 webhook 验证启用 HMAC 认证(可选)。
- 在 触发于 (必填),选择应触发 webhook 的事件。可用的事件类别包括:
- 注册:注册,注销
- 支付:授权、取消、扣款、退款、验证、拒付、购买
- 报告:创建、更新
- 订阅:创建、暂停、恢复、取消、完成
- 在 将此 webhook 应用于其他账户 (必填),选择应接收 webhook 通知的账户。您可以:
- 从列表中选择特定账户
- 使用“全选”功能应用于所有账户
- 使用“反选”来反转您的选择
- 选择“仅当前账户”可将 webhook 限制在当前账户范围内
- 点击添加以创建网络钩子。
管理 webhook
创建后,您可以:
- 查看 webhook 详细信息:查看 webhook 配置、endpoint 以及触发的事件。
- 编辑 webhook:更新 webhook 名称、endpoint 、身份验证凭据或触发事件。
- 测试 webhook:发送测试通知以验证 webhook 是否正常工作。
- 删除 webhook:移除不再需要的 webhook。
Webhook 安全请始终为您的 webhookendpoint 使用 HTTPS,以确保 webhook 数据的安全传输。此外,请使用提供的公钥和私有密钥验证 webhook 签名,以确保 webhook 的真实性且未被篡改。
30 天前已更新