Prenotazione del prefisso dell'ID del pacchetto

Articolo
08/10/2023

I proprietari di pacchetti possono prenotare e proteggere la propria identità prenotando i prefissi ID. I consumer di pacchetti vengono forniti con informazioni aggiuntive quando i pacchetti che utilizzano non sono ingannevoli nelle proprietà di identificazione.

nuget.org e Visual Studio 2017 versione 15.4 o successive hanno un indicatore visivo per i pacchetti inviati dai proprietari con un prefisso ID di pacchetto riservato, purché il pacchetto corrisponda al criterio di denominazione del prefisso ID riservato. Il seguente riferimento spiega cosa comporta la prenotazione del prefisso ID e come un proprietario può richiedere un prefisso ID.

Dettagli della prenotazione del prefisso ID

Quando si prenota un prefisso ID del pacchetto, vengono eseguite diverse operazioni nella raccolta nuget.org, nonché in Visual Studio. Inoltre, le prenotazioni dei prefissi ID supportano scenari avanzati, ad esempio l'impostazione di un prefisso come "pubblico", con la delega di subset di prefissi a più proprietari.

Prenotazione del prefisso ID in nuget.org

Quando un prefisso viene prenotato in nuget.org, si verifica quanto segue:

Una prenotazione del prefisso è associata un proprietario o un gruppo di proprietari in nuget.org.
Ogni volta che un pacchetto viene inviato a nuget.org con un ID che corrisponde al prefisso ID riservato, il pacchetto viene rifiutato a meno che non abbia origine da proprietari che hanno prenotato il prefisso ID.
I pacchetti che corrispondono al prefisso ID riservato e hanno origine da proprietari che hanno prenotato il prefisso ID avranno un indicatore visivo in Visual Studio 2017 versione 15.4 o successive e in nuget.org per indicare che il pacchetto fa riferimento a un prefisso ID riservato. Questo vale sia per gli invii di nuovi pacchetti, sia per i pacchetti già esistenti dei proprietari. Nota: l'indicatore in Visual Studio viene visualizzato solo se è selezionato un singolo feed come origine del pacchetto.
Tutti i pacchetti già esistenti che corrispondono al prefisso ID riservato, ma non appartengono al proprietario del prefisso riservato rimangono invariati ovvero non verranno rimossi dall'elenco, ma non avranno l'indicatore visivo. Inoltre, i proprietari di questi pacchetti saranno comunque in grado di inviare nuove versioni al pacchetto.

Queste modifiche si basano sulle condizioni seguenti e impongono diverse altre restrizioni:

Solo un proprietario di un pacchetto deve avere il prefisso riservato perché sia visualizzato l'indicatore visivo (per i pacchetti con più proprietari).
Se esiste più di un proprietario per un pacchetto per cui uno o più proprietari hanno il prefisso riservato e uno o più proprietari non lo hanno, solo i proprietari con prefisso riservato possono rimuovere altri proprietari con prefisso riservato. I proprietari che non hanno il prefisso riservato non possono rimuovere i proprietari con il prefisso riservato. Possono comunque rimuovere altri proprietari che non hanno il prefisso riservato.
Se un pacchetto include l'indicatore visivo, deve sempre avere l'indicatore visivo (garantendo che almeno un proprietario con prefisso riservato rimanga sempre un proprietario)

Scenari di prenotazione avanzata del prefisso

Esistono numerosi altri scenari di prenotazione più avanzata del prefisso, tra cui la delega di prefissi secondari e il contrassegno dei prefissi come pubblici. Di seguito sono riportate le prenotazioni di prefisso più avanzate che è possibile effettuare.

Durante la prenotazione del prefisso, il proprietario può richiedere la delega di subset di prefissi (o del prefisso) ad altri proprietari. Ad esempio, se 'Microsoft' possiede 'Microsoft.*', ma 'aspnet' vuole riservare 'Microsoft.AspNet.*', 'Microsoft' può scegliere di delegare 'Microsoft.AspNet.*' all'account aspnet .
Durante la prenotazione del prefisso, il proprietario può scegliere di rendere pubblico un prefisso. In questo modo continuerà a essere disponibile l'indicatore visivo che indica che il pacchetto proviene da un prefisso riservato, ma non verranno bloccati i futuri invii di pacchetti al prefisso per qualsiasi proprietario. Ciò è utile per progetti open source a cui contribuiscono molti utenti: i collaboratori più importanti possono avere il prefisso riservato, ma il progetto rimane aperto a tutti i collaboratori.

