HTTPS 克隆私有仓库:密码填访问令牌

简介: 用 HTTPS 克隆 AngusGit 上的私有仓库时,终端要用户名和密码:用户名填登录名,密码填一把只读的访问令牌。令牌怎么生成、怎么让 Git 记住、CI 里怎么用才不泄露,以及过期或认证失败时怎么处理,都按步骤说明。

这篇讲用 HTTPS 地址克隆 AngusGit 私有仓库时,用户名和密码分别填什么。看完你可以生成一把只读、只对当前仓库有效的访问令牌,用它完成克隆,并在本机或 CI 里保存这把令牌,避免写进克隆地址。

下文用 AngusGit 线上实例上的真实私有仓库 https://git.anguskit.com/anguskit/AngusKit.git 做示例。照着做时,换成你自己的仓库地址。要用 SSH 密钥,或者要第一次往空仓库推代码,见文末参考里的第一次推送一文。

1. 用户名和密码各填什么

终端问的 填什么 说明
Username for 'https://git.anguskit.com': 你的 AngusGit 登录名 不是团队名,也不是仓库所有者。示例里的所有者是团队 anguskit,用户名仍填你自己的登录名
Password for 'https://<登录名>@git.anguskit.com': 访问令牌 登录密码也能用,但令牌更安全,原因见下

推荐令牌而不用登录密码,有三个原因:

  • 登录密码能登录整个控制台。它一旦被存进凭据缓存或脚本又泄露出去,别人能做的远不止克隆代码。令牌只用于 Git 克隆和推送,不能用来登录控制台。
  • 令牌可以只给 git:read,只给某几个仓库。即使泄露,别人也只能读这几个仓库。
  • 令牌有过期时间,也能单独吊销。吊销一把令牌,不影响你的登录密码和其他令牌。

2. 生成一把只读令牌

  1. 打开令牌页

    侧栏点 我的,切到 访问令牌 页签,点 生成新令牌。

  2. 名称、期限和身份确认

    令牌名称 写清用途,例如「笔记本克隆 AngusKit」,以后在列表里一眼能认出来。过期时间 和下一步的权限,生成之后都不能再改,要一次选对。过期时间 可选 30天、60天、90天 或 365天。密码验证 里输入你当前的登录密码,确认是你本人在操作。

  3. 只给需要的权限

    权限范围 勾选 git:read,页面说明是「允许 clone / fetch」。仓库作用域 选 指定仓库,在列表里勾选 anguskit/AngusKit,权限设为 READ。以后这把令牌只能读这一个仓库。

  4. 马上保存

    点 生成令牌。页面提示「请立即复制此令牌。出于安全考虑,它将不会再次显示。」点 复制,存进你的密码管理器,再点 我已保存此令牌。之后列表里只显示令牌名称,看不到原文;丢了就只能重新生成。

以后还要用这把令牌推送时,权限范围 要勾 git:write,仓库权限设为 WRITE。只设 WRITE 而不勾 git:write,页面会提示「仓库授予 WRITE 时必须同时勾选 git:write」。

3. 克隆

git clone https://git.anguskit.com/anguskit/AngusKit.git

终端先打印 Cloning into 'AngusKit'...,然后依次出现两个提示:

Username for 'https://git.anguskit.com':
Password for 'https://<登录名>@git.anguskit.com':

第一个填登录名,第二个粘贴刚才保存的令牌。粘贴时屏幕上不显示任何字符,这是正常的,粘贴完直接回车。接着出现 Receiving objects 的进度,就说明认证已经通过、正在下载。命令结束后当前目录下多出一个 AngusKit 文件夹,克隆就完成了。

4. 让 Git 记住令牌

不想每次拉取都粘贴一遍令牌,就交给系统的凭据管理器保存:

  • macOS: Git 默认使用钥匙串,第一次输入之后自动保存。
  • Windows: Git for Windows 自带凭据管理器,第一次输入之后自动保存。
  • Linux: 下面这一行让 Git 把凭据在内存里保留一段时间(默认 15 分钟),不写入磁盘:
git config --global credential.helper cache

也可以用 credential.helper store 长期保存,但它会把令牌以明文写进 ~/.git-credentials,只适合你一个人用的电脑。

5. 在脚本和 CI 里克隆

CI 机器上没有人来输入密码。这时常见的写法是把令牌拼进地址,例如 https://<登录名>:<令牌>@git.anguskit.com/...。不要这样做:这个地址会被写进克隆出来的 .git/config,还容易出现在构建日志里。

