GitHub 凭证#
您可以使用这些凭证来验证以下节点:
- GitHub
- GitHub 触发器
- GitHub Document Loader: 该节点不支持OAuth认证。
先决条件#
创建一个GitHub账户。
支持的认证方法#
- API访问令牌:将此方法与任何GitHub节点一起使用。
- OAuth2: 此方法仅适用于GitHub和GitHub Trigger节点;不要与GitHub Document Loader一起使用。
相关资源#
更多关于该服务的信息,请参考GitHub的API文档。
使用API访问令牌#
要配置此凭证,您需要一个GitHub账户。
设置此凭证需要两个步骤:
请参考以下部分获取详细说明。
生成个人访问令牌#
推荐的访问令牌类型
n8n 推荐使用个人访问令牌(经典版)。GitHub 的细粒度个人访问令牌仍处于测试阶段,无法访问所有端点。
生成您的个人访问令牌:
- 如果您尚未完成,请通过GitHub验证您的电子邮件地址。更多信息请参阅验证您的电子邮件地址。
- 打开您的GitHub个人资料Settings。
- 在左侧导航栏中,选择开发者设置。
- 在左侧导航栏中,个人访问令牌下方,选择令牌(经典版)。
- 选择生成新令牌 > 生成新令牌(经典版)。
- 在备注字段中输入您的令牌描述性名称,例如
n8n integration。 - 选择您希望令牌的有效期,或选择永不过期。
- Select Scopes for your token. For most of the n8n GitHub nodes, add the
reposcope.- 未分配作用域的令牌只能访问公开信息。
- 参考
- 选择生成令牌。
- 复制令牌。
更多信息请参考创建个人访问令牌(经典版)。关于GitHub权限范围的更多信息,请参阅OAuth应用的权限范围。
设置凭证#
然后,在您的n8n凭证中:
- If you aren't using GitHub Enterprise Server, don't change the GitHub server URL.
- 如果您使用的是GitHub Enterprise Server,请更新GitHub服务器以匹配您服务器的URL。
- 输入您的用户名,与GitHub个人资料中显示的一致。
- 输入您在上面生成的访问令牌。
使用OAuth2认证#
n8n 云用户须知
云用户无需提供连接详情。选择连接我的账户通过浏览器进行连接。
如果您正在自托管n8n,请创建一个新的GitHub OAuth应用:
- 打开您的GitHub个人资料Settings。
- 在左侧导航栏中,选择开发者设置。
- 在左侧导航栏中,选择OAuth应用。
- Select New OAuth App.
- 如果您之前没有创建过应用,可能会看到注册新应用选项。请选择它。
- 输入一个应用名称,例如
n8n integration。 - 输入您应用网站的主页URL。
- 如需要,可添加可选的应用描述,GitHub会将其展示给终端用户。
- 从n8n复制OAuth重定向URL并粘贴到GitHub的授权回调URL中。
- 选择注册应用。
- 复制生成的客户端ID和客户端密钥,并将它们添加到您的n8n凭证中。
有关授权流程的更多信息,请参阅GitHub 授权 OAuth 应用文档。