身份服务272 个端点

身份服务

端口 11001 · 272 个端点 · identity-service.json

API Key

方法	路径	摘要
GET	`/admin/auth/api-keys`	管理员查询 API Key 列表	详情 →
GET	`/admin/auth/api-keys/anomalies`	安全异常检测	详情 →
POST	`/admin/auth/api-keys/batch-revoke`	批量吊销 API Key	详情 →
POST	`/admin/auth/api-keys/cleanup-audit-logs`	清理旧审计日志	详情 →
GET	`/admin/auth/api-keys/expiring`	获取即将过期的 API Key	详情 →
GET	`/admin/auth/api-keys/stats`	管理员 API Key 统计	详情 →
DELETE	`/admin/auth/api-keys/{api_key_id}/force`	管理员强制吊销 API Key	详情 →
GET	`/auth/api-keys`	查询 API Key 列表	详情 →
POST	`/auth/api-keys`	创建 API Key	详情 →
DELETE	`/auth/api-keys/{api_key_id}`	吊销 API Key	详情 →
GET	`/auth/api-keys/{api_key_id}`	获取 API Key 详情	详情 →
GET	`/auth/api-keys/{api_key_id}/audit-logs`	获取 API Key 审计日志	详情 →
POST	`/auth/api-keys/{api_key_id}/ip-restrictions`	添加 IP 限制	详情 →
DELETE	`/auth/api-keys/{api_key_id}/ip-restrictions/{restriction_id}`	删除 IP 限制	详情 →
POST	`/auth/api-keys/{api_key_id}/rotate`	轮换 API Key	详情 →
PUT	`/auth/api-keys/{api_key_id}/scopes`	更新 API Key 权限范围	详情 →
PUT	`/auth/api-keys/{api_key_id}/status`	启用/禁用 API Key	详情 →
GET	`/auth/api-keys/{api_key_id}/usage`	获取 API Key 使用统计	详情 →
GET	`/auth/api-keys/{api_key_id}/usage-stats`	获取 API Key 使用统计	详情 →
POST	`/internal/identity/validate-key`	验证 API Key（内部）	详情 →

Admin/Agents

方法	路径	摘要
GET	`/admin/agents`	List Agents	详情 →
POST	`/admin/agents`	Create Agent	详情 →
DELETE	`/admin/agents/{agent_id}`	Revoke Agent	详情 →
GET	`/admin/agents/{agent_id}`	Get Agent	详情 →
PUT	`/admin/agents/{agent_id}`	Update Agent	详情 →
GET	`/admin/agents/{agent_id}/activity`	Get Agent Activity	详情 →
GET	`/admin/agents/{agent_id}/permissions`	Get Agent Permissions	详情 →

Admin/IoTs

方法	路径	摘要
GET	`/admin/iots`	List Devices	详情 →
POST	`/admin/iots`	Create Device	详情 →
DELETE	`/admin/iots/{iot_id}`	Revoke Device	详情 →
GET	`/admin/iots/{iot_id}`	Get Device	详情 →
PUT	`/admin/iots/{iot_id}`	Update Device	详情 →

Admin/Robots

方法	路径	摘要
GET	`/admin/robots`	List Robots	详情 →
POST	`/admin/robots`	Create Robot	详情 →
DELETE	`/admin/robots/{robot_id}`	Delete Robot	详情 →
GET	`/admin/robots/{robot_id}`	Get Robot	详情 →
PUT	`/admin/robots/{robot_id}`	Update Robot	详情 →
POST	`/admin/robots/{robot_id}/commission`	Commission Robot	详情 →
POST	`/admin/robots/{robot_id}/decommission`	Decommission Robot	详情 →
POST	`/admin/robots/{robot_id}/intent`	Issue Intent Token	详情 →
POST	`/admin/robots/{robot_id}/intent/revoke`	Revoke Intent Token	详情 →

IoTs