改用请求头传令牌。先把令牌放进 CI 的密钥变量,例如 ANGUSGIT_TOKEN,然后:

git -c http.extraHeader="Authorization: Bearer ${ANGUSGIT_TOKEN}" \
  clone https://git.anguskit.com/anguskit/AngusKit.git

-c 只对这一条命令生效,令牌不会写进 .git/config。之后在这个目录里再执行 git fetch 或 git pull 时,同样要带上这段 -c。

给 CI 用的令牌,单独生成一把:名称写明是哪条流水线,权限范围 只给 git:read,仓库作用域 只选它要拉的仓库。这样流水线出问题时,吊销这一把就行,不影响其他人。

6. 令牌过期了,或者要换一把

访问令牌 列表里,每把令牌都显示状态(活跃、已过期 或 已吊销)、最后使用 时间、使用次数 和 过期于 的日期。

令牌过期或被吊销后,用它克隆或拉取会认证失败。按下面三步换一把:

  1. 按第 2 节重新生成一把令牌。
  2. 清掉 Git 缓存的旧令牌,否则 Git 会一直拿旧的去试:
printf "protocol=https\nhost=git.anguskit.com\n\n" | git credential reject
  1. 再执行一次 git pull,在提示里填登录名和新令牌。

怀疑令牌泄露时,在列表里点那一把的 吊销,它会立即失效。吊销全部 会让你所有未过期的令牌同时失效,用到这些令牌的脚本和 CI 也会一起停止工作,点之前先想清楚有哪些地方在用。

7. 克隆失败时

你看到的 原因 怎么处理
fatal: Authentication failed for 'https://git.anguskit.com/anguskit/AngusKit.git/' 令牌已过期或已吊销;令牌复制时少了字符;用户名填的不是令牌主人的登录名;令牌的 指定仓库 里没有这个仓库;或者 Git 缓存的还是旧令牌 到 访问令牌 列表看这把令牌的状态和仓库作用域。用户名填你自己的登录名。缓存过旧令牌时,按第 6 节执行 git credential reject 后重试
fatal: could not read Username for 'https://git.anguskit.com': terminal prompts disabled 在没有终端交互的环境里(CI、脚本)克隆,Git 想问用户名却问不了 按第 5 节用 http.extraHeader 传令牌
fatal: repository 'https://git.anguskit.com/anguskit/AngusKit.git/' not found 地址里的所有者或仓库名写错了 打开仓库代码页,点绿色的 代码 按钮,从 Clone 面板重新复制地址
克隆正常,推送被拒绝 令牌的权限范围只有 git:read,或者仓库权限只有 READ 推送需要 git:write 加 WRITE。令牌的 编辑 只能改名称和描述,不能改权限,所以要另外生成一把用于推送

常见问题

改了登录密码,令牌要跟着换吗?

不用。令牌和登录密码互相独立。改密码之后,令牌在有效期内照样能用。

访问令牌能用来调用控制台的接口吗?

不能。访问令牌只用于 Git 的 HTTPS 克隆、拉取和推送。控制台和它的接口仍然通过登录会话访问。

同一台电脑要用两个账号克隆不同的仓库,怎么办?

让凭据按完整路径区分。执行 git config --global credential.useHttpPath true 之后,Git 会按每个仓库的完整地址分别保存凭据,两个账号的令牌不会互相覆盖。

不想管令牌,有别的办法吗?

可以改用 SSH。在 我的 → SSH密钥 登记一次公钥,之后用 SSH 地址克隆和推送都不再需要密码或令牌。做法见文末参考里的第一次推送一文。

小结

HTTPS 克隆私有仓库时,用户名填登录名,密码填访问令牌。只读的场景,生成一把只勾 git:read、只选目标仓库的令牌,生成后马上存好。日常使用交给系统凭据管理器记住;CI 里用 http.extraHeader 传令牌,不拼进地址。令牌过期就重新生成一把,再用 git credential reject 清掉旧缓存;怀疑泄露就单独吊销那一把。

结论: HTTPS 克隆私有仓库时,用户名填 AngusGit 登录名,密码填 我的 → 访问令牌 生成的 git:read 令牌;CI 中使用 http.extraHeader 传参,避免把令牌写进克隆 URL。

