Rychlý start: Nastavení podepisování artefaktů

Podepisování artefaktů je plně spravovaná komplexní služba podepisování certifikátů Microsoft. V tomto rychlém startu vytvoříte následující tři prostředky pro podepisování artefaktů, abyste mohli začít používat podepisování artefaktů.

  • Účet pro podepisování artefaktu
  • Ověření identity
  • Profil certifikátu

K vytvoření a správě většiny prostředků podepisování artefaktů můžete použít Azure portál nebo rozšíření Azure CLI. (Ověření identity můžete dokončit pouze na portálu Azure. Ověření identity nejde dokončit pomocí Azure CLI.) Tento rychlý start vám ukáže, jak na to.

Požadavky

Poznámka:

Pro certifikáty veřejné důvěry je podepisování artefaktů v současné době dostupné organizacím v USA, Kanadě, Evropské unii a Spojeném království, stejně jako jednotlivým vývojářům v USA a Kanadě. Toto omezení neplatí pro certifikáty privátní důvěryhodnosti.

K dokončení tohoto rychlého startu potřebujete:

Zaregistrujte poskytovatele prostředků pro podepisování artefaktů

Než začnete používat podepisování artefaktů, musíte zaregistrovat zprostředkovatele zdrojů podepisování artefaktů.

Poskytovatel prostředků je služba, která poskytuje Azure prostředky. Pomocí portálu Azure nebo Azure CLI zaregistrujte poskytovatele prostředků Microsoft.CodeSigning Artifact Signing.

K registraci poskytovatele prostředků pro podepisování artefaktů pomocí portálu Azure:

  1. Přihlaste se k portálu Azure.

  2. Ve vyhledávacím poli nebo v části Všechny služby vyberte Předplatná.

  3. Vyberte předplatné, ve kterém chcete vytvořit prostředky pro podepisování artefaktů.

  4. V nabídce prostředků v části Nastavení vyberte Poskytovatele prostředků.

  5. V seznamu poskytovatelů prostředků vyberte Microsoft. CodeSigning.

    Ve výchozím nastavení je stav poskytovatele prostředků NotRegistered.

Snímek obrazovky znázorňující vytvoření účtu pro podepisování artefaktů

  1. Vyberte ikonu s třemi tečkami a pak vyberte Zaregistrovat.

    Snímek obrazovky, který ukazuje poskytovatele prostředků Microsoft.CodeSigning jako registrovaného.

    Stav poskytovatele prostředků se změní na Zaregistrovaný.

Vytvoření účtu pro podepisování artefaktů

Účet podepisování artefaktů je logický kontejner, který obsahuje prostředky ověření identity a profilu certifikátu. Ověření identity je k dispozici na úrovni ID předplatného a je možné ho sdílet napříč všemi účty podepisování artefaktů v rámci daného předplatného.

Azure oblasti, které podporují podepisování artefaktů

Prostředky pro podepisování artefaktů můžete vytvářet pouze v oblastech Azure, ve kterých je služba dostupná v současné době. Následující tabulka uvádí Azure oblasti, které aktuálně podporují prostředky podepisování artefaktů:

Región Pole třídy oblasti Hodnota URI koncového bodu
Brazílie – jih Jižní Brazílie https://brs.codesigning.azure.net
Střed USA Střední USA https://cus.codesigning.azure.net
USA – východ​ EastUS (Východní Spojené státy) https://eus.codesigning.azure.net
Japonsko – východ JapanEast https://jpe.codesigning.azure.net
Korea – střed KoreaCentral https://krc.codesigning.azure.net
Střed USA – sever NorthCentralUS https://ncus.codesigning.azure.net
Severní Evropa Severní Evropa https://neu.codesigning.azure.net
Polsko – střed Polsko – střed https://plc.codesigning.azure.net
Střed USA – jih SouthCentralUS https://scus.codesigning.azure.net
Švýcarsko – sever ŠvýcarskoSever https://swn.codesigning.azure.net
Středozápadní USA WestCentralUS https://wcus.codesigning.azure.net
Západní Evropa Západní Evropa https://weu.codesigning.azure.net
USA – západ Západ USA https://wus.codesigning.azure.net
USA – západ 2​ WestUS2 https://wus2.codesigning.azure.net
USA – západ 3 WestUS3 https://wus3.codesigning.azure.net

Omezení pojmenování pro účty Artifact Signing

Názvy účtů pro podpis artefaktů mají určitá omezení.

