Questions fréquentes (FAQ) sur NuGet.org

Termes du contrat de licence

Quels sont les termes du contrat de licence si un package ne fournit pas des informations de licence spécifiques ?

Chaque package est régi par les conditions qu’il inclut. Vous devez examiner les conditions applicables avant d’accéder à des packages, d’en télécharger ou d’en acquérir. Sur NuGet.org, utilisez le lien License Info (Informations de licence) sur la page des packages.

Si un package ne spécifie pas les termes du contrat de licence, contactez le propriétaire du package directement à l’aide du lien Contact owners (Contacter les propriétaires) sur la page des packages NuGet.org. Microsoft ne vous concède aucune licence de propriété intellectuelle de fournisseurs de packages tiers et n’est pas responsable des informations fournies par des tiers.

Gestion des packages sur NuGet.org

Puis-je modifier les métadonnées d’un package après l’avoir chargé ?

NuGet recommande de signer tous les packages. Un principe de conception de la signature du package est que le contenu du package signé doit être immuable, ce qui comprend le fichier nuspec. Modifier les métadonnées du package entraîne des modifications du fichier nuspec, invalidant les signatures existantes. Nous vous recommandons de modifier les flux de travail existants de manière à ce qu’il ne soit pas nécessaire de modifier les métadonnées du package une fois ce dernier créé.

Notez que les dépendances répertoriées pour votre package sont générées automatiquement à partir du package lui-même et qu’elles ne peuvent pas être modifiées.

De plus, le chargement d’un package sur int.nugettest.org constitue un excellent moyen de le tester et de le valider sans le mettre à disposition dans la galerie publique. Point de terminaison d’API : https://apiint.nugettest.org/v3/index.json

Puis-je supprimer un package déjà publié sur NuGet.org ?

En général, nous ne prenons pas en charge la suppression d’un package publié dans NuGet.org. En savoir plus sur notre stratégie de suppression de packages.

Est-il possible de réserver les noms des packages qui doivent être publiés à l’avenir ?

Oui. Vous pouvez réserver des ID pour les packages sur NuGet.org en demandant un préfixe d’ID de package pour votre compte. Pour demander un préfixe d’ID de package, suivez les instructions de la documentation.

Comment puis-je revendiquer la propriété de packages ?

Comment négocier avec un propriétaire de package qui viole ma licence de logiciel ?

Nous invitons la communauté NuGet à collaborer afin de résoudre les litiges pouvant survenir entre les propriétaires de packages et les propriétaires d’autres logiciels. Nous avons conçu un processus de résolution des litiges à suivre avant de demander aux administrateurs de NuGet.org d’intervenir.

Est-il recommandé de charger mes packages de test sur NuGet.org ?

À des fins de test, vous pouvez utiliser int.nugettest.org ou d’autres serveurs NuGet publics, comme myget.org ou Azure DevOps.

Notez que les packages chargés sur int.nugettest.org ne sont pas nécessairement conservés.

Quelle est la taille maximale des packages que je peux charger sur NuGet.org ?

La taille maximale de package autorisée par NuGet.org est de 250 Mo, mais nous vous recommandons de limiter la taille des packages à 1 Mo maximum si possible et de les lier à l’aide de dépendances. En règle générale, les packages contiennent un seul assembly pour éviter les collisions.

NuGet utilisant HTTP pour télécharger les packages, l’installation d’un package risque d’autant plus d’échouer que celui-ci est volumineux.

Vous pouvez partager des dépendances entre plusieurs packages, pour réduire la taille totale du téléchargement pour les consommateurs de vos packages NuGet.

Les dépendances sont principalement statiques et ne changent jamais. Quand vous résolvez un bogue dans le code, il peut s’avérer superflu de mettre à jour les dépendances. Si vous regroupez des dépendances, vous finissez systématiquement par relivrer des packages plus volumineux. Si vous fractionnez les packages NuGet en dépendances connexes, les mises à niveau sont beaucoup plus précises pour les consommateurs de votre package.

NuGet.org inaccessible

Quelles sont les suites de chiffrement et les versions de SSL/TLS prises en charge par NuGet.org ?

NuGet.org prend en charge TLS 1.2 et les suites de chiffrement suivantes :

  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

Pourquoi ne puis-je pas restaurer des packages à partir de NuGet.org ?

Si vous rencontrez des échecs temporaires lors de la restauration de packages à partir de NuGet.org, nous vous suggérons de :

  • utiliser les dernières versions des clients NuGet avec une meilleure prise en charge de la résilience.
  • utiliser des variables d’environnement des clients NuGet pour améliorer la stratégie de nouvelles tentatives sur les machines CI.
