1 个不稳定版本

0.1.0 2020年5月25日

#50 in #access-token

MIT 许可证

23KB
331

:octocat: 🔑
octopat

一个交互式的 GitHub 个人访问令牌命令行分配器 ✨


为什么

我经常需要为 GitHub 集成和 API 访问生成个人访问令牌。我经常在命令行工作。暂停导航到 GitHub 设置页面会打断我的工作流程。

Octopat 设计为一个命令行界面,与我的命令行工作流程协同工作,而不是与之冲突。

安装

Homebrew(在 osx 上)

$ brew install softprops/tools/octopat

如果您想升级到较新版本,请使用 brew upgrade。这将安装最新版本。

$ brew upgrade softprops/tools/octopat

GitHub 发布

您可以从 GitHub 发布页面下载和安装预编译的二进制文件。

您也可以使用 curl 以编程方式安装这些。

$ cd $HOME/bin
$ curl -L "https://github.com/softprops/octopat/releases/download/v0.0.1/octopat-$(uname -s)-$(uname -m).tar.gz" \
  | tar -xz -C ~/bin

工作原理

简而言之,octopat 是一个嵌入式 oauth 应用程序,可以将访问令牌复制到您的剪贴板。

  1. 第一次运行 octopat 时,您将需要输入一组 GitHub 应用程序凭据。如果您没有 GitHub 应用程序,请前往 此处创建一个。创建应用程序时,您将需要提供一些信息,例如名称和授权 URL。

名称不重要,但您可能希望使用 "octopat" 以便清晰。

您还将被要求输入授权回调 URL。将其设置为 "https://127.0.0.1:4567/",这将是在您的本地主机上运行的嵌入式 octopat 应用程序的 URL。

如果您想使用不同的端口,可以这样做,但请在命令行上使用 -p 标志。

Octopat 将将这些凭据安全地存储在您的本地密钥链中,这样您就不必在每次运行时都记住它们。

  1. GitHub 访问令牌具有特定的作用域。您将看到一系列作用域,然后被带到 GitHub 进行授权访问(您的 GitHub 应用程序)。

GitHub 将随后将您的浏览器重定向到 cli 内嵌入的服务器,该服务器将接收授权信息,并在将其复制到您的剪贴板之前将其交换为访问令牌。

在任何时候都不会不安全地存储秘密信息或将其打印出来。

撤销令牌

由于 octopat 只是一个 oauth 应用程序,您可以像平常一样撤销令牌

为什么是 oauth 舞蹈

此 CLI 使用 网络应用程序 oauth 流 来分发个人访问令牌。历史上这也通过一个单独的授权 API 实现过,但现在已被弃用

Doug Tangren (softprops) 2020

依赖项

~14–27MB
~430K SLoC