相关文章
|
15天前
|
人工智能 测试技术 开发工具
AngusTester 是什么:一个自动化测试平台,一份 YAML测试 Anything,计划和结果在一处
AngusTester 是一个自动化测试平台。一份 YAML 描述接口、性能、页面、移动端和模型调用,计划、用例和报告在同一处。脚本由执行节点上的 Agent 运行。
AngusTester 是什么:一个自动化测试平台,一份 YAML测试 Anything,计划和结果在一处
|
15天前
|
安全 Java Maven
AngusRepo 是什么:一个制品仓库,涵盖 28 种常见格式,客户端拉取和发布时只改地址
AngusRepo 是一个制品仓库。28 种常见格式可以托管、代理或聚合成一个地址。mvn、npm、docker 仍用原来的命令,改的是仓库地址。制品留在你这次安装里。
AngusRepo 是什么:一个制品仓库,涵盖 28 种常见格式,客户端拉取和发布时只改地址
|
16天前
|
安全 网络安全 开发工具
AngusGit 是什么:一个代码托管与协作平台,保护分支和合并请求,需要时再 CI 构建
AngusGit 是一个代码托管与协作平台。用 SSH 或 HTTPS 推代码,用保护分支和合并请求做评审,需要构建时再跑同一套账号下的流水线。仓库留在你自己的磁盘上。
AngusGit 是什么:一个代码托管与协作平台,保护分支和合并请求,需要时再 CI 构建
|
23天前
|
Java Shell Maven
GitLab CI 迁到内置流水线:YAML 怎么改写
想把 .gitlab-ci.yml 搬到 AngusGit 内置流水线,可以先用「导入 GitLab CI」生成初稿(转换出来还要手改的第一版)。artifacts、rules 和 when 不会映射,deploy 仍会自动跑,分支限制也会丢失,所以要逐项对照、改好之后再创建流水线。
GitLab CI 迁到内置流水线:YAML 怎么改写
|
23天前
|
jenkins 持续交付 开发工具
从 GitLab 迁到 AngusGit:迁移清单、双跑和回滚
团队从 GitLab 整体切到 AngusGit,难的不是推送几个仓库,而是切换那天谁都不丢代码、出了问题能退回去。按准备、首次同步、双跑、切换日、回滚五个阶段,给出每一步要做什么、怎么验收,以及分支保护为什么要放在最后一次同步之后再打开。
从 GitLab 迁到 AngusGit:迁移清单、双跑和回滚
|
18天前
|
JSON 运维 安全
AngusSecurity 安全扫描报告怎么出:严重度和门禁结论冻成快照
AngusSecurity 报告是生成时刻的快照,不会随下一次扫描改写。按受众选模板,任务须已完成,导出 HTML/JSON/CSV/PDF,问题明细可另下 SARIF。
|
21天前
|
安全 开发工具 git
推送代码之后:怎么自动跑代码安全扫描
每次推送后自动做安全扫描,需要两步:系统管理员在「管理 → 安全设置」接入 AngusSecurity,仓库管理员再打开「本仓自动安全扫描」。配好之后,分支上只要有新提交就会把扫描任务发给 AngusSecurity;哪些操作会触发扫描、结果在哪看、配了却没扫时怎么排查,都可以按仓库对照。
推送代码之后:怎么自动跑代码安全扫描
|
22天前
|
SQL 负载均衡 算法
谁来审这段代码:用 CODEOWNERS 按目录自动指派评审人
改了某个目录的代码,可以按路径自动找到该负责的人来评审。AngusGit 读取仓库里的 CODEOWNERS 文件,打开开关后,新建拉取请求时就会把对应的人加为评审人。文件怎么写、开关在哪、它和默认评审人怎样一起生效,用 xlliu/test-pr-example #9 对照。
谁来审这段代码:用 CODEOWNERS 按目录自动指派评审人
|
22天前
|
JavaScript Java Linux
CICD流水线任务在哪跑:Docker 容器还是宿主机
流水线的每个任务,可以在运行器启动的 Docker 容器里执行,也可以直接在构建机上执行。两种方式的工具从哪来、工作目录在哪、每次环境是否干净、对机器有什么要求都不一样。把 YAML 里的 runner.mode、标签和运行器接入方式对上,任务才会落到想要的地方。
CICD流水线任务在哪跑:Docker 容器还是宿主机
|
23天前
|
Java 开发工具 git
导入 GitHub Actions 之后:事件、密钥和 Runner 还要对一遍
把 GitHub Actions 的 workflow 贴进「导入 GitHub Actions」之后,先对照未映射清单和注意清单,核对触发事件、密钥和运行器有没有变。示例转换后的初稿名叫 CI,runs-on 会变成 NATIVE,types 和 Job 超时都不会映射,核对完再创建流水线。