Authentification des flux dans Visual Studio avec des fournisseurs d’informations d’identification NuGet

NuGet Visual Studio Extension 3.6+ prend en charge les fournisseurs d’informations d’identification, qui permettent à NuGet d’utiliser des flux authentifiés. Après avoir installé un fournisseur d’informations d’identification NuGet pour Visual Studio, l’extension NuGet Visual Studio acquiert et actualise automatiquement les identifiants des flux authentifiés si nécessaire.

Vous trouverez un échantillon d’implémentation dans l’échantillon VsCredentialProvider.

Dans Visual Studio, NuGet utilise un élément VsCredentialProviderImporter interne qui analyse également les fournisseurs d’informations d’identification de plug-in. Ces fournisseurs d’informations d’identification de plug-in doivent être détectables en tant qu’exportation MEF de type IVsCredentialProvider.

À compter de la version 4.8+, NuGet dans Visual Studio prend également en charge les nouveaux plug-ins d’authentification multiplateforme, mais ils ne constituent pas l’approche recommandée pour des raisons de performances.

Création d’un fournisseur d’informations d’identification NuGet pour Visual Studio

NuGet Visual Studio Extension 3.6+ implémente un CredentialService interne utilisé pour acquérir des identifiants. CredentialService contient une liste de fournisseurs d’informations d’identification prédéfinis et plug-in. Chaque fournisseur est essayé séquentiellement jusqu’à ce que les identifiants soient acquis.

Lors de l’acquisition des identifiants, le service d’informations d’identification essaiera les fournisseurs d’informations d’identification dans l’ordre suivant, en s’arrêtant dès que les identifiants seront acquis :

1. Les identifiants sont extraits des fichiers de configuration NuGet (à l’aide de l’élément SettingsCredentialProvider prédéfini).
2. Si la source du package se trouve sur Visual Studio Team Services, l’élément VisualStudioAccountProvider est utilisé.
3. Tous les autres fournisseurs d’informations d’identification Visual Studio de plug-in seront essayés de manière séquentielle.
4. Essayez d’utiliser tous les fournisseurs d’informations d’identification multiplateformes NtuGet de manière séquentielle.
5. Si aucun identifiant n’a encore été acquis, l’utilisateur est invité à entrer des informations d’identification à l’aide d’une boîte de dialogue d’authentification de base standard.

Implémentation d’IVsCredentialProvider.GetCredentialsAsync

Pour créer un fournisseur d’informations d’identification NuGet pour Visual Studio, créez une extension Visual Studio qui expose une exportation MEF publique qui implémente le type IVsCredentialProvider et respecte les principes décrits ci-dessous.

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

Vous trouverez un échantillon d’implémentation dans l’échantillon VsCredentialProvider.

Chaque fournisseur d’informations d’identification NuGet pour Visual Studio doit :

1. Déterminer s’il peut fournir des identifiants pour l’URI ciblé avant de lancer l’acquisition d’informations d’identification. Si le fournisseur ne peut pas fournir d’identifiants pour la source ciblée, il doit renvoyer null.
2. Si le fournisseur gère les demandes pour l’URI ciblé, mais ne peut pas fournir d’identifiants, une exception doit être émise.

Un fournisseur d’informations d’identification NuGet personnalisé pour Visual Studio doit implémenter l’interface IVsCredentialProvider disponible dans le package NuGet.VisualStudio.

GetCredentialAsync

Valeur de retour : objet d’identifiants implémentant l’interface System.Net.ICredentials.