方法	路径	摘要
GET	`/iots`	List User Devices	详情 →
POST	`/iots/pair`	Pair Device	详情 →
DELETE	`/iots/{iot_id}`	Unpair Device	详情 →
GET	`/iots/{iot_id}/family-access`	List Family Members	详情 →
POST	`/iots/{iot_id}/family-access`	Add Family Member	详情 →
DELETE	`/iots/{iot_id}/family-access/{member_id}`	Remove Family Member	详情 →
POST	`/iots/{iot_id}/transfer`	Transfer Device	详情 →

NHI - 管理

方法	路径	摘要
GET	`/admin/policies/nhi`	获取NHI策略	详情 →
PUT	`/admin/policies/nhi`	更新NHI策略	详情 →

NHI Agents

方法	路径	摘要
GET	`/admin/agents/{agent_id}/credentials`	List Agent Credentials	详情 →
POST	`/admin/agents/{agent_id}/credentials`	Create Agent Credential	详情 →
DELETE	`/admin/agents/{agent_id}/credentials/{cred_id}`	Revoke Agent Credential	详情 →
GET	`/admin/agents/{agent_id}/credentials/{cred_id}`	Get Agent Credential	详情 →
POST	`/admin/agents/{agent_id}/credentials/{cred_id}/rotate`	Rotate Agent Credential	详情 →

OAuth

方法	路径	摘要
GET	`/admin/users/{user_id}/oauth-connections`	管理员查看用户OAuth连接	详情 →
POST	`/auth/oidc/backchannel-logout`	OIDC后通道登出	详情 →
POST	`/auth/oidc/logout`	RP发起登出	详情 →
GET	`/auth/oidc/session-iframe`	OIDC会话状态iframe	详情 →

RBAC - 权限

方法	路径	摘要
POST	`/auth/check-permission`	检查用户权限	详情 →
POST	`/auth/check-role`	检查用户角色	详情 →
POST	`/internal/identity/bootstrap-admin`	初始化管理员角色（内部服务调用）	详情 →
POST	`/internal/identity/check-permission`	检查用户权限（内部服务调用）	详情 →

RBAC - 角色

方法	路径	摘要
GET	`/admin/abac-policies`	查询ABAC策略列表	详情 →
POST	`/admin/abac-policies`	创建ABAC策略	详情 →
DELETE	`/admin/abac-policies/{policy_id}`	删除ABAC策略	详情 →
GET	`/admin/abac-policies/{policy_id}`	获取ABAC策略详情	详情 →
PUT	`/admin/abac-policies/{policy_id}`	更新ABAC策略	详情 →
GET	`/admin/role-activations`	查询角色激活记录	详情 →
POST	`/admin/role-activations/{role_activation_id}/revoke`	撤销角色激活	详情 →
GET	`/admin/users/{user_id}/oauth-connections`	管理员查看用户OAuth连接	详情 →
GET	`/auth/me/role-activations`	查询我的角色激活	详情 →
POST	`/auth/me/role-activations`	请求角色激活	详情 →
GET	`/auth/me/role-activations/available-roles`	查询可申请的角色	详情 →
POST	`/internal/identity/pim/cleanup-expired`	清理过期角色激活	详情 →

WebAuthn

方法	路径	摘要
GET	`/auth/me/webauthn-credentials`	获取已注册的Passkey列表	详情 →
DELETE	`/auth/me/webauthn-credentials/{credential_id}`	删除Passkey	详情 →
POST	`/auth/webauthn/authenticate/begin`	开始Passkey公开认证	详情 →
POST	`/auth/webauthn/authenticate/complete`	完成Passkey公开认证	详情 →
POST	`/auth/webauthn/login/begin`	开始Passkey登录	详情 →
POST	`/auth/webauthn/login/complete`	完成Passkey登录	详情 →
POST	`/auth/webauthn/register/begin`	开始Passkey注册	详情 →
POST	`/auth/webauthn/register/complete`	完成Passkey注册	详情 →

admin

方法	路径	摘要
GET	`/admin/ldap/health`	LDAP directory health check	详情 →
POST	`/admin/ldap/test-connection`	Test LDAP directory connection	详情 →
GET	`/admin/ldap/{name}/group-role-mapping`	Get LDAP group-role mapping	详情 →
PUT	`/admin/ldap/{name}/group-role-mapping`	Update LDAP group-role mapping	详情 →

auth

方法	路径	摘要
POST	`/auth/ldap/login`	LDAP directory authentication	详情 →

会话管理

方法	路径	摘要
GET	`/admin/users/{user_id}/devices`	管理员查询用户设备列表	详情 →
DELETE	`/auth/me/authenticator/backup`	删除全部Authenticator备份	详情 →
GET	`/auth/me/authenticator/backup`		详情 →
POST	`/auth/me/authenticator/backup`		详情 →
DELETE	`/auth/me/authenticator/backup/{backup_id}`		详情 →
GET	`/auth/me/authenticator/devices`		详情 →
DELETE	`/auth/me/authenticator/devices/{device_id}`	移除认证器设备	详情 →
POST	`/auth/qr-login/cancel`	取消二维码登录	详情 →
POST	`/auth/qr-login/confirm`	确认二维码登录	详情 →
POST	`/auth/qr-login/initiate`	发起二维码登录	详情 →
POST	`/auth/qr-login/scan`	扫描二维码登录	详情 →
GET	`/auth/qr-login/status`	查询二维码登录状态	详情 →
DELETE	`/devices`	移除所有设备	详情 →
GET	`/devices`	获取用户设备列表	详情 →
DELETE	`/devices/{device_id}`	移除设备	详情 →
PUT	`/devices/{device_id}/trust`	信任/取消信任设备	详情 →
GET	`/internal/identity/session-policy/{tenant_id}`	获取会话策略（内部服务调用）	详情 →

双人复核

方法	路径	摘要
GET	`/admin/maker-checker`	列出双人复核记录	详情 →
DELETE	`/admin/maker-checker/{record_id}`	删除双人复核记录	详情 →

多因素认证

方法	路径	摘要
POST	`/auth/mfa/send-code`	发送MFA挑战验证码	详情 →
POST	`/auth/mfa/verify-challenge`	验证MFA挑战	详情 →

安全策略

方法	路径	摘要
GET	`/admin/security/auth-config`	获取认证配置	详情 →
PUT	`/admin/security/auth-config`	更新认证配置	详情 →
GET	`/admin/security/password-policy`	获取密码策略	详情 →
PUT	`/admin/security/password-policy`	更新密码策略	详情 →
GET	`/admin/security/password-stats`	获取密码统计	详情 →
GET	`/admin/security/risk-events`	风险事件列表	详情 →
GET	`/admin/security/risk-events/aggregation`	风险事件聚合	详情 →

安全管理

方法	路径	摘要
GET	`/admin/security/risk-config`	获取风险配置	详情 →
PUT	`/admin/security/risk-config`	更新风险配置	详情 →
POST	`/admin/security/risk-config/reset`	重置风险配置	详情 →
GET	`/admin/security/risk-dashboard`	风险仪表盘	详情 →

未成年人保护

方法	路径	摘要
GET	`/admin/consents`	儿童同意记录列表	详情 →
POST	`/admin/users/{user_id}/children-consent/deny`	拒绝儿童同意	详情 →
POST	`/admin/users/{user_id}/children-consent/verify`	验证儿童同意	详情 →
PUT	`/internal/identity/users/{user_id}/age-classification`	更新用户年龄分类（内部服务调用）	详情 →

身份提供商

方法	路径	摘要
GET	`/admin/identity-providers`	列出身份提供商	详情 →
POST	`/admin/identity-providers`	创建身份提供商	详情 →
POST	`/admin/identity-providers/import-oidc-discovery`	导入OIDC Discovery	详情 →
POST	`/admin/identity-providers/import-saml-metadata`	导入SAML Metadata	详情 →
DELETE	`/admin/identity-providers/{provider_id}`	删除身份提供商	详情 →
GET	`/admin/identity-providers/{provider_id}`	获取身份提供商详情	详情 →
PUT	`/admin/identity-providers/{provider_id}`	更新身份提供商	详情 →
POST	`/admin/identity-providers/{provider_id}/activate`	启用身份提供商	详情 →
GET	`/admin/identity-providers/{provider_id}/attribute-mapping`	获取属性映射	详情 →
PUT	`/admin/identity-providers/{provider_id}/attribute-mapping`	更新属性映射	详情 →
GET	`/admin/identity-providers/{provider_id}/certificates`	列出证书	详情 →
POST	`/admin/identity-providers/{provider_id}/certificates`	上传证书	详情 →
DELETE	`/admin/identity-providers/{provider_id}/certificates/{cert_id}`	删除证书	详情 →
POST	`/admin/identity-providers/{provider_id}/certificates/{cert_id}/rotate`	证书轮转	详情 →
POST	`/admin/identity-providers/{provider_id}/deactivate`	停用身份提供商	详情 →
GET	`/admin/identity-providers/{provider_id}/jit-config`	获取JIT配置	详情 →
PUT	`/admin/identity-providers/{provider_id}/jit-config`	更新JIT配置	详情 →
GET	`/admin/identity-providers/{provider_id}/stats`	获取提供商统计	详情 →
POST	`/admin/identity-providers/{provider_id}/test`	测试身份提供商连接	详情 →
GET	`/admin/identity-providers/{provider_id}/users`	获取提供商关联用户	详情 →

身份认证