Název účtu podepisování artefaktů musí:

  • Obsahuje 3 až 24 alfanumerických znaků.
  • Buďte globálně jedineční.
  • Začněte písmenem.
  • Končí písmenem nebo číslem.
  • Neobsahuje po sobě jdoucí pomlčky.

Název účtu pro podepsání artefaktů je:

  • Nerozlišuje se malá a velká písmena (ABC je stejné jako abc).
  • Odmítnuto službou Azure Resource Manager, pokud začíná na "one".

Účet pro podepisování artefaktů vytvořte pomocí portálu Azure:

  1. Přihlaste se k portálu Azure.

  2. Vyhledejte a pak vyberte Účty pro podepisování artefaktů.

    Snímek obrazovky, který zobrazuje hledání účtů pro podepisování artefaktů na Azure portálu.

  3. V podokně Účty podepisování artefaktů vyberte Vytvořit.

  4. Jako Subscription vyberte své předplatné Azure.

  5. V části Skupina prostředků vyberte Vytvořit nový a zadejte název skupiny prostředků.

  6. Jako název účtu zadejte jedinečný název účtu.

    Další informace najdete v tématu Omezení pojmenování pro účty podepisování artefaktů.

  7. Pro Region vyberte Azure oblast, která podporuje podepisování artefaktů.

  8. V části Ceny vyberte cenovou úroveň.

  9. Vyberte tlačítko Zkontrolovat a vytvořit.

    Snímek obrazovky znázorňující vytvoření účtu pro podepisování artefaktů

  10. Po úspěšném vytvoření účtu Artifact Signing vyberte Přejít k prostředku.

Vytvoření žádosti o ověření identity

Ověření vlastní identity můžete dokončit vyplněním formuláře žádosti informacemi, které musí být součástí certifikátu. Ověření identity je možné dokončit pouze na portálu Azure. Ověření identity nejde dokončit pomocí Azure CLI.

Poznámka:

Pokud nemáte přiřazenou odpovídající roli, nemůžete vytvořit žádost o ověření identity. Pokud se tlačítko New identity na řádku nabídek na portálu Azure zobrazuje šedě, ujistěte se, že máte přiřazenou roli Ověření identity podepisování artefaktů, abyste mohli pokračovat v ověřování identity.

