Rezervace předpony ID balíčku
Vlastníci balíčků si můžou rezervovat a chránit svou identitu tím, že si zarezervují předpony ID. Příjemci balíčků jsou k dispozici s dalšími informacemi, pokud balíčky, které využívají, nejsou v jejich identifikaci vlastností náchylné.
nuget.org a Visual Studio 2017 verze 15.4 nebo novější zobrazují vizuální indikátor balíčků odesílaných vlastníky s předponou vyhrazeného ID balíčku, pokud balíček odpovídá vzoru pojmenování předpony rezervovaných ID. Následující odkaz vysvětluje, co rezervace předpon ID zahrnuje a jak může vlastník požádat o předponu ID.
Podrobnosti rezervace předpony ID
Když je vyhrazena předpona ID balíčku, stane se v galerii nuget.org i v sadě Visual Studio několik věcí. Kromě toho existují pokročilé scénáře, které jsou podporovány rezervacemi předpon ID, jako je například nastavení předpony jako veřejné, delegování podmnožina předpony více vlastníkům.
Rezervace předpon ID na nuget.org
Pokud je předpona vyhrazena pro nuget.org, stane se toto:
Rezervace předpony je přidružená k vlastníkovi nebo skupině vlastníků v nuget.org.
Při každém odeslání balíčku do nuget.org s ID, které odpovídá předponě rezervovaného ID, bude balíček odmítnut, pokud nepochází od vlastníků, kteří si vyhradili předponu ID.
Každý balíček, který odpovídá předponě rezervovaného ID a pochází od vlastníků, kteří si předponu ID rezervovali, bude mít vizuální indikátor v sadě Visual Studio 2017 verze 15.4 nebo novější a v nuget.org označující, že je balíček pod předponou vyhrazeného ID. To platí pro odesílání nových balíčků i pro existující balíčky pod vlastníky. Poznámka: Indikátor v sadě Visual Studio se zobrazí pouze v případě, že je jako zdroj balíčku vybrán jeden informační kanál.
Všechny dříve existující balíčky, které odpovídají předponě rezervovaného ID, ale vlastník rezervované předpony nevlastní , zůstane beze změny (nebudou uvedené v seznamu, ale nebudou mít také vizuální indikátor). Vlastníci těchto balíčků navíc budou moct do balíčku odesílat nové verze.
Tyto změny jsou založeny na následujících podmínkách a ukládají několik dalších omezení:
Aby se zobrazila vizuální indikátor (pro balíčky s více vlastníky), musí mít vyhrazenou předponu jenom jednoho vlastníka balíčku.
Pokud existuje více než jeden vlastník balíčku, u kterého má jeden nebo více vlastníků rezervovanou předponu a jeden nebo více vlastníků nemá vyhrazenou předponu, pak pouze vlastníky s rezervovanou předponou můžou odebrat jiné vlastníky s vyhrazenou předponou. Vlastníci, kteří nemají vyhrazenou předponu, nemohou odebrat vlastníky s vyhrazenou předponou. Můžou i nadále odebírat další vlastníky, kteří nemají vyhrazenou předponu.
Jakmile má balíček vizuální indikátor, měl by mít vždy vizuální indikátor (zaručuje, že alespoň jeden vlastník s vyhrazenou předponou zůstane vždy vlastníkem).
Pokročilé scénáře rezervace předpon
Níže je popsáno několik pokročilejších scénářů rezervace předpon, včetně delegování podprefixu a označení předpon jako veřejných. Níže jsou uvedené pokročilejší rezervace předpon, které je možné provést.
Během rezervace předpony může vlastník požádat o delegování podmnožina předpon (nebo předpony) jiným vlastníkům. Pokud například microsoft vlastní Microsoft.*, ale aspnet chce rezervovat Microsoft.AspNet.*, může se rozhodnout delegovat Microsoft.AspNet.*na účet aspnet.
Během rezervace předpony se může vlastník rozhodnout, že se má předpona zveřejnit. Tím se jim stále zobrazí vizuální indikátor, který ukazuje, že balíček pochází z rezervované předpony, ale neblokuje budoucí odeslání balíčků na předponu pro jakéhokoli vlastníka. To je užitečné pro opensourcové projekty s mnoha přispěvateli – hlavní nebo základní přispěvatelé můžou mít vyhrazenou předponu, ale může být stále otevřená pro všechny přispěvatele.
Indikátor vizuálu rezervace předpony
Pokud balíček pochází z rezervované předpony, zobrazí se v galerii nuget.org a v sadě Visual Studio 2017 verze 15.4 nebo novější následující vizuální indikátory:
Galerie nuget.org
Visual Studio
Proces aplikace rezervace předpony ID
Zkontrolujte kritéria přijetí rezervace ID předpony.
Určete předpony, které si chcete rezervovat, a to kromě všech pokročilých scénářů rezervace předpon, které můžete vyžadovat.
Odešlete e-mail account@nuget.org s zobrazovaným jménem vlastníka na nuget.org a také všechny rezervované předpony, které požadujete. Pokud delegujete podmnožinu předpon více vlastníkům, nezapomeňte zmínit všechny zobrazované názvy vlastníka a podmnožinu předpon.
Po odeslání žádosti budete upozorněni na přijetí nebo odmítnutí (s kritérii, která způsobila odmítnutí). Možná budeme muset položit další identifikační otázky, abychom potvrdili identitu vlastníka.
Kritéria rezervace předpony ID
Při kontrole jakékoli aplikace pro rezervaci předpony ID tým NuGet.org aplikaci vyhodnotí podle následujících kritérií. Upozorňujeme, že není nutné splnit všechna kritéria, aby byla vyhrazena předpona, ale aplikace může být zamítnuta, pokud neexistují podstatné důkazy o splnění kritérií (s vysvětlením):
Je předpona ID balíčku správně a jasně identifikovat vlastníka rezervace?
Je předpona ID balíčku něco společného, co by nemělo patřit žádnému jednotlivému vlastníkovi nebo organizaci? Vyhněte se rezervacím předpon ID, které jsou kratší než čtyři znaky, a vyhněte se běžným nebo obecným slovům.
Nezarezervování předpony ID balíčku způsobí nejednoznačnost, nejasnost nebo jiné poškození komunity?
Při publikování balíčků do NuGet.org v rámci rezervace předpony ID je potřeba zvážit následující osvědčené postupy:
Jsou vlastnosti balíčků, které odpovídají předponě ID balíčku, jasné a konzistentní (zejména autor balíčku)?
Mají balíčky licenci (pomocí elementu metadat licence a ne licenseUrl, který je zastaralý)?
Pokud mají balíčky ikonu (pomocí elementu metadat iconUrl), používají také element metadat ikon ? Není nutné odebrat ikonuUrl, ale vložené ikony musí být použity.
Zvažte kromě výše uvedených bodů také kompletní průvodce osvědčenými postupy vytváření balíčků.
Scénáře poskytovatelů informačních kanálů třetích stran
Pokud má poskytovatel informačního kanálu třetí strany zájem o implementaci vlastní služby za účelem poskytování rezervací předpon, může to udělat úpravou vyhledávací služby v poskytovatelích informačního kanálu NuGet V3. Změnou vyhledávací služby informačního kanálu je přidání verified vlastnosti. Klient NuGet nebude podporovat přidanou vlastnost v informačním kanálu V2.
Další informace najdete v dokumentaci k vyhledávací službě rozhraní API.
Zásady sporů o rezervace předpony ID balíčku
Pokud se domníváte, že vlastníkovi NuGet.org byla přiřazena rezervace předpony ID balíčku, která překračuje výše uvedená kritéria, nebo porušuje všechny ochranné známky nebo autorská práva, pošlete e-mail support@nuget.org s danou předponou ID, vlastníkem předpony ID a důvodem pro odstranění rezervace přiřazené předpony.