# implementação empresarial

A implantação do SCEPman 2.x é diferente da implantação do SCEPman 1.x. Se você quiser instalar uma nova instância do SCEPman 2.x ou atualizar sua instância 1.x existente, continue lendo.

## Nova instância do SCEPman 2.0

**Implantar Recursos do Azure**

Faça login com uma conta de administrador do AAD e visite este site, escolha e clique em um dos seguintes links de implantação:

* [Canal de produção](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fscepman%2Fdeploy%2Fprod%2Fazuredeploy.json)
* [Canal beta](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fscepman%2Fdeploy%2Fbeta%2Fazuredeploy.json)
* [Canal interno](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fscepman%2Fdeploy%2Finternal%2Fazuredeploy.json)
* [Canal de produção na nuvem nacional GCC High](https://portal.azure.us/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fscepman%2Fdeploy%2Fgcchigh%2Fazuredeploy.json)
* [Canal de produção na nuvem nacional 21Vianet](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fscepman%2Fdeploy%2Fvianet%2Fazuredeploy.json) (Experimental!)

Preencha os valores no formulário

<figure><img src="https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FhcigYeXwfJ2YNTDyNbQ1%2Fimage.png?alt=media&#x26;token=eb35d15e-631c-4ab7-8ca0-7b3c928b19ea" alt=""><figcaption></figcaption></figure>

* **Assinatura:** Selecione sua assinatura, onde você tem permissões para criar App Services, conta de armazenamento, plano de App Service e key vault
* **Grupo de recursos:** Selecione um grupo de recursos existente ou crie um novo. Os recursos do SCEPman serão implantados neste grupo de recursos
* **Região:** Selecione a região de acordo com sua localização
* **Nome da Organização:** Nome da sua empresa ou organização para o nome do assunto do certificado CA (RDN O)

{% hint style="warning" %}
Para maximizar a compatibilidade, para o **Nome da Organização** recomendamos omitir

* caracteres especiais específicos de idioma (por exemplo ö, ø, é, ...)

* um espaço inicial (espaços entre palavras podem ser usados)

* aspas
  {% endhint %}

* **Licença:** deixe como "trial" para implantar uma Community Edition ou cole sua chave de licença para a Enterprise Edition do SCEPman.

* **Tipo de chave CA**:&#x20;
  * **RSA-HSM** (**recomendado**, CA raiz com suporte HSM)
  * **RSA** (CA raiz com suporte por software)

* Para o **Nome da Conta de Armazenamento**, por favor note que o nome **deve** ter entre 3 e 24 caracteres de comprimento e pode conter **apenas números e letras minúsculas**

* Defina um **globalmente** nome único para o **Nome do Key Vault, Nome do Plano de App Service,** **Nome do App Service Principal**, **Nome do Workspace do Log Analytics**, **Nome do App Service do Certificado Master**, **Nome da Rede Virtual**, **Endpoint Privado para Nome do Key Vault** e **Endpoint Privado para Armazenamento de Tabela.** Substitua *NOMEUNICO* por um valor que dê uma ideia do nome da sua organização.

{% hint style="warning" %}
Caso você tenha implantado anteriormente o SCEPman com o mesmo **Nome do Key Vault**, e excluído todos os recursos da implantação anterior, certifique-se de [**recuperar**](https://learn.microsoft.com/en-gb/azure/key-vault/general/key-vault-recovery?tabs=azure-portal\&WT.mc_id=Portal-Microsoft_Azure_KeyVault#list-recover-or-purge-a-soft-deleted-key-vault) o Key Vault previamente excluído. Ele reaparecerá no grupo de recursos anterior. A implantação ARM - se apontada para o mesmo grupo de recursos - reconhecerá o Key Vault existente e o reutilizará. Uma exclusão completa do Key Vault anterior não é viável devido à [**Proteção contra Purga**](https://learn.microsoft.com/en-gb/azure/key-vault/general/key-vault-recovery?tabs=azure-portal\&WT.mc_id=Portal-Microsoft_Azure_KeyVault#what-are-soft-delete-and-purge-protection) por 90 dias.
{% endhint %}

* **ID do Plano de App Service existente:** Forneça o ID do Plano de App Service de um Plano de App Service existente ou mantenha o valor padrão 'none' se você quiser criar um novo

Para encontrar seu **ID do Plano de App Service existente:** navegue até seu Plano de App Service existente > Visualização JSON > copie o ID do Recurso (veja as capturas de tela)

![](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-9f8af9d1eaaf3712785803a213b65ac7c66f527a%2F2022-04-04%2012_51_33AppServicePlan.png?alt=media) ![](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-a37930d03b41e67fbaba4d15f8dd6a45c77e58e4%2F2022-04-04%2012_54_04-Resource%20JSON.png?alt=media)

* **Implantar no Linux:**
  * **true** (implanta o SCEPman em um Plano de App Service no Linux)
  * **false** (implanta em um Plano de App Service do Windows)
* **Implantar Rede Privada**:&#x20;
  * **true** (**recomendado**, isola o key vault e a conta de armazenamento atrás de endpoints privados para que apenas o SCEPman possa acessá-los do ponto de vista de rede)
  * **false** (key vault e conta de armazenamento podem ser acessados de qualquer endereço IP)
* **Localização:** de todos os recursos, o valor padrão `[resourceGroup().location]` é a recomendação da Microsoft, você pode deixá-lo como está
* **Rever + criar**, então **Criar**

Após uma implantação bem-sucedida do SCEPman 2.x, por favor siga o[ Identidades Gerenciadas ](https://docs.scepman.com/pt/implementacao-do-scepman/permissions/post-installation-config)artigo

## Atualizar de 1.x para 2.x

O SCEPman 2.0 compreende dois recursos adicionais do Azure, uma conta de Armazenamento do Azure e um App Service chamado "Cert Master". Estes são usados para emitir e gerenciar os certificados de servidor. Mas você também pode executar o SCEPman 2.0 sem eles se você optar apenas pelos certificados de cliente como antes.

Se você ainda estiver executando o SCEPman 1.x, certifique-se de que sua instância use artefatos de aplicação 2.x conforme descrito aqui: [Artefatos da Aplicação](https://docs.scepman.com/pt/configuracao-do-scepman/application-artifacts).

**Por favor reinicie seu App Service em seguida.**

### Adicionar SCEPman Cert Master

{% hint style="warning" %}
**Antes de** adicionar o componente Cert Master através do script PowerShell mencionado abaixo, o serviço base existente do SCEPman deve ser atualizado para a versão >= 2.0 conforme descrito no parágrafo anterior.
{% endhint %}

Se você quiser usar o novo componente SCEPman Cert Master para emitir certificados de servidor, precisa adicionar os recursos adicionais do Azure e configurá-los. Isso permitirá autenticação como Identidade Gerenciada; uma vantagem disso é que você não precisa mais de segredos de aplicação. Assim, você também não precisa se preocupar com a expiração de segredos de aplicação! É assim que você faz:

Após atualizar o componente principal, você precisa seguir o guia de [Configuração Pós-Instalação](https://docs.scepman.com/pt/implementacao-do-scepman/permissions/post-installation-config). Em contraste com uma nova instalação, isto também criará os dois novos recursos do Azure.

## Rebaixar de 2.x para 1.x

Você pode rebaixar para qualquer versão anterior do SCEPman baixando os artefatos mais antigos, hospedando-os em seu local, por exemplo Azure Blob Storage, e então referenciando os binários usando a [WEBSITE\_RUN\_FROM\_PACKAGE](https://docs.scepman.com/pt/configuracao-do-scepman/application-artifacts#change-artifacts) configuração.

No entanto, se você também usou o módulo PowerShell do SCEPman para atualizar a configuração interna, há uma advertência: 2.x suporta uma forma diferente de autenticação com o Graph e o Intune usando Identidades Gerenciadas, que também é o novo padrão e que é habilitado pelo script. Se você rebaixar seu componente principal, ele não poderá usar a nova forma de autenticação e estará faltando uma configuração para a antiga, então não funcionará mais. Assim, após um rebaixamento, você deve alterar manualmente as configurações de aplicação [AppConfig:AuthConfig:ApplicationId](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/dependencies-azure-services/azure-ad#appconfig-authconfig-applicationid) e [AppConfig:AuthConfig:ApplicationKey](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/dependencies-azure-services/azure-ad#appconfig-authconfig-applicationkey). O script cria backups das configurações prefixando `Backup:`. Assim, você precisa renomear `Backup:AppConfig:AuthConfig:ApplicationKey` de volta para `AppConfig:AuthConfig:ApplicationKey` e copiar o valor antigo de `Backup:AppConfig:AuthConfig:ApplicationId` para `AppConfig:AuthConfig:ApplicationId`. Então o 1.x funcionará novamente usando autenticação baseada em Registros de Aplicação.