Vytvoření žádosti o ověření identity pro organizaci nebo DBA:

  1. Na portálu Azure přejděte ke svému novému účtu pro podepisování artefaktů.

  2. Ověřte, že máte přiřazenou roli Ověřovatel identity pro podepisování artefaktů.

    Informace o správě přístupu pomocí řízení přístupu na základě role (RBAC) najdete v kurzu: Přiřazení rolí v podepisování artefaktů.

  3. V podokně Přehled účtu podepisování artefaktů nebo v nabídce prostředků v části Objekty vyberte Ověření identity.

  4. Vyberte Nová identita a pak vyberte Buď Veřejná , nebo Soukromá.

    • Ověření veřejné identity se vztahuje pouze na tyto typy profilů certifikátů: veřejná důvěra, test veřejné důvěry, VBS Enclave.
    • Ověřování privátní identity se vztahuje pouze na tyto typy profilů certifikátů: Privátní důvěryhodnost, Zásady CI Privátní důvěryhodnosti.
  5. Při ověřování nové identity zadejte následující informace:

    Fields Podrobnosti
    Název organizace Pro ověření veřejné identity zadejte právnickou obchodní entitu, pro kterou je certifikát vystaven. Pro ověření privátní identity se jako výchozí hodnota nastaví název vašeho Microsoft Entra tenanta.
    (Pouze typ privátní identity) Organizační jednotka Zadejte příslušné informace.
    Adresa URL webu Zadejte web, který patří právnické obchodní osobě.
    Primární e-mail Zadejte e-mailovou adresu přidruženou k právnické obchodní entitě, která prochází ověřením. V rámci procesu ověření identity se na tuto e-mailovou adresu odešle ověřovací odkaz a platnost odkazu vyprší za sedm dnů. Ujistěte se, že e-mailová adresa může přijímat e-maily (s odkazy) z externích e-mailových adres. Toto je e-mailová adresa, na kterou se odesílají odkazy pro dokončení ověřených přihlašovacích údajů a ověření e-mailu.
    Sekundární e-mail Tato e-mailová adresa se musí lišit od primární e-mailové adresy (distribuční seznamy jsou přijímány). U organizací musí doména odpovídat e-mailové adrese zadané v primární e-mailové adrese. Ujistěte se, že e-mailová adresa může přijímat e-maily z externích e-mailových adres s odkazy.
    Obchodní identifikátor Zadejte obchodní identifikátor právnické osoby.
    ID prodejce Platí jenom pro zákazníky Microsoft Store. Id prodejce najdete na portálu Partnerského centra.
    Ulice, Město, Země/oblast, Stát/Provincie, PSČ Zadejte obchodní adresu právnické osoby.
    Křestní jméno Zadejte jméno jednotlivce představujícího organizaci, která bude provádět ověřování jednotlivých identit. Použijte přesný název, jak se zobrazí v identifikačním dokumentu vydaném státní správou pro proces ověření identity.
    Příjmení Zadejte příjmení jednotlivce představujícího organizaci. Tento jednotlivec provádí ověřování jednotlivých identit. Použijte přesný název, jak se zobrazí v identifikačním dokumentu vydaném státní správou pro proces ověření identity.
  6. Výběrem náhledu předmětu certifikátu zobrazíte náhled informací, které se zobrazí v certifikátu.

  7. Vyberte tlačítko Vytvořit.

  8. Po úspěšném vytvoření požadavku se stav žádosti o ověření identity změní na Probíhající.

  9. Když se stav změní na Požadovaná akce, postupujte podle pokynů krok 9 výše na kartě Ověření identity – jednotliví vývojáři.

  10. Odkaz na ověření jednotlivých identit se také odešle e-mailem na primární e-mailovou adresu.

  11. Po úspěšném dokončení ověřování jednotlivých identit se stav změní zpět na Probíhající a proces ověření bude pokračovat.

  12. Pokud jsou požadovány další dokumenty, odešle se e-mail a stav žádosti se změní na Povinné akce.

  13. Po dokončení procesu ověření identity se stav žádosti změní a odešle se e-mail s aktualizovaným stavem požadavku:

    • Dokončeno , pokud je proces úspěšně dokončen.
    • Neúspěšné , pokud se proces úspěšně nedokončil.

    Snímek obrazovky znázorňující veřejnou možnost v podokně Ověření nové identity

    Snímek obrazovky znázorňující možnost Soukromé v podokně Ověření nové identity

Důležité informace pro ověření veřejné identity

Požadavky Podrobnosti
Zaškolení nových zaměstnanců Pro rychlejší proces onboardingu se ujistěte, že jsou veřejné záznamy pro právnickou obchodní entitu, kterou jste ověřili, aktuální.
Přesnost Ujistěte se, že jste zadali správné informace pro ověření veřejné identity. Pokud potřebujete po vytvoření provést nějaké změny, musíte dokončit novou žádost o ověření identity. Tato změna má vliv na přidružené certifikáty, které se používají k podepisování.
Ověření e-mailu se nezdařilo Pokud ověření e-mailu selže, musíte zahájit novou žádost o ověření identity.
Stav ověření identity Když dojde k aktualizaci stavu ověření identity, budete upozorněni e-mailem. Stav můžete kdykoli zkontrolovat také na portálu Azure.
Doba zpracování Zpracování žádosti o ověření identity trvá od 1 do 20 pracovních dnů (možná déle, pokud od vás potřebujeme požádat o další dokumentaci).
Další dokumentace Pokud potřebujeme další dokumentaci ke zpracování žádosti o ověření identity, budete upozorněni e-mailem. Dokumenty můžete nahrát na portálu Azure. Pro nahrání dokumentace existují tři pokusy. E-mail s žádostí o dokumentaci obsahuje informace o požadavcích na velikost souboru. Ujistěte se, že všechny dokumenty, které zadáte, jsou nejaktuálnější.
- Všechny odeslané dokumenty musí být vydány v předchozích 12 měsících a kde datum vypršení platnosti je budoucí datum, které je alespoň dva měsíce pryč.
- Pokud není možné poskytnout další dokumentaci, aktualizujte informace o svém účtu tak, aby odpovídaly jakýmkoli právním dokumentům, které jsou již poskytnuty, nebo oficiální údaje o registraci společnosti.
- Při poskytování oficiálního obchodního dokladu, jako je formulář registrace firmy, obchodní listina nebo zakladatelské listiny, které uvádějí název a adresu společnosti tak, jak jsou uvedeny v době vytvoření žádosti o ověření identity.
– Ujistěte se, že registrace domény nebo faktura za doménu pochází z registrace nebo prodloužení, která obsahuje entitu a jméno kontaktu a všechny domény, které jsou zahrnuté nebo uvedené v žádosti.

