#github #git #cli #sockets #git-credential

app git-credential-github-app-auth

使用 GitHub App 身份验证来为 Git 提供作为凭据的 GitHub 令牌的 Git 凭据助手

2 个不稳定版本

0.2.0 2023 年 3 月 20 日
0.1.0 2023 年 2 月 19 日

#894 in 身份验证

MIT 许可证

17KB
328

git-credential-github-app-auth

使用 GitHub 凭据助手App 身份验证 为 Git 提供作为凭据的 GitHub 令牌。

助手将缓存凭据,并在前一个令牌过期时才请求新的令牌。

设置

创建一个 GitHub App 并将其安装在存储库或帐户/组织上。

该应用程序需要至少具有对存储库“内容”的只读 权限

您还必须为应用程序 生成一个私钥 以便进行 API 请求。

用法

确保辅助二进制文件 git-credential-github-app-auth 在您的路径中。身份验证代理在本地 Unix 套接字上监听,可以使用以下命令启动

git-credential-github-app-auth \
    /run/user/1000/github-app-auth \
    agent \
    --app-id 1234 \
    --key-path /path/to/app/private-key.pem

~/.gitconfig 中配置 Git 凭据助手

[credential "https://github.com"]
    helper = "github-app-auth /run/user/1000/github-app-auth client"
    useHttpPath = true

为了测试身份验证助手是否正常工作,您可以克隆一个已安装配置好的 GitHub 应用程序的存储库,或者直接运行 git credential fill 并提供以下输入(注意末尾的额外换行符;另请参阅 预期格式

protocol=https
host=github.com
path=westphahl/git-credential-github-app-auth.git

依赖项

~14–26MB
~498K SLoC