Domande frequenti su NuGet.org

Condizioni di licenza

Quali sono le condizioni di licenza predefinite se un pacchetto non include informazioni di licenza specifiche?

Ogni pacchetto è disciplinato dalle condizioni incluse nel pacchetto. È necessario leggere le condizioni applicabili prima di accedere, scaricare o acquisire qualsiasi pacchetto. In NuGet.org, usare il collegamento License Info (Informazioni di licenza) nella pagina del pacchetto.

Se per un pacchetto non sono specificate le condizioni di licenza, contattare il proprietario del pacchetto direttamente usando il collegamento Contact owners (Contatta proprietari) nella pagina del pacchetto su NuGet.org. Microsoft non concede in licenza all'utente alcuna proprietà intellettuale dei provider di pacchetti di terze parti e non è responsabile delle informazioni fornite da terze parti.

Gestione dei pacchetti in NuGet.org

È possibile modificare i metadati del pacchetto dopo che è stato caricato?

NuGet consiglia che tutti i pacchetti siano firmati. Uno dei principi di progettazione della firma dei pacchetti è che il contenuto del pacchetto firmato non deve essere modificabile e ciò include il file nuspec. La modifica dei metadati del pacchetto comporta modifiche al file nuspec, invalidando le firme esistenti. Si consiglia di modificare i flussi di lavoro esistenti in modo da non richiedere la modifica dei metadati del pacchetto dopo aver creato il pacchetto.

Si noti che le dipendenze elencate per il pacchetto vengono generate automaticamente dal pacchetto stesso e non possono essere modificate.

Il caricamento dei pacchetti in int.nugettest.org è anche un ottimo modo per testare e convalidare il pacchetto senza rendere disponibile un pacchetto nella raccolta pubblica. Endpoint API: https://apiint.nugettest.org/v3/index.json

È possibile eliminare un pacchetto pubblicato in NuGet.org?

In generale, non è supportata l'eliminazione di un pacchetto pubblicato in NuGet.org. Altre informazioni sui criteri per l'eliminazione dei pacchetti.

È possibile riservare i nomi per pacchetti che verranno pubblicati in futuro?

Sì. È possibile riservare ID per i pacchetti in NuGet.org richiedendo un prefisso per l'ID dei pacchetti per l'account. Per richiedere un prefisso per l'ID dei pacchetti, seguire le istruzioni nella documentazione.

Come è possibile richiedere la proprietà per i pacchetti?

Qual è la procedura per gestire il caso di un proprietario di pacchetto che viola una licenza di software?

Microsoft incoraggia la collaborazione tra i membri della community di NuGet per risolvere eventuali controversie tra i proprietari di pacchetti e i proprietari di altro software. È stato elaborato un processo di risoluzione delle controversie da seguire prima di chiedere l'intercessione degli amministratori di NuGet.org.

È consigliabile caricare i pacchetti di test in NuGet.org?

A scopo di test, è possibile usare int.nugettest.org o server NuGet pubblici alternativi, come myget.org o Azure DevOps.

Si noti che i pacchetti caricati in int.nugettest.org potrebbero non essere mantenuti.

Quali sono le dimensioni massime per i pacchetti che è possibile caricare in NuGet.org?

NuGet.org consente pacchetti fino a 250 MB, ma è consigliabile mantenere dimensioni inferiori a 1 MB per i pacchetti se possibile e usare le dipendenze per collegare i pacchetti. Come regola generale, i pacchetti contengono un solo assembly per evitare conflitti.

NuGet usa HTTP per scaricare i pacchetti, pertanto per i pacchetti di dimensioni maggiori sono più probabili errori di installazione rispetto a quelli più piccoli.

È possibile condividere le dipendenze tra più pacchetti, riducendo le dimensioni totali del download per i consumer dei pacchetti NuGet.

Le dipendenze sono prevalentemente statiche e non cambiano mai. Quando si corregge un bug nel codice, è possibile che non occorra aggiornare le dipendenze. Se si aggregano le dipendenze, alla fine diventa necessario ripubblicare ogni volta pacchetti più grandi. Suddividendo i pacchetti NuGet in dipendenze correlate, gli aggiornamenti sono molto più selezionati per i consumer del pacchetto.

NuGet.org non accessibile

Quali pacchetti di crittografia e versione SSL/TLS supportano NuGet.org?

NuGet.org supporta TLS 1.2 e le suite di crittografia seguenti:

  • 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

