独立站或 SaaS 把 Admin API key 写进前端、或只用默认 Search-only 却无索引/限流限制时,常见结果是索引被整库 browse,或账号被刷搜索打爆配额。
Algolia Docs《API keys》(dateModified 可核)说明:API key 是账号、数据与索引设置的代码级访问凭证;预置最重要的是 Admin(须保密)与 Search-only(可搜全部应用索引,适合生产前端)。Search-only 暴露时,第三方可能刮取索引或灌入搜索请求;缓解方式包括:索引只放可公开数据,以及生成带限流、索引访问等限制的 Secured search-only key。创建密钥时可授予 ACL,例如 search、browse、addObject、deleteObject、listIndexes、deleteIndex、settings、editSettings、analytics、recommendation、usage、logs、seeUnretrievableAttributes。可选限制包括:可访问索引、每小时调用上限、每页最大记录数、有效期、HTTP referrers、强制查询参数、描述。密钥分 Main(长期、Dashboard/API 可管、应定期轮换)与 Secured(由 Main 派生的虚拟密钥,不可放宽基键限制,Dashboard 不可见,用 generateSecuredApiKey;适合大量用户临时权限或移动端避免硬编码)。撤销 Main 会使其派生 Secured 一并失效且即使恢复 Main 也不能恢复旧 Secured;团队成员入职会分配若干密钥,离职移除成员密钥,但成员手工创建的密钥需人工清理。本场景据此输出权限与 Secured Key 简报。禁止回显 Admin Key 或声称「生产密钥已全部轮换」。