Variable d’environnement Description Notes
NUGET_ENABLE_ENHANCED_HTTP_RETRY Active ou désactive une nouvelle tentative HTTP améliorée dans NuGet. Les valeurs possibles sont true (par défaut, depuis .NET CLI 6.0.300, NuGet CLI 6.2, Visual Studio 2022 version 17.2) ou false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Configure le nombre maximal de fois où une connexion HTTP doit être retentée lorsque les tentatives améliorées sont activées. Nombre représentant le nombre de nouvelles tentatives à effectuer, la valeur par défaut est de 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Configure la durée d’attente en millisecondes avant de réessayer une connexion HTTP lorsque des tentatives améliorées sont activées. Le nombre de millisecondes à attendre par défaut est de 1000.

Remarque

Ces variables d’environnement sont disponibles depuis .NET CLI (SDK.NET) 6.0.100, NuGet CLI 6.0, Visual Studio 2022 version 17.0 et la version MSBuild correspondante. Voir Notes de publication de NuGet.

Important

NuGet.org recommande aux utilisateurs Alpine Linux de procéder à une mise à niveau vers Alpine Linux 3.18.0 ou une version ultérieure. Ces versions prennent en charge le secours TCP dans le programme de résolution DNS. Si vous utilisez des versions antérieures de Alpine Linux qui ne prennent en charge DNS que via UDP, vous pouvez être confrontés des échecs DNS lors de l’accès à l’API V3.

Si cette version du client NuGet continue à échouer, contactez le support et fournissez des informations supplémentaires pour la détection des problèmes de connexion, notamment les :

  • Sources de package que vous utilisez
  • Version du client NuGet que vous utilisez
  • Journal de restauration avec commentaires détaillés
  • MTR ou traces Fiddler (voir ci-dessous)
  • Votre zone géographique
  • Si votre machine se trouve derrière un pare-feu ou un proxy
  • Votre machine se trouve-t-elle sur le centre de données d’un fournisseur cloud (Azure, AWS, etc.) ? Si c’est le cas, indiquez le nom du fournisseur et la région.

Pour capturer MTR :

  • Téléchargez WinMTR.

  • Entrez api.nuget.org comme nom d’hôte et cliquez sur Start (Démarrer).

  • Attendez que la colonne Envoyé soit >= 100.

    Capture de MTR

  • Copiez le texte dans le Presse-papiers.

Pour capturer Fiddler :

  • Installez la version la plus récente de Fiddler.
  • Démarrez Fiddler et désactivez la capture du trafic à l’aide du menu Fichier > Capturer le trafic.
  • Supprimez toutes les sessions (sélectionnez tous les éléments de la liste, puis appuyez sur la touche Supprimer).
  • Configurez Fiddler pour capturer le trafic HTTPS en cochant Déchiffrer le trafic HTTPS sous l’onglet HTTPS du menu Outils> Options Fiddler ....
  • Fermez Visual Studio.
  • Activez le menu Fichier > Capturer le trafic.
  • Démarrez Visual Studio ou nuget.exe et effectuez les actions qui ne fonctionnent pas. Le trafic généré par ces actions doit s’afficher dans Fiddler.
  • Une fois les actions exécutées, utilisez Fichier > Enregistrer > Toutes les sessions pour stocker les sessions capturées.

Remarque : Il peut être nécessaire de définir la variable d’environnement HTTP_PROXY sur http://127.0.0.1:8888 pour router le trafic NuGet via Fiddler.

Si cette opération échoue, essayez les conseils mentionnés dans ce billet de StackOverflow.

Gestion de compte NuGet.org

Comment récupérer le mot de passe de connexion NuGet.org ?

Notez que la connexion par mot de passe à NuGet.org n’est plus disponible. Malheureusement, NuGet.org n’a aucun moyen de récupérer des comptes de mot de passe, vous pouvez vous connecter à NuGet.org uniquement via un compte Microsoft personnel (MSA) ou un compte Azure Active Directory (AAD).

Si vous ne parvenez pas à utiliser la connexion Microsoft, suivez les étapes pour récupérer votre compte NuGet.org.

Veuillez nous informer si vous avez besoin d’aide pour transférer la propriété de vos packages à un autre compte en envoyant un email à support@nuget.org.

Quel compte Microsoft est lié à mon compte NuGet.org ?

