Início Rápido: Configurar a Assinatura de Artefato

Para registrar um provedor de recursos de Assinatura de Artefatos usando o portal Azure:

1. Entre no portal Azure.

2. Na barra de pesquisa ou em Todos os serviços, selecione Assinaturas.

3. Selecione a assinatura na qual você deseja criar os recursos da Assinatura de Artefato.

4. No menu de recursos, em Configurações, selecione Provedores de recursos.

5. Na lista de provedores de recursos, selecione Microsoft. CodeSigning.

   Por padrão, o status do provedor de recursos é NotRegistered.

6. Selecione as reticências e, em seguida, selecione Registrar.

   

   O status do provedor de recursos muda para Registrado.

Para registrar um provedor de recursos de Assinatura de Artefato usando o CLI do Azure:

1. Se você estiver usando uma instalação local do CLI do Azure, entre no CLI do Azure usando o comando az login.

2. Para concluir o processo de autenticação, conclua as etapas que são exibidas no terminal. Para outras opções de login, consulte Entrar usando o CLI do Azure.

3. Quando solicitado na primeira utilização, instale a extensão do CLI do Azure.

   Para obter mais informações, consulte Use extensões com o CLI do Azure.

   Para obter mais informações sobre a extensão de Assinatura de Artefato do CLI do Azure, consulte o Artifact Signing service.

4. Para ver as versões do CLI do Azure e das bibliotecas dependentes instaladas, use o comando az version.

5. Para atualizar para as versões mais recentes do CLI do Azure e bibliotecas dependentes, execute o seguinte comando:

   az upgrade [--all {false, true}] [--allow-preview {false, true}] [--yes]
   

6. Para definir sua ID de assinatura padrão, use o comando az account set -s <subscription ID>.

7. Para registrar um provedor de recursos de Assinatura de Artefato, use este comando:

   az provider register --namespace "Microsoft.CodeSigning"
   

8. Verifique o registro:

   az provider show --namespace "Microsoft.CodeSigning"
   

9. Para adicionar a extensão para Assinatura de Artefato, use este comando:

   az extension add --name artifact-signing
   

Para criar uma conta de Assinatura de Artifact usando o portal do Azure:

1. Entre no portal Azure.

2. Pesquise e selecione Contas de Assinatura de Artefato.

   

3. No painel Contas da Assinatura de Artefato, selecione Criar.

4. Para Subscription, selecione sua assinatura Azure.

5. Para Grupo de recursos, selecione Criar e insira o nome de um novo grupo de recursos.

6. No Nome da Conta, insira um nome de conta exclusivo.

   Para obter mais informações, consulte Restrições de nomenclatura para contas de Assinatura de Artefato.

7. Para Region, selecione uma região Azure que dê suporte à Assinatura de Artefato.

8. Em Preço, selecione um tipo de preço.

9. Selecione o botão Revisar + Criar.

   

10. Depois de criar com sucesso a conta da Assinatura de Artefato, selecione Ir para o recurso.

Para criar uma conta de Assinatura de Artefatos usando o CLI do Azure:

1. Crie um grupo de recursos usando o comando a seguir. Se escolher usar um grupo de recursos existente, ignore esta etapa.

   az group create --name MyResourceGroup --location EastUS

2. Crie uma conta de Assinatura de Artefato exclusiva usando o comando a seguir.

   Para obter mais informações, consulte Restrições de nomenclatura para contas de Assinatura de Artefato.

   Para criar uma conta da Assinatura de Artefato que tenha um SKU Básico:

  az artifact-signing create -n MyAccount -l eastus -g MyResourceGroup --sku Basic

Para criar uma conta para Assinatura de Artefatos que tenha um SKU Premium:

az artifact-signing create -n MyAccount -l eastus -g MyResourceGroup --sku Premium

3. Verifique sua conta de Assinatura de Artefato usando:

az artifact-signing show -g MyResourceGroup -n MyAccount` command.

A tabela a seguir lista os comandos úteis a serem usados ao criar uma conta de Assinatura de Artefato:

Para criar uma solicitação de validação de identidade para uma organização ou um DBA:

1. No portal do Azure, acesse sua nova conta de Assinatura de Artefatos.

2. Confirme que você tenha a função Verificador de Identidade da Assinatura de Artefato atribuída a você.

   Para aprender a gerenciar e acessar usando o controle de acesso baseado em função (RBAC), confira Tutorial: atribuir as funções na Assinatura de Artefato.

3. No painel Visão geral da conta de Assinatura de Artefatos ou no menu de recursos em Objetos, selecione Validações de identidade.

4. Selecione Nova identidade e selecione Público ou Privado.

   • A validação de identidade pública é aplicável somente aos tipos de perfis de certificado: Confiança Pública, Teste de Confiança Pública e Enclave VBS.
   • A validação de identidade privada aplica-se apenas aos seguintes tipos de perfil de certificado: Trust Privado e Política CI de Trust Privado.

5. Em Nova validação de identidade, forneça as seguintes informações:

   Fields	Detalhes
   Nome da Organização	Para validação de identidade pública, forneça a entidade jurídica de negócios à qual o certificado é emitido. Para a validação de identidade privada, o valor padrão é o nome do inquilino Microsoft Entra.
   (Somente tipo de identidade privada) Unidade Organizacional	Insira as informações relevantes.
   URL do site	Insira o site que pertence à entidade jurídica.
   Email principal	Insira o endereço de email associado à entidade de negócios jurídica que está passando por validação. Parte do processo de Validação de Identidade, um link de verificação é enviado para esse endereço de email e o link expira em sete dias. Verifique se o endereço de email pode receber emails (com links) de endereços de email externos. Este é o endereço de email para o qual os links para concluir credenciais verificadas e verificação de email são enviados.
   Email secundário	Esse endereço de email deve ser diferente do endereço de email primário (listas de distribuição são aceitas). Para organizações, o domínio deve corresponder ao endereço de email fornecido no endereço de email principal. Garanta que o endereço de email possa receber emails de endereços de email externos com links.
   Identificador comercial	Insira um identificador comercial para a entidade jurídica.
   ID do vendedor	Aplica-se somente a clientes Microsoft Store. Localize sua ID de vendedor no portal do Partner Center.
   Rua, Cidade, País/Região, Estado/Província, Cep	Insira o endereço comercial da entidade jurídica.
   Nome próprio	Insira o nome do indivíduo que representa a organização que executará a validação de identidade individual. Use o nome exato como ele aparece no documento de identificação emitido pelo governo para o processo de Validação de Identidade.
   Apelido	Insira o sobrenome do indivíduo que representa a organização. Esse indivíduo executa a validação de identidade individual. Use o nome exato como ele aparece no documento de identificação emitido pelo governo para o processo de Validação de Identidade.

6. Selecione Pré-visualização do assunto do certificado para ver uma pré-visualização das informações exibidas no certificado.

7. Selecione o botão Criar.

8. Quando a solicitação for criada com sucesso, o status da solicitação de validação de identidade muda para Em andamento.

9. Quando o status for alterado para Ação Necessária, siga as instruções etapa 9 em diante na guia Validação de Identidade – Desenvolvedor Individual acima.

10. O link para validação de identidade individual também é enviado por email para o endereço de email primário.

11. Depois que a Validação de Identidade Individual for concluída com êxito, o status será alterado novamente para Em Andamento e o processo de validação continuará.

12. Se mais documentos forem necessários, um email será enviado e o status da solicitação será alterado para Ação Necessária.

13. Ao concluir o processo de validação de identidade, o status da solicitação será alterado e um email será enviado com o status atualizado da solicitação:

    • Concluído se o processo é concluído com sucesso.
    • Com falha se o processo não é concluído com sucesso.

    

    

Informações importantes para validação de identidade pública

Para criar uma solicitação de validação de identidade individual para um desenvolvedor individual:

1. No portal do Azure, acesse sua nova conta de Assinatura de Artefatos.

2. Confirme que você tenha a função Verificador de Identidade da Assinatura de Artefato atribuída a você.

   Para saber como gerenciar o acesso usando o RBAC (controle de acesso baseado em função), consulte Tutorial: Atribuir funções na Assinatura de Artefato.

3. No painel Visão geral da conta de Assinatura de Artefatos ou no menu de recursos em Objetos, selecione Validações de identidade.

4. Selecione Organização, na lista suspensa, selecione Individual e, em seguida, selecione Público.

   • A validação de identidade pública se aplica a esses tipos de perfil de certificado: Confiança Pública, Teste de Confiança Pública, Enclave VBS.
   • A validação de identidade privada é apenas para Organizações.

5. Em Nova validação de identidade, forneça as seguintes informações:

   Fields	Detalhes
   Nome próprio	Use o nome exato como ele aparece no documento de identificação emitido pelo governo para o processo de Validação de Identidade.
   Apelido	Use o nome exato como ele aparece no documento de identificação emitido pelo governo para o processo de Validação de Identidade.
   Email principal	Insira o endereço de email que receberá o link validação de identidade. Use o mesmo endereço de email ao fazer logon na conta Microsoft para acessar o link validação de identidade.
   Rua, Cidade, País/Região, Estado/Província, Cep	Insira o endereço conforme ele aparece no documento de identificação emitido pelo governo ou na fatura do utilitário ou no extrato bancário. A cidade, o estado/província e o país/região do endereço inserido aqui são exibidos no certificado.

6. A versão preliminar da entidade do certificado mostra a versão preliminar das informações exibidas no certificado.

   • Seu endereço de email e endereço de rua não estão incluídos no certificado.

7. Selecione o botão Criar.

8. Quando a solicitação for criada com sucesso, o status da solicitação de validação de identidade muda para Em andamento.

9. Quando o status é alterado para Ação Necessária. Selecione seu nome e um painel se abrirá no lado direito. Selecione o link em "Conclua a verificação aqui".

10. Siga o link para concluir o processo de Validação de Identidade. Use o endereço de email fornecido no momento da criação da solicitação. Insira as credenciais quando solicitado e você será navegado para a próxima tela.

11. Selecione Seja verificado aqui através de nossos verificadores de ID confiáveis.

    

12. Crie credenciais verificadas usando as páginas dos parceiros confiáveis. As etapas a seguir mostram um passo a passo de exemplo. Ele usa o parceiro confiável: AU10TIX. Você está navegando para um site de terceiros.

    1. Selecione Vamos Começar.

    

13. Insira o endereço de email principal da solicitação aqui.

    

    AU10TIX envia uma verificação por email que inclui um código PIN.

    1. Verifique seu email para o email de verificação e insira o código PIN para verificar sua conta de email.

    

14. Insira o número de telefone quando solicitado na próxima tela.

    

15. Selecione Iniciar.

    

16. Use a câmera do dispositivo móvel para verificar o código QR. Não feche essa tela no navegador.

    

17. Em seu dispositivo móvel, selecione Iniciar. Siga as etapas para concluir o processo e apresentar a documentação relevante quando solicitado.

18. Depois que o processo Au10TIX for concluído em seu dispositivo móvel, selecione Abrir Autenticador.

    

19. Agora, de volta ao navegador, examine o código QR do seu dispositivo móvel. Não feche o navegador.

    

20. Selecione Add para adicionar uma ID verificada ao aplicativo Microsoft Authenticator.

    

21. A tela do navegador mostra Apresentar sua ID Verificada. Leia o código QR.

22. Selecione Credencial Verificável para usar com a Assinatura de Artefato.

23. Selecione Compartilhar para compartilhar as credenciais com a Assinatura de Artefato.

24. Para conclusão bem-sucedida, a tela do navegador em seu dispositivo não móvel é atualizada para: Verificação bem-sucedida .

    

25. Leva alguns minutos para que o status de Validação de Identidade no portal Azure seja atualizado. Para uma ID verificada bem-sucedida, o status no portal Azure é alterado para Completed.

    

Informações importantes para validação de identidade pública para desenvolvedores individuais

1. Requisitos mínimos para OSes móveis e navegadores compatíveis:

   

   

2. Tipos de ID aceitos:

   • IDs emitidas pelo governo, como passaportes, carteiras de motorista ou cartões de identificação.
   • IDs de foto (ou um cartão de segurança social dos EUA).
   • IDs oficiais emitidas pelo governo, como passaporte, carteira de motorista ou ID do estado.
   • Não envie IDs emitidas privadamente, como cartões de biblioteca, IDs escolares, cartões de associação do clube, etc.

3. Visibilidade/Pouca Luz/Luz Brilhante:

   • Não use flash.
   • Não coloque a ID em luz solar direta.
   • Mantenha a câmera ou o dispositivo móvel estável ao tirar a foto.

4. Práticas recomendadas para documentos complementares:

   • Contas de Serviços Públicos: Contas de luz, água, gás ou telefone (devem ser recentes, normalmente nos últimos três meses).
   • Extratos bancários: declarações oficiais de bancos ou empresas de cartão de crédito que mostram o endereço da pessoa física.
   • O documento POA deve ter o endereço, o nome e a data exibidos na página principal (primeira página), portanto, várias páginas não são necessárias.

5. Práticas recomendadas gerais:

   • Uma única imagem por arquivo; se for de dois lados, criar um arquivo por lado.
   • Documentos manuscritos não são aceitos.
   • Não recorte a imagem (como cortar cantos ou perder partes); tente manter margens em todos os lados da imagem antes de capturá-la.
   • Não use o Photoshop ou outro software de edição; não altere o documento de forma alguma.
   • Não use flash.
   • Tire a foto diretamente acima do documento enquanto ele está em uma superfície plana.
   • Evite planos de fundo coloridos e barulhentos.
   • Não obstrua o documento de identidade (nenhum dedo cobrindo o documento).
   • Use imagens coloridas não inferiores a 200 DPI. O tamanho ideal da imagem é 500 Kb. A prática recomendada da AU10TIX é aceitar imagens com 400 DPI, e superiores.
   • O limite mínimo para o tamanho da imagem para um resultado OK é de 600 W X 370 H pixels.
   • Tipos de arquivo aceitos: .bmp .jpg .gif .tif .pdf.
   • Os usuários não podem carregar imagens menores que 30 kb ou maiores que 5 MB.

Para criar um perfil de certificado no portal do Azure:

1. No portal do Azure, acesse sua nova conta de Assinatura de Artefatos.

2. No painel Visão geral da conta de Assinatura de Artefatos ou no menu de recursos em Objetos, selecione Perfis de Certificado.

3. Na barra de comandos, selecione Criar e selecione um tipo de perfil de certificado.

   

4. Em Criar um perfil de certificado, forneça as seguintes informações:

   a. Em Nome do perfil de certificado, insira um nome exclusivo.

   Para obter mais informações, consulte Restrições de nomenclatura para perfis de certificado.

   O valor para Tipo de Certificado é preenchido automaticamente com base no tipo de perfil de certificado selecionado.

   b. Para CN e O verificados, selecione uma validação de identidade que deve ser exibida no certificado.

   • Se o endereço da rua precisar ser exibido no certificado, marque a caixa de seleção Incluir endereço da rua.

   • Se o CEP precisar ser exibido no certificado, marque a caixa de seleção Incluir CEP.

     Os valores nos campos restantes são preenchidos automaticamente com base na seleção de CN verificado e O.

     A Pré-visualização do Assunto do Certificado gerada mostra o certificado que será emitido.

5. Selecione Criar.

   

Pré-requisitos

Você precisa da ID de Validação de Identidade da entidade para a qual o perfil de certificado está sendo criado. Conclua estas etapas para localizar sua ID de validação de identidade no portal do Azure.

1. No portal do Azure, acesse sua conta de Assinatura de Artefatos.

2. No painel Visão geral da conta de Assinatura de Artefatos ou no menu de recursos em Objetos, selecione Validações de identidade.

3. Selecione o hiperlink para a entidade relevante. No painel de Validação de Identidade, você pode copiar o valor da ID de validação de identidade.

   

Para criar um perfil de certificado usando o CLI do Azure:

1. Crie um perfil de certificado usando o seguinte comando:

az artifact-signing certificate-profile create -g MyResourceGroup --a
   account-name MyAccount -n MyProfile --profile-type PublicTrust --identity-validation-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Para obter mais informações, consulte Restrições de nomenclatura para perfis de certificado.

2. Crie um perfil de certificado que inclua campos opcionais (endereço ou CEP) no nome do assunto do certificado usando o seguinte comando:

az artifact-signing certificate-profile create -g MyResourceGroup --account-name MyAccount -n MyProfile --profile-type PublicTrust --identity-validation-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --include-street true

3. Verifique se você criou com sucesso um perfil de certificado usando o seguinte comando:

az artifact-signing certificate-profile show -g myRG --account-name MyAccount -n  MyProfile

A tabela a seguir lista comandos úteis a serem usados ao criar um perfil de certificado usando o CLI do Azure:

Para excluir recursos de Assinatura de Artefato usando o portal Azure:

Excluir um perfil de certificado

1. No portal do Azure, acesse sua conta de Assinatura de Artefatos.
2. No painel Visão geral da conta de Assinatura de Artefatos ou no menu de recursos em Objetos, selecione Perfis de Certificado.
3. Em Perfis de certificado, selecione o perfil de certificado que você quer excluir.
4. Na barra de comandos, selecione Excluir.

Excluir uma conta da Assinatura de Artefato

1. Entre no portal Azure.
2. Na caixa de pesquisa, insira e selecione Contas da Assinatura de Artefato.
3. Em Contas da Assinatura de Artefato, selecione a conta da Assinatura de Artefato que você deseja excluir.
4. Na barra de comandos, selecione Excluir.

Para excluir recursos de Assinatura de Artefato usando o CLI do Azure:

Excluir um perfil de certificado

Para excluir um perfil de certificado de Assinatura de Artefato, execute este comando:

az artifact-signing certificate-profile delete -g MyResourceGroup --account-name MyAccount -n MyProfile

Excluir uma conta da Assinatura de Artefato

Você pode usar o CLI do Azure para excluir Recursos de Assinatura de Artefatos.

Para excluir uma conta de Assinatura de Artefato, execute este comando:

az artifact-signing delete -n MyAccount -g MyResourceGroup