Perché non è possibile ripristinare i pacchetti da NuGet.org?

Se si verificano errori temporanei durante il ripristino dei pacchetti da NuGet.org, è consigliabile:

  • usare le versioni più recenti dei client NuGet con un supporto migliore per la resilienza.
  • usare le variabili di ambiente dei client NuGet per migliorare i criteri di ripetizione dei tentativi nei computer CI.
Variabile di ambiente Descrizione Note
NUGET_ENABLE_ENHANCED_HTTP_RETRY Abilita o disabilita i tentativi HTTP avanzati in NuGet. I valori possibili sono true (impostazione predefinita dall'interfaccia della riga di comando di .NET 6.0.300, dall'interfaccia della riga di comando di NuGet 6.2, Visual Studio 2022 versione 17.2) o false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Configura il numero massimo di tentativi di una connessione HTTP quando sono abilitati nuovi tentativi avanzati. Numero che rappresenta il numero di tentativi da eseguire, il valore predefinito è 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Configura la quantità di tempo di attesa in millisecondi prima di ritentare una connessione HTTP quando sono abilitati nuovi tentativi avanzati. Numero di millsecondi da attendere, il valore predefinito è 1000.

Nota

Queste variabili di ambiente sono disponibili dall'interfaccia della riga di comando di .NET (.NET SDK) 6.0.100, dall'interfaccia della riga di comando di NuGet 6.0, Visual Studio 2022 versione 17.0 e dalla versione corrispondente di MSBuild. Vedere Note sulla versione di NuGet.

Importante

NuGet.org consiglia agli utenti di Alpine Linux di eseguire l'aggiornamento a Alpine Linux 3.18.0 o versione successiva. Queste versioni supportano il fallback TCP nel resolver DNS. Se si usano versioni precedenti di Alpine Linux che supportano solo DNS su UDP, è possibile che si verifichino errori DNS durante l'accesso all'API V3.

Se la versione del client NuGet continua a non riuscire, contattare il supporto tecnico e fornire informazioni aggiuntive sulla risoluzione dei problemi di connessione, tra cui:

  • Origini dei pacchetti in uso
  • Versione del client NuGet in uso
  • Log di ripristino con livello di dettaglio massimo
  • Tracce MTR o Fiddler (vedere più avanti)
  • Area geografica
  • Se il computer è protetto da proxy o firewall
  • Se il computer si trova nel data center di un provider di servizi cloud (Azure, AWS e così via) In caso affermativo, specificare il nome del provider e l'area.

Per acquisire una traccia MTR:

  • Scaricare WinMTR.

  • Immettere api.nuget.org come nome host e fare clic su Start (Avvia).

  • Attendere fino a quando la colonna Inviata è >= 100.

    Acquisizione di una traccia MTR

  • Copiare il testo negli Appunti.