Si vous avez oublié quel compte Microsoft est associé à votre compte NuGet.org, effectuez les étapes ci-dessous pour obtenir de l’aide.

  1. Accédez à la page de connexion à NuGet.org, puis cliquez sur le lien Vous avez besoin d’aide pour vous connecter ?.
  2. Une boîte de dialogue contextuelle permettant d’obtenir de l’aide s’affiche alors. Effectuez les étapes décrites dans cette boîte de dialogue pour comprendre le ou les comptes Microsoft associés à votre compte NuGet.org.

Comment changer le compte Microsoft que j’utilise pour la connexion à NuGet.org ?

Si vous voulez changer le compte Microsoft de l’utilisateur NuGet.org, effectuez les étapes ci-dessous. Supposons que votre compte Microsoft avec l’adresse e-mail account1@outlook.com est associé à votre compte NuGet.org avec le nom d’utilisateur MyNuGetAccount. Vous voulez remplacer les informations de connexion par un autre compte Microsoft avec l’adresse e-mail account2@outlook.com

  1. Connectez-vous à l’aide du compte Microsoft actuellement associé, c’est-à-dire account1@outlook.com, sur la page de connexion après avoir cliqué sur Se connecter avec Microsoft.

  2. Une fois connecté, accédez à la page de vos paramètres du compte.

  3. Développez la section relative au compte de connexion. Cliquez sur le bouton Changer de compte.

  4. Vous allez maintenant être redirigé vers la page de connexion de Microsoft. Veuillez vous connecter avec le compte dont vous souhaitez changer l’association, c’est-à-dire account2@outlook.com. Remarque : Vous devrez peut-être cliquer sur Se déconnecter et se connecter avec un autre compte pendant le flux de connexion pour pouvoir vous connecter avec un autre compte Microsoft.

  5. Si vous voyez une erreur comme celle affichée ci-dessous, consultez Le compte Microsoft est lié à un autre compte NuGet.org pour plus d’informations.

    Échec de la mise à jour du compte Microsoft avec « account2@outlook.com compte2  ». Cela peut se produire s’il est déjà lié à un autre compte NuGet. Pour plus d’informations, contacter le support.

  6. Une fois que vous êtes connecté avec votre deuxième compte, vous êtes redirigé vers la page des paramètres de votre compte NuGet.org et vous devez maintenant voir le nouveau compte Microsoft associé en tant que compte de connexion. Dorénavant, vous devez utiliser ce compte quand vous vous connectez à NuGet.org.

Le compte Microsoft est lié à un autre compte NuGet.org.

Vous avez essayé de changer votre connexion Microsoft et l’erreur ci-dessous s’est affichée :

Échec de la mise à jour du compte Microsoft avec « account2@outlook.com compte2  ». Cela peut se produire s’il est déjà lié à un autre compte NuGet. Pour plus d’informations, contacter le support.

Supposons que vous tentiez de remplacer la connexion au compte Microsoft account1@outlook.com pour l’utilisateur NuGet.org avec le nom d’utilisateur MyNuGetAccount1 par un autre compte Microsoft avec l’adresse e-mail account2@outlook.com. L’erreur ci-dessus s’affiche alors.

**Que signifie l’erreur ci-dessus ?

Elle signifie qu’un autre compte NuGet.org est associé au compte Microsoft que vous essayez d’utiliser pour le remplacer ; à savoir, dans l’exemple ci-dessus, le compte Microsoft avec l’adresse e-mail <account2@outlook.com> est associé à un autre compte NuGet.org avec, par exemple, le nom d’utilisateur MyNuGetAccount2.

Vous ne pouvez pas remplacer la connexion associée par un compte Microsoft qui est lié à un autre compte NuGet.org.

J’ai oublié que j’avais un autre compte NuGet.org. Comment savoir de quel compte NuGet.org il s’agit ?

Connectez-vous avec le deuxième compte Microsoft sur la page de connexion. Vous serez connecté au compte NuGet.org qui est actuellement associé au deuxième compte Microsoft. Vous pouvez alors afficher les packages chargés et effectuer la gestion de compte sur ce compte.

Ce deuxième compte NuGet.org ne m’intéresse pas. Je souhaite changer ma connexion pour utiliser le premier compte NuGet.org avec le deuxième compte Microsoft. Que dois-je faire ?

Vous voulez ne pas vous soucier du deuxième compte NuGet.org et quand même réutiliser le compte Microsoft associé avec l’adresse e-mail account2@outlook.com.

