ServiceNow IDE を使用してプライベートレジストリから npm パッケージをインストールする

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • ノードパッケージマネージャー (npm) パッケージをプライベートレジストリから依存関係としてアプリケーションにインストールし、サードパーティライブラリとして使用します。

    始める前に

    必要なロール：admin

    このタスクについて

    プライベートレジストリからパッケージをインストールするには、ServiceNow IDE でパッケージマネージャーのユーザー設定を行う必要があります。次に、パッケージをインストールするアプリケーションを選択できます。

    ServiceNow IDE は、パブリック npm レジストリ (https://registry.npmjs.org) をデフォルトのパッケージソースとして使用します。ネットワークがこのレジストリへのアクセスをブロックしている場合、パッケージをダウンロードして ServiceNow IDEでアプリケーションをビルドするには、代替レジストリにアクセスできる必要があります。システムでパブリック npm レジストリへのアクセスがブロックされている場合は、 ServiceNow IDE のパッケージマネージャーユーザー設定でプライベート npm レジストリを構成する必要があります。

    注:
    プライベートレジストリからパッケージをインストールするには、レジストリが HTTP Access-Control-Allow-Origin ヘッダーで応答する必要があります。

    手順

    1. 移動先 すべて > アプリ開発 > ServiceNow IDE.
    2. ワークスペースを開きます。
    3. コマンドパレットを開くには、次のいずれかのキーボードショートカットを使用します。
      • Windows：Ctrl-Shift-P
      • Mac：Cmd-Shift-P
    4. 設定を入力: ユーザー設定 (JSON) を開き、Enter キーを押します。
    5. パッケージをインストールできるデフォルトのレジストリまたはスコープ対象レジストリとして、プライベートレジストリを指定します。
      オプション例
      デフォルトのレジストリ 
      "package-manager.defaultRegistry": "<private-registry-url>",
      スコープ対象レジストリ 
      "package-manager.scopedRegistries": [
        {
            "scope": "@<scope>",
            "registry": "<private-registry-url>"
        },
        ...
]
      注:
      パブリックレジストリからパッケージをインストールするには、プライベートレジストリに加えて、パブリックレジストリをデフォルトのレジストリとして、またはスコープ対象レジストリとして指定できます。
    6. プライベートレジストリにアクセスするための認証情報を入力します。
      オプション説明
      ベーシック認証 指定したデフォルトのレジストリにアクセスするためのユーザー名とパスワードを入力します。
      "package-manager.basicAuth": [
    {
        "registry": "<private-registry-url>",
        "user": "<user-name>",
        "pass": "<password>"
    },
    ...
]
      従来の認証 指定したデフォルトのレジストリにアクセスするための従来のトークンを指定します。従来のトークンは、Base64 形式でエンコードされたベーシック認証情報です。
      "package-manager.legacyAuth": [
    {
        "registry": "<private-registry-url>",
        "token": "<legacy-token>"
    },
    ...
]
      トークン認証 指定したデフォルトのレジストリにアクセスするためのベアラートークンを指定します。
      "package-manager.tokenAuth": [
    {
        "registry": "<private-registry-url>",
        "token": "<token>"
    },
    ...
]
    7. 変更内容を settings.json ファイルに保存します。
    8. 構成されたレジストリからパッケージをインストールします。
      1. コマンドパレットを開くには、次のいずれかのキーボードショートカットを使用します。
        • Windows：Ctrl-Shift-P
        • Mac：Cmd-Shift-P
      2. 「パッケージマネージャー:依存関係のインストール」と入力し、Enter キーを押します。
      3. パッケージを依存関係としてインストールするアプリケーションを選択します。
      パッケージは node_modules ディレクトリにインストールされます。

    プライベートレジストリにアクセスするためのユーザー設定

    次の例でユーザーは、ベーシック認証を使用して、プライベートレジストリへのアクセスを構成しました。また、ユーザーは、@example スコープでパブリックレジストリからパッケージをインストールするように設定を構成しました。

    {
    "files.autoSave": "off",
    "package-manager.defaultRegistry": "<private-registry-url>",
    "package-manager.basicAuth": [
        {
        "registry": "<private-registry-url>",
            "user": "<user-name>",
            "pass": "<password>"
        }
    ],
    "package-manager.scopedRegistries": [
        {
            "scope": "@example",
            "registry": "<public-registry-url>"
        }
    ]
}

    次のタスク

    アプリケーションで、サードパーティライブラリとしてインストールしたパッケージを使用します。詳細については、「ServiceNow IDE のアプリケーションでサードパーティライブラリを使用する」を参照してください。