Indicatore visivo della prenotazione del prefisso

Quando un pacchetto proviene da un prefisso riservato, nella raccolta nuget.org e in Visual Studio 2017 versione 15.4 o successive vengono visualizzati i seguenti indicatori visivi:

raccolta nuget.org nuget.org Gallery

Visual Studio

Processo di applicazione della prenotazione del prefisso ID

Esaminare i criteri di accettazione per la prenotazione del prefisso ID.
Determinare i prefissi che si vuole prenotare, oltre a eventuali scenari di prenotazione avanzata del prefisso che potrebbero essere necessari.
Inviare un messaggio a account@nuget.org con il nome del proprietario visualizzato in nuget.org, oltre a eventuali prefissi riservati che si vuole richiedere. Se si delegano subset di prefissi a più proprietari, assicurarsi di indicare tutti i nomi visualizzati dei proprietari e i subset di prefissi.

Dopo l'invio dell'applicazione si riceve una notifica di accettazione o rifiuto (con i criteri che hanno causato il rifiuto). Potrebbe essere necessario porre altre domande di identificazione per verificare l'identità del proprietario.

Criteri di prenotazione del prefisso ID

Quando si esamina un'applicazione per la prenotazione del prefisso ID, il team NuGet.org valuterà l'applicazione in base ai criteri seguenti. Si noti che non tutti i criteri devono essere soddisfatti per un prefisso da riservare, ma l'applicazione potrebbe essere negata se non sono presenti prove sostanziali dei criteri soddisfatti (con una spiegazione fornita):

Il prefisso ID del pacchetto è corretto e identifica chiaramente il proprietario della prenotazione?
Il prefisso ID del pacchetto è un elemento comune che non deve appartenere a un singolo proprietario o una sola organizzazione? Evitare prenotazioni di prefissi ID più brevi di quattro caratteri ed evitare parole comuni o generiche.
Non riservare il prefisso ID pacchetto causerebbe ambiguità, confusione o altro danno alla community?

Quando si pubblicano pacchetti in NuGet.org all'interno della prenotazione del prefisso ID, è necessario considerare le procedure consigliate seguenti:

Le proprietà di identificazione dei pacchetti che corrispondono al prefisso ID del pacchetto sono chiare e coerenti (in particolare l'autore del pacchetto)?
I pacchetti hanno una licenza (usano l'elemento dei metadati license e NON licenseUrl che sarà deprecato)?
Se i pacchetti hanno un'icona (usando l'elemento di metadati iconUrl), usano anche l'elemento dei metadati dell'icona ? Non è necessario rimuovere l'iconaUrl, ma è necessario usare le icone incorporate.

Valutare la possibilità di esaminare la guida completa alle procedure consigliate per la creazione di pacchetti oltre ai punti precedenti.

Scenari di provider di feed di terze parti

Se un provider di feed di terze parti è interessato a implementare il proprio servizio per fornire prenotazioni di prefisso, può farlo modificando il servizio di ricerca nei provider di feed NuGet V3. La modifica nel servizio di ricerca feed consiste nell'aggiungere la verified proprietà . Il client di NuGet non supporta la proprietà aggiunta nel feed V2.

Per altre informazioni, consultare la documentazione relativa al servizio di ricerca dell'API.

Criteri per le controversie relative alla prenotazione del prefisso ID del pacchetto

Se si ritiene che a un proprietario in NuGet.org sia stata assegnata una prenotazione del prefisso ID del pacchetto che non è conforme ai criteri elencati sopra o viola diritti di marchi o copyright, inviare un messaggio di posta elettronica a support@nuget.org indicando il prefisso ID in questione, il proprietario del prefisso ID e il motivo per cui si contesta la prenotazione del prefisso assegnata.