Vous pouvez libérer l’association entre le compte Microsoft et le compte NuGet.org en supprimant le compte NuGet.org.

  1. Effectuez les étapes permettant de supprimer l’utilisateur pour le deuxième compte NuGet.org MyNuGetAccount2.
  2. Une fois ce compte supprimé, vous pouvez retenter les étapes permettant de changer la connexion au compte Microsoft.

En fait, je m’intéresse à ce deuxième compte également. Je ne veux pas perdre ce compte, mais changer les informations de connexion de compte associé du premier compte.

Vous devrez créer/utiliser un troisième compte Microsoft, par exemple avec l’adresse e-mail account3@outlook.com.

  1. Connectez-vous d’abord avec le second compte Microsoft, account2@outlook.com sur NuGet.org. Suivez les étapes ci-dessus pour changer les connexions associées et associer le troisième compte Microsoft à ce compte NuGet.org.
  2. Une fois cela effectué, votre deuxième compte Microsoft avec l’adresse e-mail account2@outlook.com peut être associé à votre premier compte NuGet.org, MyNuGetAccount1. Effectuez les mêmes étapes ci-dessus pour changer les informations de connexion Microsoft pour le deuxième compte Microsoft.

La connexion avec un compte Microsoft me montre que mon e-mail est lié à un autre compte Microsoft

Si vous avez essayé de vous connecter avec votre compte Microsoft, par exemple avec l’adresse e-mail account1@outlook.com et vous voyez une erreur comme celle ci-dessous :

Le compte avec l’e-mail « account1@outlook.com » est lié à un autre compte Microsoft.

Si vous voulez mettre à jour le compte Microsoft lié, vous pouvez le faire à partir de la page des paramètres du compte.

Que signifie l’erreur ci-dessus ?

Quand un compte est créé sur NuGet.org, une adresse e-mail de communication lui est associée. Elle est généralement identique à l’adresse e-mail utilisée pour le compte Microsoft associé. Toutefois, vous pouvez choisir de spécifier une autre adresse e-mail pour la communication. Par conséquent, techniquement, vous pouvez avoir un autre compte Microsoft, par exemple avec account2@outlook.com, lié à un compte NuGet.org ayant l’adresse e-mail de communication account1@outlook.com.

L’erreur ci-dessus signifie donc qu’il existe déjà un compte NuGet.org avec l’adresse e-mail de communication account1@outlook.com, mais qu’il est associé à un autre compte Microsoft avec une adresse e-mail qui n’est pas account1@outlook.com.

Comment savoir quel compte Microsoft est lié à ce compte NuGet.org ?

Vous devez utiliser le flux d’aide relative à la connexion pour déterminer quel compte Microsoft est lié au compte NuGet.org avec l’adresse e-mail account1@outlook.com.

Impossible d’utiliser la connexion Microsoft, comment faire pour récupérer mon compte NuGet.org ?

Si vous avez essayé d’utiliser l’aide relative à la connexion et que vous n’avez pas accès au compte Microsoft associé à votre compte NuGet.org, veuillez contacter le support de votre compte Microsoft :

Comment transformer mon compte NuGet.org en compte d’organisation ?

Si vous voulez transformer votre compte en compte d’organisation, effectuez les étapes indiquées dans la documentation concernant les comptes d’organisation sur nuget.org.

Vous rencontrez des problèmes de connexion à NuGet.org pour les comptes AAD avec un propriétaire non managé ?

Si vous voyez une erreur comme celle affichée ci-dessous pendant votre flux de connexion avec votre domaine de comptes de messagerie (@votredomaine.com), consultez les étapes suivantes pour récupérer votre compte NuGet.org.

Erreur lors de la connexion des comptes AAD

À quoi correspond cet état non managé pendant la connexion ? Et pourquoi cela se produit-il à ce moment-là ?

Votre compte semble avoir été précédemment inscrit en tant que compte Microsoft personnel et cela fonctionnait correctement. Toutefois, il semble que votre compte a maintenant été inscrit en tant que locataire « non managé » dans Azure Active Directory (service d’identité que nous utilisons pour authentifier les comptes Microsoft).

Cela a pu se produire si vous ou une personne de votre organisation (avec l’adresse e-mail @yourdomain.com) vous êtes inscrit auprès de l’un des services intégrés AAD ou si vous avez effectué une inscription en libre-service pour Azure Active Directory, qui crée un tel locataire « non managé » pour le domaine de compte Microsoft utilisé ( @votredomaine.com dans votre cas).

Que puis-je faire pour récupérer mon compte ?

