@gjermundgaraba/clankerauth (英语)
这个 clankerauth 命令: 签名到 a 科克劳斯 发行人作为它的拥有者,在HTTP上运行每一个管理动作,并且为发行人的资源交出其他指令访问符. 它需要节点26或更新和0.24.0或以后的发行人,或0.28.0,用于管理键 CLANKERAUTH_TOKEN。 。 。 .
npm install --global @gjermundgaraba/clankerauth
clankerauth login https://clankerauth.home.example
clankerauth list-clients
clankerauth create-api-key --name "notes sync" \
--permissions '{"https://notes.home.example/":["notes:read"]}' --expires-at null
clankerauth logout
login <url> 输入资源 url 识别,从它的 /.well-known/oauth-protected-resource: 发行者自己的出身, CLANKERAUTH_BASE_URL,发布管理,一个应用程序的URL发布其资源. 然后它发现了资源名称的发行者; 将那里的命令注册为本地的 OAuth 客户端, 每个登录符都有一个新的客户端; 在浏览器中打开批准页面, 在 Stderr 上打印它的 URL, 用于一个没有浏览器可打开的终端, 或者单独打开 --no-browser;并听取回回路端口上的定向. 它要求资源的所有范围, clankerauth:read clankerauth:write 用于行政管理,除非 --scope 名称减少: --scope clankerauth:read 列表,永不更改。 除了他们,它要求 offline_access,仅用于发布无范围的资源。 资源必须公布该文件,因此由 http: 或者说 https: URL,待签入.
门牌都放在里面 $XDG_CONFIG_HOME/clankerauth/sign-ins.json, (中文(简体) ), ~/.config/clankerauth/sign-ins.json 默认情况下,由所有者单独读取:每个资源一个,每个资源都有自己的发行人,所以在第二个发行人签名后,第一个资源就留给自己了. 命令无法读取的文件, 如所写的版本、 已签名的文件和下一个文件 login 替换它。 A 类 login 到一个已签名的资源来替换该登录并撤销它。 命令会刷新即将到期的访问令牌,并保存所旋转的刷新令牌,所以在至少每30天使用一次时,登录会持续;当签发者拒绝刷新时,错误名称为: login 那又需要同样的瞄准镜 对文件的每次更改都会锁住锁,所以命令和程序会同时运行,刷新一次过期的登录,以及 logout 撤销当前刷新符号. logout 撤销所有登录并删除文件,以及 logout <url> 该 URL 的资源是单独存在的.
行政命令在所保存的一个行政当局的签发人处行事。 几个发行商向行政部门登记,名称为 CLANKERAUTH_URL,其来源;没有名称的值,例如 mailto: URL 被拒绝 .
未受关注, 例如在一个没有浏览器或磁盘来保持登录的容器中, 命令会占用管理密钥, 在发行者的发端根上授予的 API 密钥, 来源于 CLANKERAUTH_TOKEN 然后在发行人那里行动 CLANKERAUTH_URL 姓名,他们需要。 不读不写签入. 拥有者一次创建密钥, 签名于 :
clankerauth create-api-key --name deployer --expires-at null \
--permissions '{"https://clankerauth.home.example/":["clankerauth:read","clankerauth:write"]}'
CLANKERAUTH_URL=https://clankerauth.home.example CLANKERAUTH_TOKEN=clankerauth_… \
clankerauth list-api-keys
钥匙可以做什么,如果对钥匙作了修改,则在 发行人的读取器。 。 。 .
其他命令的键
token <url> 打印已签名的资源的当前访问令牌,以表示URL的下限,数个时最具体,没有其他的,当它即将到期时首先刷新它;没有URL,它就打印行政部门的。 另一个命令,或者一个脚本,从那里获得它的无记名符号,而不是保存一个密钥;一个使用效果的程序 token 联 合 国 @gjermundgaraba/clankerauth-sdk/credentials 相反,它读取并刷新同样的登录:
clankerauth login https://notes.home.example
curl -H "authorization: Bearer $(clankerauth token https://notes.home.example/api/list-notes)" \
https://notes.home.example/api/list-notes
clankerauth logout https://notes.home.example
所有其他命令都是行政行动,在kebab案件中以它命名,每个输入字段都有一面旗帜: clankerauth <command> --help 列出他们。 一个非文本字段需要 JSON, 例如 --permissions 上层或 --expires-at null。一个命令在 stdout 上打印动作结果为 JSON,在 stderr 上打印拒绝,退出 1 。 一个创建的 API 密钥或客户端密钥在 JSON 一次, 所以发送到它所属的地方:
clankerauth create-api-key --name "machine" \
--permissions '{"https://creds.home.example/":["creds:machine"]}' --expires-at null \
| jq -r .key > key
麻省理工学院有执照.