Histórico da Página
Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
dice:
Índice | ||
---|---|---|
|
Preparação inicial do ambiente
1) - Instale a versão do .Net Framework 4.7.1
Informações |
---|
Disponível em "https://www.microsoft.com/pt-br/download/details.aspx?id=56116" |
2) - Instale a última versão do runtime do .Net core
Informações |
---|
Disponível em "https://www.microsoft.com/net/download/thank-you/dotnet-runtime-2.0.5-windows-x64-installer" |
3) - Crie a seguinte estrutura de diretórios dentro da raiz da máquina:
c:\TReports\BackEnd;
c:\TReports\FrontEnd;
c:\TReports\Rac;
c:\TReports\Rac\Migrator;
c:\TReports\Rac\Host;
com as configurações do seu servidor.
Veja abaixo um exemplo de configuração par o SQL Server:
icon | false |
---|
Configuração do RAC
1) - Rodar o processo de "Migrator" do Rac para criação do banco de dados do Rac:
a) - Descompacte o arquivo "MigratorRac.zip" dentro do diretório "c:\TReports\Rac\Migrator";
b) - Abra o arquivo "appsettings.json" do diretório "c:\TReports\Rac\Migrator" e efetue as seguintes modificações:
b.1) - No atributo "ConnectionStrings" informe a string de conexão conforme exemplo abaixo:
"ConnectionStrings": {
"Default": "Server=
127.0.0.1BHD050100275; TrustServerCertificate=True; database=
TRFDbSampleTnfRac; User Id=
myusersa;password=
mypasswordxxxx"
},
Se já possuir uma base de dados é necessário apenas informa-la para que seja automaticamente atualizada. Se não possuir uma base o sistema irá criar uma nova base assim que o servidor for iniciado. No exemplo acima, a base a ser criada/atualizada é a TRFDbSample.
Informe também os dados de acesso ao banco de dados padrão para a aplicação. Dessa forma ao criar um novo provedor de dados as informações serão carregadas a partir dessa seção.
Exemplos:
Expandir | ||
---|---|---|
| ||
"DefaultDBSettings": { "ProviderParams": [ { "Name": "Data Source", "Description": "Nome do servidor", "Value": "127.0.0.1", "AllowEdit": "true" }, { "Name": "Initial Catalog", "Description": "Nome do banco de dados", "Value": "DbTest", "AllowEdit": "true" }, { "Name": "Integrated Security", "Description": "Segurança integrada", "Value": "false", "AllowEdit": "true", }, { "Name": "User Id", "Description": "Usuário", "Value": "userName", "AllowEdit": "true" }, { "Name": "Password", "Description": "Senha", "Value": "P@ssw0rd", "AllowEdit": "true", "Type": 1 } ] }, |
Expandir | ||
---|---|---|
| ||
"DefaultDBSettings": { "ProviderParams": [ { "Name": "Server", "Description": "Nome do servidor", "Value": "127.0.0.1", "AllowEdit": "true" }, { "Name": "Direct", "Description": "Direct", "Value": "true", "AllowEdit": "true" }, { "Name": "Service Name", "Description": "Nome do banco de dados", "Value": "DbTest", "AllowEdit": "true" }, { "Name": "User Id", "Description": "Usuário", "Value": "userName", "AllowEdit": "true" }, { "Name": "Password", "Description": "Senha", "Value": "P@ssw0rd", "AllowEdit": "true", "Type": 1 } ] } |
Expandir | ||
---|---|---|
| ||
"DefaultDBSettings": { "ProviderParams": [ { "Name": "Data Source", "Description": "Data Source", "Value": "(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=127.0.0.1)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCL)))", "AllowEdit": "true" }, { "Name": "User Id", "Description": "Usuário", "Value": "userName", "AllowEdit": "true" }, { "Name": "Password", "Description": "Senha", "Value": "P@ssw0rd", "AllowEdit": "true", "Type": 1 } ] }, |
Informações | ||
---|---|---|
| ||
"Type": 0 (valor default) Utilize o "Type" : 0 quando o parâmetro for um literal comum. Será apresentado o texto puro normalmente. "Type":1 Utilize o "Type" : 1 quando for um parâmetro do tipo senha. Os valores serão criptografados no banco de dados. |
Hospedando No IIS:
Configuração do arquivo web.config:
Configure o arquivo web.config que se encontra na pasta principal da aplicação.
Insira o elemento abaixo o elemento abaixo filho do elemento system.webserver:
Informações | ||
---|---|---|
| ||
<modules runAllManagedModulesForAllRequests="false"> <remove name="WebDAVModule" /> </modules> |
Hospede um novo site no IIS informando como caminho físico a pasta principal em que o servidor se encontra. Atribua também uma porta esse serviço.
Em seguida, dentro de pool de aplicativos altere as configurações para o novo serviço que criamos. Selecione a “Versão do .NET CLR” para “Sem Código Gerenciado” conforme a imagem abaixo:
Dica |
---|
O usuário e senha do banco precisará de permissão para criação de banco de dados do RAC. Como sugestão informe o usuário e senha do "sa". |
Informações |
---|
Nesse passo, o banco de dados a ser criado, no caso o banco "TnfRac" não poderá existir no servidor "BHD050100275". Caso exista, apague o banco atual e recrie com as novas configurações. |
c) - No atributo "Clients" crie configurações para informar a máquina (ou as máquinas) que hospedarão o front-end do TReports:
c.1) - No Atributo "ClientId" deverá ser informado um identificador único que será usando nas configurações dos backEnds e FrontEnds;
c.2) - No atributo "AccessTokenLifetime" informe o tempo de expiração de um accessToque;
c.3) - No atributo "RedirectUris" informe os endereços que serão usados pelo retorno do Rac:
Retorno de callback após o login e renovação do accessToken após expiração;
c.4) - No atributo "PostLogountRedirectUris" informe os endereços usados pelo Rac após o logout;
c.5) - Nos outros atributos matenham os valores defaults;
Expandir | ||
---|---|---|
| ||
Nessa configuração, foram informados endereços da máquina localHost e porta 7017. Isso significa que o rac aceitará somente solicitações provenientes do endereço "http://localhost:7017"; "Clients": [ { "ClientId": "js_oidc", "ClientName": "JavaScript OIDC Client For Testing", "AllowedGrantTypes": [ "hybrid", "client_credentials" ], "RequireConsent": false, "AllowAccessTokensViaBrowser": "true", "AllowOfflineAccess": true, "AccessTokenLifetime": 300, // 5min em segundos "IdentityTokenLifetime": 250, "RedirectUris": [ "http://localhost:7017/auth-callback.html", "http://localhost:7017/auth-callback", "http://localhost:7017/assets/silent-renew.html", "http://localhost:7017/assets/silent-renew" ], "PostLogoutRedirectUris": [ "http://localhost:7017/" ], "AllowedCorsOrigins": [ "http://localhost:7017" ], "ClientSecrets": [ { "Value": "K7gNU3sdo+OL0wNhqoVWhr3g6s1xYv72ol/pe/Unols=" } ], // Calculado com IdentityServer4.Models.HashExtensions.Sha256() "AllowedScopes": [ "openid", "profile", "email", "authorization_api", "backend_api" ] }] |
Expandir | ||
---|---|---|
| ||
Nessa configuração, foram informados endereços da máquina BHN050102777 e porta 7017. Isso significa que o RAC aceitará somente solicitações provenientes do endereço "http://BHN050102777:7017"; Nesse caso o FrontEnd do Reports deve ser instalado em configurado na máquina BHN050102777. "Clients": [ { "ClientId": "js_oidc_bhd050100275", "ClientName": "JavaScript OIDC Client For Testing", "AllowedGrantTypes": [ "hybrid", "client_credentials" ], "RequireConsent": false, "AllowAccessTokensViaBrowser": "true", "AllowOfflineAccess": true, "AccessTokenLifetime": 300, // 5min em segundos "IdentityTokenLifetime": 250, "RedirectUris": [ "http://bhd050100275:7017/auth-callback.html", "http://bhd050100275:7017/auth-callback", "http://bhd050100275:7017/assets/silent-renew.html", "http://bhd050100275:7017/assets/silent-renew" ], "PostLogoutRedirectUris": [ "http://bhd050100275:7017/" ], "AllowedCorsOrigins": [ "http://bhd050100275:7017" ], "ClientSecrets": [ { "Value": "K7gNU3sdo+OL0wNhqoVWhr3g6s1xYv72ol/pe/Unols=" } ], // Calculado com IdentityServer4.Models.HashExtensions.Sha256() "AllowedScopes": [ "openid", "profile", "email", "authorization_api", "backend_api" ] }] |
d) - Entre no comand prompt do windows e acesse o diretório "c:/TReports/Rac/Migrator";
e) - Execute o comando "dotnet Tnf.Rac.EntityFrameworkCore.Migrator.dll";
Obs: Esse comando rodará a ferramenta de criaçaõ automática do banco de dados do Rac.
f) - Após rodar o comando, verifique se o banco de dados foi criado no servidor de banco de dados;
2) Configuração do Host do Rac:
a) - Descompacte o arquivo "HostRac.zip" dentro do diretório "c:\TReports\Rac\Host";
- No atributo "ConnectionStrings" informe a string de conexão conforme exemplo abaixo:
"ConnectionStrings": {
"Default": "Server=BHD050100275; TrustServerCertificate=True; database=TnfRac; User Id=sa;password=xxxx"
},
Dica |
---|
O usuário e senha do banco precisará de permissão para criação de banco de dados do RAC. Como sugestão informe o usuário e senha do "sa". |
Informações |
---|
Essa string de conexão deve ser a mesma usada no passo anterior "Criação do banco de dados do Rac" |
f) - Entre no diretório "TReports/Rac/Host" e abra o arquivo "hosting";
g) - Informe no atributo "urls" a sring: "http://*:5000" (essa configuração identificará a porta de hospedagem do rac);
Image Removed
Hospedando No KESTREL:
Abrir o arquivo “hosting.json” localizado na pasta principal do servidor e altere o endereço e porta do host do backend.
Informações | ||
---|---|---|
| ||
{ "urls": "http://127.0.0.1:5000" } |
Execute o arquivo "TRF.Rpt.api.Web.exe".
APIs:
O servidor possui disponibiliza suas API's e uma síntese de utilização através do swagger. Para visualizar e consumir recursos acesse a URL do seu servidor com a rota swagger.
http://nomedamaquina:4999/swagger
1.1) - Instale a versão do .Net Framework 4.7.1;
Obs: Disponível em "https://www.microsoft.com/pt-br/download/details.aspx?id=56116"
1.2) - Instale a última versão do runtime do .Net core;
Obs: Disponível em "https://www.microsoft.com/net/download/thank-you/dotnet-runtime-2.0.5-windows-x64-installer"
1.3) - Crie a seguinte estrutura de diretórios dentro da raiz da máquina:
c:\TReports\BackEnd;
c:\TReports\FrontEnd;
c:\TReports\Rac;
c:\TReports\Rac\Migrator;
c:\TReports\Rac\Host;
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|