如何使用身份验证令牌
如何使用身份验证令牌
需要npm版本5.5.1或更高版本
无论何时登录npm,都会生成身份验证令牌。令牌授予您发布和访问模块的权限。
由于令牌只是一个十六进制字符串,因此您可以在其他工具中使用该令牌,例如持续集成测试环境,以便该工具可以使用完成任务所需的访问权限运行。例如,Travis-CI提供了一个可以分配给标记值的环境变量。这使Travis-CI能够以npm用户身份运行npm,包括安装您有权访问的私有包的能力。
阅读本章以了解如何管理安全令牌。
令牌命令使您能够:
- 查看令牌以便于跟踪和管理。
注意
:*如果您希望使用令牌进行测试和其他特殊用途,还需要执行其他步骤。
您可以使用Web或CLI中的令牌,最简单的方法。您在每个环境中所做的工作将反映在其他环境中。
使用来自网络的令牌
要开始转到令牌页面。
- 登录网站。
或者,如果您在Web上的另一个选项卡中工作,则可以单击“标记”选项卡:
创建一个新令牌
如何查看您帐户上的代币
从CLI使用令牌
如何查看您帐户上的代币
要查看与您的帐户关联的令牌,请键入:
npm token list
。
下表说明了令牌列表。
令牌可以是只读的,也可以是CIDR白名单。
如果您在配置文件上启用了双因素身份验证,则表明您已实现了额外的安全层。
注意
:令牌列表显示令牌的截断版本。如果需要查看完整令牌,请查看npmrc文件。
如何创建新令牌
npm token create [--read-only] [--cidr=list]
在创建新令牌之前,请确定所需的令牌类型:
- 只读(安装/分发权限)
新令牌的默认设置是完全权限。
只读
令牌允许安装和分发。
当令牌是只读时,它不能用于更改包。如果未将令牌显式设置为只读,则它具有完全权限,包括发布和修改权限。
如何创建新的完全权限标记:
要创建新的完整权限令牌,请键入:
'npm token create'
如果您设置了双因素身份验证,系统将提示您输入npm密码,然后输入OTP。npm将显示此表:
提示
:保存令牌字段的屏幕截图,因为这是您查看它的唯一机会。
请注意,只读默认为false
。
如何创建新的只读令牌
要创建新的只读令牌,请键入:
npm token create --read-only
如果您设置了双因素身份验证,系统将提示您输入npm密码,然后输入OTP。npm将显示此表:
请注意,只读设置为true
。
如何创建新的CIDR限制令牌
要限制令牌以便只能从指定的IP地址使用它,您可以创建一个受CIDR限制的令牌。CIDR是Classless Inter-Domain Routing的首字母缩写。该CIDR Wiki页面将让你开始。
使用CIDR限制可以强制任何人或任何使用令牌的系统物理或远程位于指定的IP地址范围内。
npm token create --[--cidr=list]
例:
npm token create --cidr=192.0.2.0/24
如果您设置了双因素身份验证,系统将提示您输入npm密码,然后输入OTP。npm将显示此表:
如果您看到如下消息:
npm ERR! CIDR whitelist contains invalid CIDR entry: X.X.X.X./YY,Z.Z.. . .
(返回的字符串是您输入的字符串)请确保CIDR字符串有效且格式合适。注意:npm目前仅支持IPv4。
如何创建CIDR限制的只读令牌
要创建也是只读的CIDR限制令牌,请键入:
npm token create --read-only --cidr=list
如何撤销令牌
无论何时创建令牌,您都可以删除(撤销)令牌。这使您可以控制您可能希望收回的访问权限。
删除令牌的命令是:
npm token delete
以下是步骤:
- 类型
npm token list
npm will report 'Removed 1 token'
输入“npm令牌列表”以确认该令牌已被删除。
以下屏幕截图演示了以下步骤:
注意:屏幕插图中显示的所有令牌均已被撤销。
注意:在某些情况下,成功撤销令牌之前可能会有一个小时的延迟。npm目前正致力于在所有情况下立即进行撤销。