CONTEÚDO
- Visão Geral
- Instalação
- Instalação do IIS
- Instalação do pacote .NetCore Hosting Bundle 5.0.2
- Variável de Ambiente
- Cópia de arquivos do Deploy
- Configuração
- Configuração do IIS
- Configuração do Pool de Aplicativos
- Configuração da variável de ambiente
- Certificados
01. VISÃO GERAL
O manual tem como objetivo realizar a configuração de instalação do IIS para a API de Faturamento Automático.
02. Instalação
- Instalação do IIS
Acessar o Painel de Controle do Windows
Em “Programas e Recursos”, acessar a opção Ativar ou desativar recursos do Windows
Em recursos do Windows, localizar Serviços de Informações da Internet
Expandir e marcar as opções conforme abaixo
Após, clicar no botão OK para realizar a instalação do IIS
Ao término, o Windows deve exibir uma mensagem de que as alterações foram concluídas.
- Instalação do pacote .NetCore Hosting Bundle 5.0.2
Necessário instalar o arquivo “dotnet-hosting-5.0.2-win.exe” para fazer o registro do Asp NetCore no serviço do IIS do Windows
Link para download:
Acessar o arquivo baixado e executar como administrador
Clicar com o botão inverso do mouse para abrir o menu suspenso
Será aberta a janela de instalação do Microsoft .NET Core 5.0.2 Windows Server Hosting. Clicar no botão Instalar para começar a instalação
Após o término o programa deverá exibir a mensagem de instalação concluída com sucesso.
Para fazer a conferência da instalação, acessar novamente o Painel de Controle do Windows
Em “Programas”, acessar a opção Desinstalar um programa
Na lista dos programas instalados, localizar o Microsoft .NET Core 5.0.2 Windows Server Hosting
03. Variável de Ambiente
Criar a variável de Ambiente (de Sistema) ASPNETCORE_ENVIRONMENT no Windows.
Acessar o Painel de Controle do Windows
Em Sistema, acessar a opção Editar as variáveis de ambiente do sistema
Na aba Avançado, clicar no botão Variáveis de Ambiente...
No quadrante da Variáveis do sistema, clicar no botão Novo...
No campo Nome da variável preencher com ASPNETCORE_ENVIRONMENT
No campo Valor da variável preencher com Development
Após clicar no botão OK deverá ser exibida na lista das variáveis do sistema
04. Cópia de arquivos do Deploy
Pelo Windows Explorer acessar o diretório C:\inetpub\wwwroot\ e criar a nova pasta ApiFatAutApplication (nome sugerido)
Descompactar os arquivos do ApiFatAutApplication.zip e copiar para o novo diretório \inetpub\wwwroot\ApiFatAutApplication\
05. Configuração
- Configuração do IIS
Na barra de pesquisa do Windows digitar IIS
Acessar a opção Gerenciador de Serviços de Informações da Internet (IIS)
Será aberta a janela do Gerenciador do Serviços de Informações da Internet
Selecionar a pasta Sites e criar um novo site acessando a opção de menu Adicionar Site...
Colocar o mesmo nome da pasta criada no inetpub: ApiFatAutApplication
Nome do host
Pode ser utilizado um nome para o host onde a URL será acessível através do mesmo (por padrão será criado localhost)
Para isso será necessário configurar o nome do host no arquivo C:\Windows\System32\drivers\etc\ hosts adicionando o nome desejado
Teste de conexão
Será exibido o resultado da autenticação
Enfim, basta clicar no botão OK para que seja criado o novo serviço da API de Faturamento Automático no IIS.
- Configuração do Pool de Aplicativos
Com o serviço criado, agora deve ser feito um ajuste de configuração no Pool de Aplicativos.
Selecionar o ApiFatAutApplication e acessar o menu Configurações Básicas...
Alterar a versão do .NET CLR para Sem Código Gerenciado
Clicar OK
- Configuração da variável de ambiente
Um último ajuste nas configurações do IIS, é fazer a associação da variável de ambiente com o serviço do Faturamento da API
Selecionar ApiFatAutApplication e em Gerenciamento, acessar Editor de Configurações
Na Seção selecionar system.webServer/aspNetCore
Em environmentVariables clicar nos três pontinhos (lado direito)
Clicar no botão Adicionar...
Nas Propriedades digitar em name: ASPNETCORE_ENVIRONMENT e value: Development
Fechar a janela e clicar em Aplicar
Será exibida a mensagem que as alterações foram realizadas com sucesso.
06. Certificados
Caso a organização possua algum certificado de segurança (TLS, SSL, e c), pode ser feita a associação com site para que utilize o protocolo HTTPS
Selecionar o serviço ApiFatAutApplication e acessar a opção Editar Associações...
Clicar no botão Adicionar e em Tipo selecionar https
Selecionar o certificado desejado e clicar em OK
Na tela de Associações do Site, clicar em Fechar.
Após selecionar o site criado, reiniciar para atualizar as configurações recentes
Testar o serviço publicado
Em Procurar Site, clicar na opção Procurar *:443 (https)
O cadeado é exibido ao lado do https indicando a conexão segura
Ao acessar o site será aberta a Interface do Swagger (ferramenta padrão de documentação de APIs)
Import HTML Content
Visão Geral
Conteúdo das Ferramentas