您可以從網站和命令列介面 (CLI) 建立檢視 存取權杖。

建立存取權杖

在網站上建立傳統權杖

注意:為了更高的安全性,我們建議使用 精細存取權杖,而不是傳統的唯讀權杖或傳統的自動化權杖。

  1. 在頁面的右上角,按一下您的個人資料圖片,然後按一下存取權杖

    Screenshot of the account menu with the tokens link selected
  2. 按一下產生新權杖,然後從下拉式功能表中選取傳統權杖

    Screenshot of the create new token button
  3. (選用)為您的權杖命名。

  4. 選取存取權杖的類型

    • 唯讀:唯讀權杖只能用於從登錄檔下載套件。它將有權限讀取您有權存取的任何私人套件。建議用於您正在安裝套件但不會發布新套件的自動化和工作流程。

    • 自動化:自動化權杖可以下載套件並發布新套件,但如果您在帳戶上設定了雙重驗證 (2FA),將不會強制執行。您可以在連續整合工作流程和其他自動化系統中使用自動化權杖,即使您無法輸入一次性密碼,也能發布套件。

    • 發布:發布權杖可以代表您執行任何動作,包括下載套件、發布套件以及變更使用者設定或套件設定。如果您在帳戶上設定了雙重驗證,在使用發布權杖時,您將需要輸入一次性密碼。建議用於互動式工作流程,例如 CLI。

    Screenshot of the access level selection
  5. 按一下產生代碼

  6. 從頁面頂端複製代碼。

在網站上建立精細存取權杖

  1. 在頁面的右上角,按一下您的個人資料圖片,然後按一下存取權杖

    Screenshot of the account menu with the tokens link selected
  2. 按一下產生新代碼,然後按一下細粒取用權杖

    Screenshot of the create new token button
  3. 代碼名稱欄位中,輸入代碼的名稱。

  4. (選用)在說明欄位中,輸入代碼的說明。

  5. 到期日欄位中,輸入代碼到期期限。日期必須至少為未來 1 天。

  6. (選用)在允許的 IP 範圍欄位中,輸入 IP 位址範圍以限制取用權杖。您必須使用 CIDR 表示法輸入 IP 位址範圍。若要新增多個允許的 IP 範圍,請按一下新增 IP 範圍,然後在新文字欄位中輸入 IP 範圍。

    Screenshot of the allowed IP ranges section
  7. (選用)在套件和範圍區段中,設定代碼存取套件和範圍的權限。

    • 權限下拉式功能表中,選取無存取權唯讀讀寫
    • 選取套件下方,選取下列其中一項:
      • 所有套件授與代碼存取使用者帳戶有權存取的所有套件。
      • 僅選取套件和範圍選取最多 50 個特定套件或範圍,讓代碼有權存取。然後從下拉式功能表中選取特定套件或範圍。
    Screenshot of the packages and scopes section
  8. (選用)在組織區段中,設定代碼存取組織的權限。

    • 權限下拉式功能表中,選取無存取權唯讀讀寫
    • 選取組織下方,選取您要授與代碼存取權的組織。
    Screenshot of the organizations section

    注意:當您授與代碼存取組織時,代碼只能用於管理組織設定和與組織相關的團隊或使用者。它不會授與代碼發佈由組織管理的套件的權利。

  9. 檢閱代碼摘要,然後按一下產生代碼

    Screenshot of the granular access token summary and the generate token button
  10. 從頁面頂端複製代碼。

使用 CLI 建立權杖

您可以使用 CLI 建立具有唯讀權限或讀寫權限的代碼。

注意:您無法從 CLI 建立舊版自動化代碼或細粒取用權杖。您必須使用網站產生這些類型的代碼。如需更多資訊,請參閱「在網站上建立舊版代碼」和「在網站上建立細粒取用權杖」。

  • 唯讀:僅允許安裝和發行,但沒有與您的帳戶相關的發佈或其他權利。
  • 發布:新令牌的預設設定,以及權限最高的令牌類型。發布令牌允許安裝、散布、修改、發布,以及您在帳戶中擁有的所有權限。

此外,您可以使用 CIDR 表示法,指定令牌僅對特定 IPv4 位址範圍有效。僅當從指定的 IP 位址使用時,令牌才會有效。

  1. 若要在命令列中建立新的令牌,請執行:
    • npm token create 用於讀取和發布令牌
    • npm token create --read-only 用於僅讀取令牌
    • npm token create --cidr=[list] 用於 CIDR 受限的讀取和發布令牌。例如,npm token create --cidr=192.0.2.0/24
    • npm token create --read-only --cidr=[list] 用於 CIDR 受限的僅讀取令牌
  2. 受提示時,請輸入您的密碼。
  3. 如果您已啟用 兩步驟驗證,受提示時,請輸入一次性密碼。
  4. 從命令輸出的令牌欄位中複製令牌。

CIDR 受限權杖錯誤

如果您輸入的 CIDR 字串無效或格式不正確,您會收到類似以下的錯誤訊息

npm ERR! CIDR 白名單包含無效的 CIDR 項目:X.X.X.X./YY,Z.Z.. . .

請確定您使用的是有效的 IPv4 範圍,然後再試著建立令牌。

檢視存取權杖

注意:永遠不會顯示完整的令牌,只會顯示頭尾四個字元。您只能在建立後立即查看完整的令牌。

在網站上檢視權杖

若要查看與您的帳戶相關聯的所有令牌,請按一下頁面右上角的個人資料圖片,然後按一下存取令牌

Screenshot of the account menu with the tokens link selected

在 CLI 上檢視權杖

若要在命令列中查看與您的帳戶相關聯的所有令牌,請執行下列命令

npm token list

權杖屬性

  • id:在命令中使用令牌 ID 來參照令牌。
  • 令牌:實際令牌的第一個數字。
  • 建立:建立令牌的日期。
  • 唯讀:如果為「是」,表示唯讀令牌。如果為「否」,表示具有讀取和發佈權限的令牌。
  • CIDR 白名單:透過 IP 位址限制令牌使用。