NuGet 認証情報プロバイダーを通じた Visual Studio でのフィード認証

NuGet Visual Studio Extension 3.6 以降では、認証情報プロバイダーをサポートしています。そのプロバイダーを使用すると、NuGet で認証済みフィードを操作できます。 Visual Studio 用の NuGet 認証情報プロバイダーをインストールすると、必要に応じて、認証されたフィードの認証情報が NuGet Visual Studio 拡張情報によって自動的に取得および更新されます。

サンプル実装は VsCredentialProvider サンプルにあります。

Visual Studio 内では、NuGet はプラグイン認証情報プロバイダーもスキャンする内部VsCredentialProviderImporterを使用します。 これらのプラグイン資格情報プロバイダーは、種類IVsCredentialProviderの MEF エクスポートとして検出可能であることが必要です。

Visual Studio の 4.8 以降の NuGet では、新しいクロスプラットフォーム認証プラグインもサポートされていますが、これらはパフォーマンス上の理由から、おすすめのアプローチではありません。

Visual Studio 向け NuGet 認証情報プロバイダーの作成

NuGet Visual Studio Extension 3.6 以降では、認証情報の取得に使用される内部の CredentialService が実装されています。 CredentialService には、組み込みおよびプラグインの認証情報プロバイダーのリストがあります。 各プロバイダーは、認証情報が取得されるまで、順番に試行されます。

認証情報の取得中に、認証情報サービスは次の順序で認証情報プロバイダーを試していき、認証情報が取得されるとすぐに停止します。

1. 認証情報は、NuGet 構成ファイル (組み込みのSettingsCredentialProviderを使用) からフェッチされます。
2. パッケージ ソースが Visual Studio Team Services 上にある場合は、そのVisualStudioAccountProviderが使用されます。
3. 他のすべてのプラグイン Visual Studio 認証情報プロバイダーが、順番に試行されます。
4. すべての NuGet クロス プラットフォーム認証情報プロバイダーを、順番に使用してみてください。
5. 認証情報の取得がまだの場合は、標準の基本認証ダイアログを使用して認証情報を入力するよう求められます。

IVsCredentialProvider.GetCredentialsAsync の実装

Visual Studio 用の NuGet 認証情報プロバイダーを作成するには、型を実装する IVsCredentialProvider パブリック MEF エクスポートを公開し、以下に示す原則に従う Visual Studio 拡張情報を作成します。

public interface IVsCredentialProvider
{
    Task<ICredentials> GetCredentialsAsync(
        Uri uri,
        IWebProxy proxy,
        bool isProxyRequest,
        bool isRetry,
        bool nonInteractive,
        CancellationToken cancellationToken);
}

サンプル実装は VsCredentialProvider サンプルにあります。

Visual Studio 向け NuGet 認証情報プロバイダー

1. 資格情報の取得を開始する前に、ターゲット URI の資格情報を提供できるかどうかを判断します。 プロバイダーがターゲット ソースの認証情報を提供できない場合は、nullが返されます。
2. プロバイダーが対象 URI の要求を処理しているが認証情報を指定できない場合は、例外をスローする必要があります。

Visual Studio 用のカスタム NuGet 認証情報プロバイダーは、NuGet.VisualStudio パッケージで使用できるIVsCredentialProviderインターフェイスを実装する必要があります。

GetCredentialAsync

戻り値: System.Net.ICredentialsインターフェイスを実装する認証情報オブジェクト。