Uwierzytelnianie źródeł danych w programie Visual Studio przy użyciu dostawców poświadczeń NuGet

Rozszerzenie NuGet Visual Studio Extension 3.6+ obsługuje dostawców poświadczeń, co umożliwia nuGet pracę z uwierzytelnionymi źródłami danych. Po zainstalowaniu dostawcy poświadczeń NuGet dla programu Visual Studio rozszerzenie NuGet programu Visual Studio automatycznie uzyskaje i odświeży poświadczenia dla uwierzytelnionych źródeł danych w razie potrzeby.

Przykładową implementację można znaleźć w przykładzie VsCredentialProvider.

W programie Visual Studio pakiet NuGet używa wewnętrznego VsCredentialProviderImporter modułu, który również skanuje pod kątem dostawców poświadczeń wtyczki. Ci dostawcy poświadczeń wtyczki muszą być odnajdywalni jako eksport MEF typu IVsCredentialProvider.

Począwszy od pakietu NuGet w wersji 4.8 lub nowszej w programie Visual Studio, obsługuje również nowe wtyczki uwierzytelniania międzyplatformowego, ale nie są to zalecane podejście ze względu na wydajność.

Tworzenie dostawcy poświadczeń NuGet dla programu Visual Studio

Rozszerzenie NuGet Visual Studio Extension 3.6+ implementuje wewnętrzną usługę CredentialService używaną do uzyskiwania poświadczeń. Usługa CredentialService zawiera listę wbudowanych i wtyczki dostawców poświadczeń. Każdy dostawca jest testowany sekwencyjnie do momentu uzyskania poświadczeń.

Podczas pozyskiwania poświadczeń usługa poświadczeń spróbuje dostawców poświadczeń w następującej kolejności, zatrzymując się natychmiast po uzyskaniu poświadczeń:

1. Poświadczenia zostaną pobrane z plików konfiguracji NuGet (przy użyciu wbudowanego SettingsCredentialProviderelementu ).
2. Jeśli źródło pakietu znajduje się w usłudze Visual Studio Team Services, VisualStudioAccountProvider zostanie użyte.
3. Wszyscy inni dostawcy poświadczeń programu Visual Studio zostaną wypróbowani sekwencyjnie.
4. Spróbuj użyć wszystkich dostawców poświadczeń międzyplatformowych NuGet sekwencyjnie.
5. Jeśli poświadczenia nie zostały jeszcze uzyskane, użytkownik będzie monitowany o poświadczenia przy użyciu standardowego okna dialogowego uwierzytelniania podstawowego.

Implementowanie interfejsu IVsCredentialProvider.GetCredentialsAsync

Aby utworzyć dostawcę poświadczeń NuGet dla programu Visual Studio, utwórz rozszerzenie programu Visual Studio, które uwidacznia publiczny eksport MEF implementujący IVsCredentialProvider typ i przestrzega zasad opisanych poniżej.

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

Przykładową implementację można znaleźć w przykładzie VsCredentialProvider.

Każdy dostawca poświadczeń NuGet dla programu Visual Studio musi:

1. Ustal, czy może podać poświadczenia dla docelowego identyfikatora URI przed zainicjowanym pozyskiwaniem poświadczeń. Jeśli dostawca nie może podać poświadczeń dla docelowego źródła, powinien zwrócić wartość null.
2. Jeśli dostawca obsługuje żądania dla docelowego identyfikatora URI, ale nie może podać poświadczeń, należy zgłosić wyjątek.

Niestandardowy dostawca poświadczeń NuGet dla programu Visual Studio musi zaimplementować IVsCredentialProvider interfejs dostępny w pakiecie NuGet.VisualStudio.

GetCredentialAsync

Wartość zwracana: obiekt poświadczeń implementuje System.Net.ICredentials interfejs.