機械翻訳について

プロジェクトNPMレジストリへの接続の構成

NPM構成プロセスを簡略化するために、VB Studioはローカルの.npmrcファイルで使用するスニペットを生成します。 NPMコマンドライン・クライアントは、プロジェクトNPMレジストリおよびデフォルトの外部NPMレジストリとの接続を確立するために、この情報が必要です。 接続を確立する方法は2つあります: 基本認証またはトークン・ベースの認証。

基本認証の構成

基本認証を使用して接続を設定するには:
  1. NPMページの「npm構成」セクションの「基本」タブで、VB Studioパスワードを入力します。このパスワードは、VB Studioによってエンコードされ、その下にあるNPM構成スニペットに挿入されます。

    パスワードが保存されていません。 NPM構成スニペットのbase64-encoded文字列の生成にのみ使用されます。

  2. NPM構成スニペットから内容をコピーし、ローカル.npmrcファイルに手動で貼り付けます:
    • Windowsシステムでは、.npmrcファイルは%USERHOME/.npmrcにあります。
    • UNIXシステムでは、ファイルのロケーションは~/.npmrcです。

    ノート:

    ローカル.npmrcファイルでalways-authプロパティ値をtrueに変更しないでください。 プロパティのデフォルト値はfalseで、変更しないでください。 always-authプロパティをtrueに設定すると、NPMクライアントはリモート・プロキシされたパブリックNPMレジストリに認可ヘッダーを送信します。

    「デフォルト」タブの内容は、スコープ指定されたパッケージ(スコープ指定されていないパッケージ)とスコープ指定されていないパッケージの両方をプッシュするように、プロジェクトのプライベートNPMレジストリへの接続を構成します。 「スコープ」タブの内容によって、特定のスコープ値のみについてプロジェクト・プライベートNPMレジストリへの接続が構成されます。

  3. ローカル.npmrcファイルを保存します。

トークン・ベース認証の構成

ノート:

ユーザー名にURLセーフ以外の特殊文字(@文字など)が含まれている場合、npm loginコマンドはNPMクライアントのトークンを生成しません。 この制限は、トークン生成にnpm loginコマンドを使用する場合(および生成されたトークンを使用してnpm install、npm publish、npm searchなどのNPM操作を実行する場合)、ユーザー名を電子メール・アドレスにできないことを意味します。

トークン・ベース認証を構成するには、この制限のない「.npmrcエントリを直接取得」トークン生成オプションを使用します。 VB Studioにより、.npmrcファイルにコピー・アンド・ペーストするために必要なスニペットが生成されるため、現在のユーザー名でアクセス・トークンを使用できます。 または、組織の管理者にIDCSユーザー(ユーザー名に安全でない文字がない)を生成させることもできます。

トークン・ベース認証を使用して接続を設定するには:
  1. NPMページのnpm構成セクションで、トークンタブを選択します:
    npmconfiguration.pngの説明は以下のとおりです
    図npmconfiguration.pngの説明

  2. トークン・ベース認証の構成メソッドを選択します:
    • 「.npmrcエントリを直接取得」オプションを選択してトークンを生成し、必要な.npmrcエントリをVB Studioから直接取得します。 ステップ3を参照してください。
    • ユーザー名にURLセーフ以外の文字が含まれていない場合にのみ、「手動でnpmログインを使用」オプションを選択します。 その後、コマンドラインでnpm loginを入力した後にプロンプトが表示されたら、VB Studioログイン資格証明を指定できます。 ステップ4を参照してください。
  3. デフォルトでは、「.npmrcエントリを取得」ボタンは読取り専用トークンを生成します。 書込み/アップロード・アクセスも必要な場合は、「NPMレジストリにパッケージを公開する権限も付与」をクリックします。
  4. 「.npmrcエントリを直接取得」を選択した後、「.npmrcエントリを取得」をクリックします。
    「.npmrcエントリを取得」ダイアログが表示されます。コピーして.npmrcファイルに貼り付けるデフォルト・タブにスニペットが表示されている.npmrcエントリの取得ダイアログ。
    1. コピーをクリックして、生成された.npmrcエントリを「デフォルト」タブ(スコープ付きパッケージとスコープなしパッケージの両方をプッシュする場合)または「スコープ」タブ(特定のスコープ付きパッケージのみをプッシュする場合)にコピーします。
    2. コピーしたコンテンツをローカルの.npmrcファイルに貼り付けて保存します。
    3. 「終了」をクリックしてダイアログを閉じます。

    ノート:

    組織管理者で、「.npmrcエントリを取得」をクリックした後、ユーザーごとに許可されるトークンの最大数に達したという警告メッセージが表示され、NPMで使用する別のトークンを作成する場合は、「終了」をクリックしてから既存のトークンを削除できます。トークンは、「プリファレンス」ページの「個人アクセス・トークン」タブに移動し、「削除」アイコン「削除」アイコンを使用して既存のトークンの一部を削除するか、「アクセス・トークンの設定を開く」をクリックして「組織」ページの「プロパティ」タブに移動し、組織全体の最大値を変更できます。

    組織管理者でなく、「.npmrcエントリを取得」をクリックした後、トークンが多すぎるというメッセージを参照して、NPMで使用する別のトークンを作成するには、「終了」をクリックしてから、既存のトークンを削除することができます。「プリファレンス」ページの「個人アクセス・トークン」タブに、「削除」アイコン「削除」アイコンを使用して既存のトークンの一部を削除するか、ダイアログに表示されているいずれかの組織管理者に、ユーザーごとに許可されるトークンの最大数を変更するように依頼できます。

    個人アクセス・トークンの作成の詳細は、「トークン・ベース認証の設定」を参照してください。

  5. 「手動でnpmログインを使用」を選択すると、「ブラウズ」タブの「npm構成」セクションにこの情報が表示されます。
    npm-use-npm-login-manually.png
    1. コピーをクリックして、「デフォルト」タブ(スコープ付きパッケージとスコープなしパッケージの両方をプッシュする場合)または「スコープ」タブ(特定のスコープ付きパッケージのみをプッシュする場合)のスニペットをコピーします。
    2. コピーした内容をローカルの.npmrcファイルに貼り付け、保存します:
      • Windowsシステムでは、.npmrcファイルは%USERHOME/.npmrcにあります。
      • UNIXシステムでは、ファイルのロケーションは~/.npmrcです。
    3. コピーをクリックして、指定されたnpm loginコマンド(すべてのスコープ付きパッケージおよびスコープなしパッケージの場合)またはnpm login --scope=@scope<scope>コマンド(スコープ付きパッケージの場合のみ)をコピーします。
    4. コピーしたコマンドをコマンドラインに貼り付けて実行します。 必要に応じてスコープを変更し、入力を求められたらVB Studioログイン資格証明を指定します。

      VB Studioは個人アクセス・トークンを生成し、生成されたトークンを含むレスポンスをNPMクライアントが受信すると、それを.npmrcファイルに追加します。 このプロセスは、拡張不可能なトークンを生成します。

      トークンの詳細は、ユーザー「プリファレンス」の下の「個人アクセス・トークン」タブで確認できます。 トークンを選択し、「基本の詳細」および「スコープ」タブで情報を表示します。

パスワードを変更するまでトークンは有効なままです。 また、そのトークンを使用してログインしているマシンでログアウトすることによって、単一のトークンを無効にすることもできます。