Pour le moment, nous (NuGet.org) ne disposons d’aucun moyen pour authentifier les comptes avec de tels comptes de locataires « non managés » dans Azure Active directory. Nous recherchons un meilleur moyen d’authentifier ces comptes.

Si vous voulez vous connecter à NuGet.org avec votre compte Microsoft (@votredomaine.com), vous (ou un administrateur de votre entreprise) devez revendiquer la propriété des comptes AAD en effectuant une validation DNS afin d’authentifier les utilisateurs avec l’adresse e-mail « @votredomaine.com ». Suivez les étapes permettant la prise de contrôle des administrateurs de domaines documentées par Azure Active Directory. Une fois cela effectué, votre connexion normale doit commencer à fonctionner.

Comment changer mon nom d’utilisateur de compte NuGet.org ?

Vous pouvez demander une modification de nom d’utilisateur en envoyant un email à support@nuget.org partir de l’adresse e-mail attachée au compte à mettre à jour. Veillez à inclure l’ancien nom d’utilisateur et le nouveau nom d’utilisateur que vous avez choisi. Nous allons ensuite examiner votre demande et, lors de l’approbation. Nous vous demanderons de confirmer que nous sommes sur le point de prendre les mesures appropriées et que vous en comprenez les conséquences. Une fois la confirmation donnée, nous modifierons votre nom d’utilisateur.

Important

  • L’ancien nom d’utilisateur sera toujours réservé. Vous ne pourrez pas réutiliser l’ancien nom d’utilisateur, y compris en en changeant la casse.
  • Par conséquent, nous ne pourrons pas revenir en arrière nous non plus.
  • Les liens vers la page de profil de votre ancien nom d’utilisateur (par exemple https://www.nuget.org/profiles/OldUsername) ne seront pas redirigés vers votre nouveau profil.
  • Les versions de package actuellement détenues par votre compte contiennent toujours l’ancien nom d’utilisateur dans la signature du référentiel. Les nouvelles versions de package contiennent le nouveau nom d’utilisateur.
  • Les métadonnées fournies par l’auteur dans les versions de package existantes faisant référence à l’ancien nom d’utilisateur ou à d’autres informations d’identification ne seront pas modifiées non plus.
  • Les stratégie de client NuGet visant à confirmer la confiance de votre ancien nom d’utilisateur ne rendra pas implicitement vos package publié avec votre nouveau nom comme de confiance. Les consommateurs de packages avec ces stratégies clientes configurées doivent les mettre à jour manuellement pour approuver votre nouveau nom d’utilisateur lorsqu’ils tentent de mettre à jour vers une version de package nouvellement publiée.

Comment supprimer mon compte NuGet.org ?

Pour supprimer votre compte, notez que nous vous recommandons de transférer la propriété de tous les packages dont vous êtes l’unique propriétaire. Pour savoir comment procéder, lisez la section relative à la gestion des propriétaires de packages. Cela nous permettra également d’accélérer votre demande.

Si vous envisagez de transformer votre compte en organisation, suivez les étapes indiquées dans transformer mon compte NuGet.org en organisation.

Important

La suppression de l’utilisateur a les conséquences suivantes :

  1. Votre nom d’utilisateur sera réservé et personne ne pourra l’utiliser à nouveau pour créer un compte individuel ou un compte d’organisation
  2. Révocation des clés API associées.
  3. Suppression du compte en tant que propriétaire des packages enfants.
  4. Dissociation de toutes les réservations de préfixe d’ID précédemment existantes avec ce compte.
  5. Suppression du compte en tant que membre d’une organisation.

Effectuez les étapes suivantes pour procéder à la suppression du compte.

  1. Connectez-vous à NuGet.org avec le compte que vous voulez supprimer.
  2. Cliquez sur l’URL https://www.nuget.org/account/delete, puis effectuez les étapes permettant de soumettre la demande de suppression du compte.

Notre service clientèle traitera cette demande et effectuera la suppression du compte.

Que se passe-t-il pour mon compte NuGet.org lorsque mon compte Microsoft est supprimé ?

Lorsque le compte Microsoft ou le compte Azure Active Directory que vous utilisez pour vous connecter à votre compte nuget.org est supprimé, votre compte de nuget.org est également supprimé. L’action de suppression de compte est effectuée par le service clientèle nuget.org dans les 30 jours suivant la date de suppression du compte Microsoft.

Si vous avez des packages associés à votre compte, nous vous avertirons 3 jours ouvrables avant la suppression. Nous vous proposerons de l’aide pour transférer les packages vers un autre compte nuget.org.