Per acquisire una traccia Fiddler:

  • Installare la versione più recente di Fiddler.
  • Avviare Fiddler e disabilitare l'acquisizione del traffico usando il menu Traffico di acquisizione file>.
  • Rimuovere tutte le sessioni (selezionare tutti gli elementi nell'elenco e premere CANC).
  • Configurare Fiddler per acquisire il traffico HTTPS controllando Decrittografare il traffico HTTPS nella scheda HTTPS del menu Strumenti > Opzioni fiddler... .
  • Chiudere Visual Studio.
  • Abilitare il menu File Capture Traffic (Traffico di acquisizione file>).
  • Avviare Visual Studio o nuget.exe ed eseguire le azioni che non funzionano. Il traffico generato da queste azioni dovrebbe essere visualizzato in Fiddler.
  • Dopo l'esecuzione delle azioni, usare Salva > > tutte le sessioni per archiviare le sessioni acquisite.

Nota: può essere richiesto di impostare la variabile di ambiente HTTP_PROXY su http://127.0.0.1:8888 per il routing del traffico NuGet attraverso Fiddler.

Se il problema persiste, provare i suggerimenti indicati in questo post di StackOverflow.

Gestione degli account di NuGet.org

Come si recupera l'accesso tramite password di NuGet.org?

Si noti che l'account di accesso NuGet.org password non è più disponibile. Sfortunatamente, NuGet.org non ha modo di ripristinare gli account password, è possibile accedere solo a NuGet.org con un account Microsoft personale (MSA) o Azure Active Directory (AAD).

Se non è possibile usare l'account di accesso Microsoft, seguire la procedura per ripristinare l'account NuGet.org.

Inviare un messaggio di posta elettronica a support@nuget.org.

Quale account Microsoft è collegato all'account di NuGet.org?

Se non si ricorda a quale account Microsoft è associato l'account di NuGet.org, seguire questa procedura per ottenere assistenza.

  1. Passare alla pagina di accesso di NuGet.org e fare clic sul collegamento Need assistance signing in? (Serve assistenza per l'accesso?).
  2. Verrà visualizzata la finestra di dialogo popup di assistenza. Seguire i passaggi descritti in questa finestra di dialogo per risalire all'account o gli account Microsoft associati all'account di NuGet.org.

Come si cambia l'account Microsoft usato per l'accesso a NuGet.org?

Se si vuole cambiare l'account Microsoft per l'utente di NuGet.org, seguire questa procedura. Si supponga che l'account Microsoft con indirizzo di posta elettronica account1@outlook.com sia associato all'account di NuGet.org con nome utente MyNuGetAccount. Si vuole cambiare l'account di accesso con un altro account Microsoft con indirizzo di posta elettronica account2@outlook.com

  1. Accedere usando l'account Microsoft attualmente associato, vale a dire account1@outlook.com, nella pagina di accesso dopo aver fatto clic su Sign in with Microsoft (Accedi con Microsoft).

  2. Dopo l'accesso, passare alla pagina Account settings (Impostazioni account).

  3. Espandere la sezione Login Account (Account di accesso). Fare clic sul pulsante Change Account (Cambia account).

  4. Verrà effettuato il reindirizzamento alla pagina di accesso Microsoft. Accedere con l'account che si vuole modificare l'associazione, ad esempio account2@outlook.com. Nota: potrebbe essere necessario fare clic su Disconnetti e accedere con un account diverso durante il flusso di accesso per poter accedere con un account Microsoft diverso.

  5. Se viene visualizzato un errore simile a quello riportato di seguito, vedere L'account Microsoft è collegato a un altro account di NuGet.org per altri dettagli.

    Impossibile aggiornare l'account Microsoft con 'account2 account2@outlook.com'. This could happen if it is already linked to another NuGet account. Contatta il supporto per ulteriori informazioni.

  6. Dopo l'accesso con il secondo account, verrà effettuato il reindirizzamento alla pagina Account settings (Impostazioni account) di NuGet.org. Come account di accesso è ora associato il nuovo account Microsoft. D'ora in avanti sarà necessario usare questo account per l'accesso a NuGet.org.

L'account Microsoft è collegato a un altro account di NuGet.org.

Se si è tentato di cambiare l'account di accesso Microsoft ed è stato visualizzato l'errore seguente:

Impossibile aggiornare l'account Microsoft con 'account2 account2@outlook.com'. This could happen if it is already linked to another NuGet account. Contatta il supporto per ulteriori informazioni.

Per l'utente di NuGet.org con nome utente MyNuGetAccount1, si supponga di aver tentato di cambiare l'account di accesso Microsoft da account1@outlook.com a un altro account Microsoft con indirizzo di posta elettronica account2@outlook.com e che sia visualizzato l'errore sopra riportato.

**Cosa significa l'errore precedente?

Significa che esiste un altro account NuGet.org account associato all'account Microsoft a cui si sta tentando di passare. Nell'esempio precedente, l'account Microsoft con indirizzo di posta elettronica <account2@outlook.com> è associato a un altro account di NuGet.org, ad esempio a un account con nome utente MyNuGetAccount2.

Non è possibile cambiare l'account di accesso associato con un account Microsoft collegato a un altro account di NuGet.org.

Se si è dimenticato di avere un altro account di NuGet.org, come è possibile sapere di quale account si tratta?

Accedere con il secondo account Microsoft nella pagina di accesso. In questo modo si accederà all'account di NuGet.org attualmente associato al secondo account Microsoft. Sarà quindi possibile visualizzare i pacchetti caricati ed eseguire operazioni di gestione di questo account.

Il secondo account di NuGet.org non serve e si vogliono cambiare i dati di accesso del primo account di NuGet.org con il secondo account Microsoft. Come si deve procedere?

Il secondo account di NuGet.org non serve e si vuole comunque riutilizzare l'account Microsoft associato con indirizzo di posta elettronica account2@outlook.com.

È possibile rilasciare l'associazione tra l'account Microsoft e l'account di NuGet.org eliminando quest'ultimo.

  1. Seguire i passaggi necessari per eliminare un utente per il secondo account di NuGet.org MyNuGetAccount2.
  2. Dopo l'eliminazione dell'account, è possibile riprovare la procedura per cambiare l'account di accesso Microsoft.

Il secondo account serve ancora e non si vuole perderlo, ma si vuole cambiare l'account di accesso associato al primo account.

È necessario creare o usare un terzo account Microsoft, ad esempio con indirizzo di posta elettronica account3@outlook.com.

  1. Prima di tutto è necessario accedere con il secondo account Microsoft, account2@outlook.com in NuGet.org. Seguire i passaggi precedenti per modificare gli account di accesso associati e associare il terzo account Microsoft a questo account NuGet.org.
  2. Al termine, il secondo account Microsoft con indirizzo di posta elettronica account2@outlook.com è libero e può essere associato al primo account di NuGet.org, MyNuGetAccount1. Seguire gli stessi passaggi per cambiare l'account di accesso Microsoft per il secondo account Microsoft.

Se si accede con l'account Microsoft, si può vedere che l'indirizzo di posta elettronica è collegato a un altro account Microsoft

Se si è tentato di accedere con l'account Microsoft, ad esempio con quello con indirizzo di posta elettronica account1@outlook.com e viene visualizzato un errore simile al seguente:

The account with email 'account1@outlook.com' is linked with another microsoft account.

If you would like to update the linked Microsoft account you can do so from the account settings page. (L'account con email 'account1@outlook.com' è collegato a un altro account Microsoft. Se si vuole aggiornare l'account Microsoft collegato, è possibile farlo dalla pagina Impostazioni account)

Che cosa significa l'errore sopra riportato?

Quando viene creato un account in NuGet.org, a tale account è associato un indirizzo di posta elettronica di comunicazione. Si tratta in genere dello stesso indirizzo di posta elettronica usato per l'account Microsoft associato. È tuttavia possibile scegliere per la comunicazione un altro indirizzo di posta elettronica. Tecnicamente, quindi, è possibile avere un account Microsoft diverso, ad esempio con account2@outlook.com, collegato all'account di NuGet.org con indirizzo di posta elettronica di comunicazione account1@outlook.com.

L'errore precedente indica quindi che esiste già NuGet.org account con indirizzo account1@outlook.com di posta elettronica di comunicazione, ma è associato a un altro account Microsoft con posta elettronica che non account1@outlook.comè .

Come è possibile scoprire quale account Microsoft è collegato a un account di NuGet.org?

È consigliabile usare il flusso di assistenza all'accesso per determinare quale account Microsoft è collegato all'account di NuGet.org con l'indirizzo di posta elettronica account1@outlook.com.

Non è possibile usare l'account di accesso Microsoft, come si ripristina l'account NuGet.org?

Se si è provato a usare l'assistenza per l'accesso e non si ha accesso all'account Microsoft associato all'account NuGet.org, contattare il supporto dell'account Microsoft:

Come è possibile trasformare l'account di NuGet.org in un'organizzazione?

Se si vuole trasformare l'account in un'organizzazione, seguire la procedura descritta nella documentazione per le organizzazioni su nuget.org.

Problemi di accesso a NuGet.org per gli account AAD con tenant non gestito

Se viene visualizzato un errore simile al seguente durante il flusso di accesso con l'account di posta elettronica domain(@yourdomain.com), vedere la procedura seguente per ripristinare l'account NuGet.org.

Errore durante l'accesso per gli account AAD

Che cos'è lo stato non gestito durante l'accesso? Perché si verifica in questa circostanza?

L'account è stato registrato in precedenza come account Microsoft personale e ha funzionato senza problemi. Ora, tuttavia, sembra che sia stato registrato come tenant "non gestito" in Azure Active Directory (il servizio di gestione delle identità usato per autenticare gli account Microsoft).

Ciò potrebbe verificarsi se l'utente o un utente dell'organizzazione (con @yourdomain.com indirizzo di posta elettronica) registrato con uno dei servizi integrati di AAD o ha eseguito un'iscrizione self-service per Azure Active Directory, che crea un tenant "Non gestito" per l'account Microsoft usato domain(@yourdomain.com nel tuo caso).

Cosa si può fare per recuperare l'account?

In questo momento NuGet.org non è in grado di autenticare gli account con tali account tenant "non gestiti" in Azure Active Directory. È in corso la ricerca di un modo più efficiente di autenticare tali account.

Se si vuole accedere a NuGet.org con microsoft account(@yourdomain.com), l'utente o un amministratore dell'azienda dovrà richiedere la proprietà di AAD eseguendo una convalida DNS per autenticare gli utenti con l'indirizzo di posta elettronica "@yourdomain.com". Seguire la procedura per l'acquisizione come amministratore di domini documentata da Azure Active Directory. Dopo l'esecuzione della procedura, l'accesso normale inizierà a funzionare.

Come si cambia il nome utente dell'account di NuGet.org?

È possibile richiedere una modifica del nome utente inviando un messaggio di posta elettronica all'indirizzo support@nuget.org di posta elettronica allegato all'account da aggiornare. Assicurarsi di includere il nome utente precedente e il nuovo nome utente in cui si vuole passare. Esamineremo quindi la richiesta e, dopo l'approvazione, riceveremo conferma dall'utente che stiamo per intraprendere l'azione corretta e che tu comprenda le conseguenze. Una volta confermato, il nome utente verrà modificato.

Importante

  • Il vecchio nome utente verrà comunque riservato. Non sarà possibile riutilizzare di nuovo il vecchio nome utente e ciò include la modifica delle maiuscole e minuscole.
  • Di conseguenza, non saremo in grado di ripristinare questa modifica.
  • Tutti i collegamenti alla pagina del profilo del nome utente precedente (ad esempio https://www.nuget.org/profiles/OldUsername) non verranno reindirizzati al nuovo profilo.
  • Le versioni dei pacchetti attualmente di proprietà dell'account conterranno il vecchio nome utente nella firma del repository. Le nuove versioni del pacchetto conterranno il nuovo nome utente.
  • Tutti i metadati forniti dall'autore nelle versioni del pacchetto esistenti che fanno riferimento al nome utente precedente o ad altre informazioni di identificazione non verranno modificati.
  • I criteri client NuGet che asserisce l'attendibilità del vecchio nome utente non considerano attendibili in modo implicito i pacchetti pubblicati dal nuovo nome utente. I consumer di pacchetti con questi criteri client configurati dovranno aggiornarli manualmente per considerare attendibile il nuovo nome utente quando tentano di eseguire l'aggiornamento a una versione del pacchetto appena pubblicata.

Come si elimina l'account di NuGet.org?

Per eliminare l'account, si noti che è consigliabile trasferire la proprietà di tutti i pacchetti di cui l'account da eliminare è l'unico proprietario. Altre informazioni sulla gestione dei proprietari dei pacchetti e su come eseguire questa operazione. Ciò risulta utile anche per accelerare la richiesta.

Se si desidera trasformare l'account in un'organizzazione, seguire la procedura descritta in Trasformare l'account personale di NuGet.org in un'organizzazione.

Importante

L'eliminazione dell'utente avrà i risultati seguenti:

  1. Il nome utente sarà riservato e nessuno potrà riutilizzarlo per creare un account personale o un account dell'organizzazione.
  2. Revoca delle chiavi API associate.
  3. Rimozione dell'account come proprietario per tutti i pacchetti figlio.
  4. Annullamento dell'associazione di tutte le prenotazioni di prefisso ID esistenti in precedenza per l'account.
  5. Rimozione dell'account come membro di tutte le organizzazioni.

Seguire questi passaggi per procedere con l'eliminazione dell'account.

  1. Accedere a NuGet.org con l'account da eliminare.
  2. Fare clic sull'URL https://www.nuget.org/account/delete e seguire i passaggi per inviare la richiesta di eliminazione dell'account.

L'assistenza clienti elaborerà la richiesta ed eseguirà l'eliminazione dell'account.

Cosa accade all'account NuGet.org quando l'account Microsoft viene eliminato?

Quando l'account Microsoft o Azure Active Directory usato per accedere all'account nuget.org viene eliminato, verrà eliminato anche l'account nuget.org. L'azione di eliminazione dell'account viene completata dal supporto tecnico nuget.org entro 30 giorni dalla data di eliminazione dell'account Microsoft.

Se hai pacchetti associati al tuo account, ti informeremo 3 giorni lavorativi prima di procedere con l'eliminazione e offrire assistenza per trasferire i pacchetti a un account nuget.org diverso.