Histórico da Página
Índice:
| Í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;
Configuração do RAC
É necessário configurar o RAC para garantir a segurança do T-Reports. Ele será responsável por validar os acessos á página.
Portanto, vamos rodar o processo de "Migrator" para criação do banco de dados do RAC. Para isso, basta seguir os passos abaixo:
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=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 |
|---|
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 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;
| Dica |
|---|
Deve ser o tempo (em segundos) até que o login precise ser renovado. |
c.3) - No atributo "RedirectUris" informe os endereços que serão usados pelo retorno do Rac:
| Dica |
|---|
Retorno de callback após o login e renovação do accessToken após expiração. Exemplos: "http://localhost:7017/auth-callback.html", - endereço usado para realizar o login "http://localhost:7017/auth-callback", - endereço usado para realizar o login "http://localhost:7017/assets/silent-renew.html", - endereço usado na renovação do login "http://localhost:7017/assets/silent-renew" - endereço usado na renovação do login |
c.4) - No atributo "PostLogountRedirectUris" informe os endereços usados pelo Rac após o logout;
c.5) - Nos outros atributos mantenham 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.
| Dica |
|---|
Caso a mensagem "Continue to migration for this host database? (Y/N):" apareça, digite "Y" para concluir. |
| Expandir | ||
|---|---|---|
| ||
|
f) - Após rodar o comando, verifique se o banco de dados foi criado no servidor de banco de dados;
Agora, vamos configurar o Host do Rac, para isso basta seguir os passos abaixo:
a) - Descompacte o arquivo "HostRac.zip" dentro do diretório "c:\TReports\Rac\Host";
Abra o arquivo "appsettings.json" do diretório "c:\TReports\Rac\Host" e efetue as seguintes modificações:
- 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" |
b) - Entre no diretório "TReports/Rac/Host" e abra o arquivo "hosting";
- Informe no atributo "urls" a string: "http://*:5000" (essa configuração identificará a porta de hospedagem do RAC);
Configuração do T-ReportsBackEnd
1) - Descompacte o arquivo BackEnd.zip dentro do diretório "c:\TReports\BackEnd";
2) - Abra o arquivo "appsettings.json" e efetue as seguintes modificações:
a) - No atributo "ConnectionStrings" informe a string de conexão contendo a localização do banco de dados do repositório do T-Reports:
"ConnectionStrings": {
"Default": "Server=BHD050100275; TrustServerCertificate=True; database=TReportsDB; User Id=sa;password=xxxx"
},
| Dica |
|---|
O usuário e senha do banco precisará de permissão para criação de banco de dados de repositório do TReports Como sugestão informe o usuário e senha do "sa". |
Atualmente somente o SqlServer poderá ser usando como repositório do T-Reports;
| Informações |
|---|
Se o banco de dados "TReportsDB" não existir, ao hospedar o backEnd esse banco será criado automaticamente; |
b) - No atributo "BackgroudJobSettings", no parêmetro "DelayTime", informe a quantidade em "minutos" para leitura da tabela de "agendamento de execução de jobs" (default será 1 minuto). Mantenham os valores defaults para os outros parâmetros;
c) - No atributo "DefaultDbSettings", informe os dados (defaults) para criação de provedores de banco de dados relacional.
| Dica |
|---|
Essa configuração não é obrigatória, portanto ela poderá ser removida. Nesse caso, os atributos de string de conexão devem ser criados manualmente na tela Cadastro de Provedor de Dados para banco de dados relacionais. Caso os dados sejam informados, as informações serão buscadas ao clicar em "Buscar Parâmetros" na tela de Cadastro de Provedor de Dados. |
| Expandir | ||
|---|---|---|
| ||
"DefaultDBSettings": { "ProviderParams": [ { "Name": "Data Source", "Description": "Nome do servidor", "Value": "BHD050101861", }, { "Name": "Initial Catalog", "Description": "Nome do banco de dados", "Value": "RM1201", }, { "Name": "Integrated Security", "Description": "Segurança integrada", "Value": "false", }, { "Name": "User Id", "Description": "Usuário", "Value": "rm", }, { "Name": "Password", "Description": "Senha", "Value": "rm", "AllowEdit": "true", } ] }, |
3) - Abra o arquivo "Hosting.json" e informe o endereço "urls": "http://*:4999" de hospedagem do backEnd;
4) - Abra o arquivo "racsettings.json" e no atributo "AuthorityEndpoint" informe o endereço de hospedagem do rac, conforme exemplo abaixo:
{
"AuthorityEndpoint": "http://localhost:5000/",
"ApiName": "backend_api",
"RequireHttpsMetadata": false,
"CacheAuthentications": false,
"CacheAuthenticationDuration": 10
}
Configuração do T-ReportsFrontEnd
| Informações |
|---|
Essa forma de configuração é temporária, visto que estamos melhorando o módulo de configuração do frontEnd. |
1) - Descompacte o arquivo FrontEnd.zip dentro do diretório "c:\TReports\FrontEnd";
2) - No diretório "c:\TReports\FrontEnd", abra o arquivo "main.bundle" e efetue as seguintes modificações:
a) - Pesquise dentro desse arquivo a palavra "client_id" e informe o identificador do client criado no passo "c.1" da Configuração do RAC.
Exemplo: client_id: 'js_oidc';
b) - Pesquise dentro desse arquivo a palavra "var environment = {" e confiugure no atributo "authorityEndPoint" o endereço de hospedagem do RAC definido na Configuração do Host do RAC acima.
Exemplo: 'http://localhost:5000/'
c) - Ainda dentro do environment, informe no atributo "applicationEndPointHost' o endereço base de hospedagem Backend na porta 4999;
d) - Ainda dentro do environment, informe no atributo "applicationEndPoint" o endereço de rota de hospedagem Backend na porta 4999;
| Dica |
|---|
Tudo certo! Agora só falta configurar os tipos de hospedagem. Para isso, basta acessar a página: Tipos de hospedagem. |
| Informações | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
| Informações | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas