服务帐户

软件的身份——集成、计划导出、支持台——像人一样承担各种角色，从不登录控制台，也从不被要求执行第二步操作。

双重验证登录对每个人都适用，但对所有脚本来说都不适用：程序需要输入密码才能登录，但系统会要求它输入一个它无法输入的验证码。服务帐户是软件使用的身份标识。它拥有与个人完全相同的角色和公司，因此所有屏幕权限、组织单元限制和职责规则都适用于它——但它没有任何人知道的密码，登录表单会拒绝它，并且它无法使用控制台的个人或交互式部分（首选项、个性化设置、仪表板、助手、双重验证设置、系统控制台）。

1. 打开平台 → 访问与安全 → 访问 → 服务账号（在用户旁边），然后选择新建服务账号。
2. 给它一个地址，说明它的用途（nightly-export@service.yourcompany），一个名称，以及一句描述它功能的句子。
3. 勾选它的角色。赋予它最能胜任工作的角色：例如，一个只能显示采购订单的角色，就是一个只能读取采购订单的键。
4. 还可以将其限制为地址（IP 地址或 IPv4 地址范围，例如 203.0.113.0/24），缩短其令牌的有效期，或为其设置过期日期。
5. 创建它。密钥仅显示一次——将其复制到将要使用它的程序中。它仅以指纹形式存储，无法读取。

该程序将密钥交换为有效期为几分钟的令牌，并在每次调用时像其他持有者令牌一样发送该令牌：

POST /api/auth/service-token
{ "client_id": "nightly-export@service.yourcompany", "secret": "txs_…" }

→ { "token": "…", "expires_in": 3600, "companies": [ … ] }

GET /api/scm/purchase-orders
Authorization: Bearer <token>
X-Company: <company id>

• 新的密钥会立即取代旧的密钥并停止其有效。已发行的代币会一直有效直至过期，除非您手动终止它们。
• 撤销操作会停止密钥，并在下一次请求时终止所有有效令牌。
• 停用操作会注销该帐户；其名称仍会保留在它写入的每一条审计记录中。
• 每个令牌都是一个会话：它出现在“平台”→“访问”→“Web 和用户会话”下，并且可以像任何人的会话一样在那里结束。
• 错误的密钥与错误的密码一样，都会导致系统锁定，并且每次交换都会被记录在审计日志中。
• 能够管理服务帐户但不是管理员的人只能给别人分配自己拥有的角色，而不能分配管理员角色。

支持台的账户

每个部署都自带一个无需自行创建的服务帐户：support-desk@service.tranxact。该帐户由部署本身根据供应商在部署安装时设置的密钥进行配置，因此贵公司无需任何人进行任何操作即可获得工单回复。该帐户在每个公司都拥有支持服务台角色，负责读取和回复支持工单及其附件，且不会打开任何模块或其他屏幕。该帐户的设置状态为“由部署设置”；您可以自行决定是否撤销该帐户，部署不会覆盖您的设置。