Vytvoření profilu certifikátu

Prostředek profilu certifikátu je logický kontejner certifikátů, které jsou vám vydány pro podepisování.

Omezení pojmenování pro profily certifikátů

Názvy profilů certifikátů mají určitá omezení.

Název profilu certifikátu musí:

  • Obsahuje 5 až 100 alfanumerických znaků.
  • Začínat písmenem, končit písmenem nebo číslicí a nesmí obsahovat po sobě jdoucí pomlčky.
  • Buďte v rámci účtu jedineční.

Název profilu certifikátu je:

  • Ve výchozím nastavení dochází k dědičnosti ve stejné Azure oblasti jako účet.
  • Nerozlišuje se malá a velká písmena (ABC je stejné jako abc).

Vytvoření profilu certifikátu na portálu Azure:

  1. Na portálu Azure přejděte ke svému novému účtu pro podepisování artefaktů.

  2. V podokně Přehled účtu podepisování artefaktů nebo v nabídce prostředků v části Objekty vyberte Profily certifikátů.

  3. Na panelu příkazů vyberte Vytvořit a vyberte typ profilu certifikátu.

    Snímek obrazovky znázorňující typy profilů certifikátů podpisových artefaktů, ze které si můžete vybrat

  4. V části Vytvořit profil certifikátu zadejte následující informace:

    a. Jako název profilu certifikátu zadejte jedinečný název.

    Další informace najdete v tématu Omezení pojmenování profilů certifikátů.

    Hodnota pro Typ certifikátu je automaticky vyplněna na základě vybraného typu profilu certifikátu.

    b) U ověřeného CN a O vyberte ověření identity, které se musí zobrazit v certifikátu.

    • Pokud se adresa ulice musí zobrazit na certifikátu, zaškrtněte políčko Zahrnout adresu ulice.

    • Pokud je potřeba zobrazit psč na certifikátu, zaškrtněte políčko Zahrnout PSČ.

      Hodnoty pro zbývající pole se automaticky vyplňují na základě vašeho výběru pro ověřený CN a O.

      Vygenerovaný Náhled předmětu certifikátu zobrazuje náhled certifikátu, který bude vydán.

  5. Vyberte Vytvořit.

    Snímek obrazovky s podoknem Vytvořit profil certifikátu

Vyčistěte zdroje

Jak odstranit prostředky podepisování artefaktů pomocí portálu Azure:

Odstraňte profil certifikátu

  1. Na portálu Azure přejděte do svého účtu Artifact Signing.
  2. V podokně Přehled účtu podepisování artefaktů nebo v nabídce prostředků v části Objekty vyberte Profily certifikátů.
  3. V profilech certifikátů vyberte profil certifikátu, který chcete odstranit.
  4. Na panelu příkazů vyberte Odstranit.

Poznámka:

Tato akce zastaví podepisování přidružené k profilu certifikátu.

Smazat účet pro podepisování artefaktů

  1. Přihlaste se k portálu Azure.
  2. Do pole pro vyhledávání zadejte a poté vyberte Účty pro podepisování artefaktů.
  3. V sekci Účty pro podepisování artefaktů vyberte účet pro podepisování artefaktů, který chcete odstranit.
  4. Na panelu příkazů vyberte Odstranit.

Poznámka:

Tato akce odebere všechny profily certifikátů, které jsou propojené s tímto účtem. Všechny podpisové procesy přidružené k profilům certifikátů se zastaví.

V tomto rychlém startu jste vytvořili účet Artifact Signing, žádost o ověření identity a profil certifikátu. Další informace o podepisování artefaktů a zahájení cesty k podepisování najdete v těchto článcích:

  • Přečtěte si další informace o integraci podepisování.
  • Přečtěte si další informace o modelech důvěryhodnosti, které podporuje podepisování artefaktů.
  • Přečtěte si další informace o správě certifikátů.
  • Potřebujete pomoc s nastavením:
    • Prostřednictvím podpory Azure se obraťte přes portál Azure.
    • Odešlete dotaz na Stack Overflow nebo Microsoft Q&A, použijte značku: artifact-signing.
      • Problémy s ověřováním identity je možné vyřešit pouze pomocí stack overflow nebo microsoft Q&A.