方法	路径	摘要
POST	`/admin/impersonate`	管理员模拟用户登录	详情 →
GET	`/admin/users`	查询用户列表	详情 →
POST	`/admin/users`	创建用户	详情 →
POST	`/admin/users/batch`	批量创建用户	详情 →
POST	`/admin/users/batch/status`	批量更新用户状态	详情 →
POST	`/admin/users/merge`	合并用户	详情 →
DELETE	`/admin/users/{user_id}`	删除用户	详情 →
GET	`/admin/users/{user_id}`	获取用户详情	详情 →
PUT	`/admin/users/{user_id}`	更新用户信息	详情 →
POST	`/admin/users/{user_id}/account-unlocks`	解锁账户	详情 →
GET	`/admin/users/{user_id}/identities`	获取用户身份列表	详情 →
POST	`/admin/users/{user_id}/identities`	添加用户身份	详情 →
DELETE	`/admin/users/{user_id}/identities/{identity_id}`	移除用户身份	详情 →
PUT	`/admin/users/{user_id}/identities/{identity_id}/set-primary`	设置主身份	详情 →
POST	`/admin/users/{user_id}/identities/{identity_id}/verifications`	验证用户身份	详情 →
POST	`/admin/users/{user_id}/impersonate`	管理员模拟用户	详情 →
GET	`/admin/users/{user_id}/login-histories`	获取登录历史	详情 →
GET	`/admin/users/{user_id}/passkeys`	管理员查询用户Passkey凭证	详情 →
DELETE	`/admin/users/{user_id}/passkeys/{credential_id}`	管理员撤销用户Passkey凭证	详情 →
PUT	`/admin/users/{user_id}/password`	修改密码	详情 →
POST	`/admin/users/{user_id}/password-resets`	重置密码	详情 →
GET	`/admin/users/{user_id}/password-status`	获取用户密码状态	详情 →
GET	`/admin/users/{user_id}/security-status`	获取安全状态	详情 →
PUT	`/admin/users/{user_id}/status`	更新用户状态	详情 →
POST	`/auth/anonymous`	匿名认证	详情 →
GET	`/auth/captcha/challenge`	获取CAPTCHA挑战	详情 →
POST	`/auth/forgot-password`	忘记密码	详情 →
POST	`/auth/generate-ticket`	生成一次性票据	详情 →
POST	`/auth/id-token/signin`	ID Token登录（未启用）	详情 →
POST	`/auth/login`	用户登录	详情 →
POST	`/auth/login/email-code`	邮箱验证码登录	详情 →
POST	`/auth/login/phone-code`	手机验证码登录	详情 →
POST	`/auth/logout`	退出登录	详情 →
GET	`/auth/magic-link/callback`	魔法链接回调 (GET→POST 双步跳转)	详情 →
POST	`/auth/magic-link/callback`	魔法链接回调 (GET→POST 双步跳转)	详情 →
POST	`/auth/magic-link/request`	请求发送魔法链接	详情 →
DELETE	`/auth/me`	停用当前账户	详情 →
GET	`/auth/me`	获取当前登录用户信息	详情 →
PUT	`/auth/me`	更新当前用户信息	详情 →
GET	`/auth/me/audit-logs`	获取我的审计日志	详情 →
GET	`/auth/me/children-consent`	获取儿童隐私同意状态	详情 →
DELETE	`/auth/me/consent`	撤销用户同意	详情 →
POST	`/auth/me/consent`	记录用户同意	详情 →
GET	`/auth/me/consent-history`	获取同意历史记录	详情 →
POST	`/auth/me/delete-account`	永久删除账户 (GDPR 被遗忘权/账户删除)	详情 →
GET	`/auth/me/devices`	获取我的设备列表	详情 →
DELETE	`/auth/me/devices/{device_id}`	移除设备	详情 →
PUT	`/auth/me/devices/{device_id}/trust`	信任/取消信任设备	详情 →
GET	`/auth/me/email-verification-status`	检查邮箱验证状态	详情 →
POST	`/auth/me/email/change`	变更邮箱地址	详情 →
POST	`/auth/me/email/change/cancel`	取消邮箱变更	详情 →
POST	`/auth/me/email/verify`	验证邮箱变更	详情 →
POST	`/auth/me/export-data`	导出我的数据 (GDPR DSAR)	详情 →
GET	`/auth/me/memberships`	获取我的租户成员状态	详情 →
PUT	`/auth/me/password`	修改当前用户密码	详情 →
POST	`/auth/me/password-strength`	检查密码强度	详情 →
GET	`/auth/me/permissions`	获取当前用户权限	详情 →
GET	`/auth/me/phone-verification-status`	检查手机号验证状态	详情 →
POST	`/auth/me/phone/change`	变更手机号	详情 →
POST	`/auth/me/phone/change/cancel`	取消手机号变更	详情 →
POST	`/auth/me/phone/verify`	验证手机号变更	详情 →
POST	`/auth/me/reauthenticate`	重新认证（step-up）	详情 →
GET	`/auth/me/recovery-contacts`	获取恢复联系人列表	详情 →
POST	`/auth/me/recovery-contacts`	添加恢复联系人	详情 →
DELETE	`/auth/me/recovery-contacts/{contact_id}`	移除恢复联系人	详情 →
POST	`/auth/me/recovery-contacts/{contact_id}/verify`	验证恢复联系人	详情 →
GET	`/auth/me/saml-links`	获取SAML关联账户列表	详情 →
DELETE	`/auth/me/saml-links/{link_id}`	解绑SAML关联账户	详情 →
GET	`/auth/me/security-events`	获取安全事件列表	详情 →
POST	`/auth/me/security-events/{event_id}/dismiss`	关闭安全事件提醒	详情 →
DELETE	`/auth/me/sessions`	登出所有会话	详情 →
GET	`/auth/me/sessions`	获取我的会话列表	详情 →
DELETE	`/auth/me/sessions/{session_id}`	登出指定会话	详情 →
POST	`/auth/me/stop-impersonation`	结束模拟会话	详情 →
POST	`/auth/me/switch-tenant`	切换当前租户	详情 →
GET	`/auth/me/tenants`	获取当前用户租户	详情 →
GET	`/auth/me/verification/{tracking_id}`	查询验证跟踪状态	详情 →
GET	`/auth/oauth/accounts`	获取用户OAuth账号列表	详情 →
POST	`/auth/oauth/bind`	绑定OAuth账号	详情 →
GET	`/auth/oauth/providers`	获取OAuth提供商列表	详情 →
GET	`/auth/oauth/providers/health`	获取OAuth提供者健康状态	详情 →
POST	`/auth/oauth/unbind`	解绑OAuth账号	详情 →
GET	`/auth/oauth/{provider}`	发起OAuth登录	详情 →
GET	`/auth/oauth/{provider}/callback`	OAuth回调	详情 →
POST	`/auth/re-authenticate`	重新认证（step-up）	详情 →
POST	`/auth/recover-account`	通过恢复联系人初始化账户恢复	详情 →
POST	`/auth/recover-account/reset`	通过恢复码重置密码	详情 →
POST	`/auth/recovery/complete`	完成账户恢复	详情 →
POST	`/auth/recovery/request`	发起账户恢复	详情 →
POST	`/auth/recovery/verify`	验证账户恢复码	详情 →
POST	`/auth/refresh`	刷新访问令牌	详情 →
POST	`/auth/register`	用户注册	详情 →
GET	`/auth/register/check-email`	检查邮箱是否可用	详情 →
POST	`/auth/register/check-email`	检查邮箱是否可用	详情 →
GET	`/auth/register/check-username`	检查用户名是否可用	详情 →
POST	`/auth/register/check-username`	检查用户名是否可用	详情 →
POST	`/auth/register/email-code`	邮箱验证码注册	详情 →
POST	`/auth/register/invitation`	邀请注册	详情 →
POST	`/auth/register/oauth`	OAuth补充注册	详情 →
POST	`/auth/register/phone-code`	手机验证码注册	详情 →
POST	`/auth/register/reapply`	重新申请注册	详情 →
POST	`/auth/resend-sms-code`	重新发送短信验证码	详情 →
POST	`/auth/resend-verification-email`	重新发送邮箱验证邮件	详情 →
POST	`/auth/reset-password`	重置密码	详情 →
POST	`/auth/send-sms-code`	发送短信验证码	详情 →
POST	`/auth/send-verification-email`	发送邮箱验证邮件	详情 →
POST	`/auth/ticket/signin`	票据签名登录	详情 →
POST	`/auth/verify-email`	验证邮箱地址	详情 →
POST	`/auth/verify-phone`	验证手机号	详情 →
POST	`/auth/verify-reset-code`	验证重置验证码	详情 →
POST	`/auth/web3/verify`	验证Web3钱包签名	详情 →
DELETE	`/internal/identity/erase-user/{user_id}`	内部硬删除用户	详情 →
POST	`/internal/identity/link-saml-user`	关联或创建SAML用户（内部服务调用）	详情 →
POST	`/internal/identity/maker-checker/record`	记录双人复核	详情 →
POST	`/internal/identity/record-login-failure`	记录登录失败	详情 →
POST	`/internal/identity/record-login-success`	记录登录成功	详情 →
GET	`/internal/identity/users/{user_id}`	获取用户（内部服务调用）	详情 →
PUT	`/internal/identity/users/{user_id}/status`	更新用户状态（内部服务调用）	详情 →
POST	`/internal/identity/verify-password`	验证密码	详情 →
GET	`/public/auth-config/by-domain/{domain}`	根据域名获取租户认证配置（公开）	详情 →
GET	`/public/auth-config/by-slug/{slug}`	根据租户标识获取认证配置（公开）	详情 →
GET	`/public/auth-config/{tenant_id}`	获取租户认证配置（公开）	详情 →
POST	`/public/password-strength`	检查密码强度（公开）	详情 →
GET	`/public/tenants/discover`	发现公开可加入的租户	详情 →

身份认证 - 内部接口

方法	路径	摘要
POST	`/internal/identity/tenant-rbac`	内部租户 RBAC 初始化	详情 →
POST	`/internal/identity/users`	内部创建用户	详情 →
DELETE	`/internal/identity/users/{user_id}`	内部删除用户	详情 →
POST	`/internal/identity/users/{user_id}/roles`	内部授角色	详情 →
GET	`/public/key-exchange`	ECDH 密钥交换	详情 →