N8N中文教程
集成节点/Built in_nodes/Credentials

Strapi 凭据#

你可以使用这些凭据来认证以下节点:

  • Strapi

前提条件#

创建一个 Strapi 管理员账户,需满足以下条件:

  • 可访问一个已有的 Strapi 项目。
  • 该项目中至少包含一个集合类型(collection type)。
  • 该集合类型中包含已发布的数据。

更多信息请参考 Strapi 开发者快速入门指南。

支持的认证方式#

  • API 用户账户:需要一个具有适当内容权限的普通用户账户。
  • API 令牌(API token):需要一个管理员账户。

相关资源#

更多关于该服务的信息,请参考 Strapi 官方文档。

使用 API 用户账户#

要配置此凭据,你需要提供以下信息:

  • 用户 邮箱(Email):必须是普通用户账户的邮箱,而非管理员账户。详见下方详细说明。
  • 用户 密码(Password):必须是普通用户账户的密码,而非管理员账户。详见下方详细说明。
  • URL:使用你的 Strapi 服务器的公开 URL,该 URL 在 ./config/server.js 文件中定义为 url 参数。Strapi 推荐使用绝对 URL。
    • 对于 Strapi Cloud 项目,请使用你的云项目 URL,例如:https://my-strapi-project-name.strapiapp.com
  • API 版本(API Version):选择你希望 API 调用使用的版本。可选项包括:
    • Version 3
    • Version 4

在 Strapi 中,此配置包含两个步骤:

  1. 配置角色(Configure a role)。
  2. 创建用户账户(Create a user account)。

请参考以下每个步骤的更详细说明。

配置角色#

对于 API 访问,请在 设置 > 用户与权限插件(Users & Permissions Plugin) 中使用该插件。 有关此插件的更多信息,请参阅 配置用户与权限插件。有关角色的更多信息,请参阅 配置最终用户角色。

对于 n8n 凭据,用户必须拥有一个为其授予集合类型(collection type)API 权限的角色。您可以选择以下任一方式配置角色:

  • 更新默认的 Authenticated 角色,添加所需权限,并将用户分配给该角色。更多信息请参阅 配置角色权限。
  • 创建一个新角色,包含所需权限,并将用户分配给该角色。更多信息请参阅 创建新角色。

无论选择哪种方式,在打开对应角色后:

  1. 进入 Permissions(权限) 部分。
  2. 展开相关集合类型的区域。
  3. 为该角色选择集合类型应具备的权限。可选项包括:
    • create (POST)
    • findfindone (GET)
    • update (PUT)
    • delete (DELETE)
  4. 对所有相关的集合类型重复此操作。
  5. 保存角色设置。

有关权限选项的更多详情,请参阅 端点(Endpoints) 文档。

创建用户账户#

现在您已配置好适当的角色,接下来创建一个最终用户账户并为其分配该角色:

  1. 进入 Content Manager > Collection Types > User(内容管理器 > 集合类型 > 用户)
  2. 点击 Add new entry(添加新条目)
  3. 填写用户信息。n8n 凭据需要以下字段,尽管您的 Strapi 项目可能还包含其他自定义必填字段:
    • Username(用户名) :所有 Strapi 用户均需填写。
    • Email(邮箱) :在 Strapi 中输入,并在 n8n 凭据中用作 Email(邮箱)
    • Password(密码) :在 Strapi 中设置,并在 n8n 凭据中用作 Password(密码)
    • Role(角色) :选择您在上一步中配置好的角色。

请参考 管理终端用户账户 以获取更多信息。

使用 API 令牌#

要配置此凭据,您需要:

  • 一个 API 令牌:从 设置 > 全局设置 > API 令牌 创建一个 API 令牌。更多详细信息以及关于重新生成 API 令牌的操作,请参考 Strapi 的 创建新 API 令牌文档。 API 令牌权限 如果在 全局设置 中看不到 API 令牌 选项,则表示您的账户没有 API 令牌 > 读取(Read) 权限。
  • URL:使用 Strapi 服务器的公开 URL,该 URL 在 ./config/server.js 文件中定义为 url 参数。Strapi 建议使用绝对 URL。
    • 对于 Strapi Cloud 项目,请使用您的云项目 URL,例如:https://my-strapi-project-name.strapiapp.com
  • API 版本:选择您希望调用使用的 API 版本。可选项包括:
    • 版本 3
    • 版本 4