Na janela de Configurações do Projeto é é possível visualizar informações e alterar diversas propriedades do sistema . , seus campos estão dispostos em uma janela com abas e subabas.

Image Modified

Figura 1 - Acesso à aba Geral da janela de Configurações do Projeto

A janela pode ser acessada por três caminhos:

1. Menu do sistema Projeto > Configurações  (destaque 1 da figura 1);.
2. Arquivo app.config (Endereço config/) na Opção Configurações do menu de contexto na raiz da árvore de arquivos (figura destaque 2 da Figura 1.21);
   Quando
   1. Esse arquivo só estará visível ao ativar o Modo Avançado.
   1. Opção Configurações do menu de contexto da raiz da  estiver ativado, acesse app.config no diretório config na árvore de arquivos (Figura destaque 3 da figura 1.2 1).

   
   

   

   Figura 1.2 1 - Acesso as configurações via menu de contexto ou arquivo app.config

   
   

   As abas Geral e , Configurações do Projeto e Configurações de E-mail sempre serão exibidas, já as demais abas , só aparecerão a partir de determinadas configurações.

   Aba Geral

   Exibe diversas informações sobre o sistema e seu o criador , além do Perfil do Banco de dados. (Figura 1)

   Informações

   do projeto.

   
   

   Image Added

   Figura 2 - Aba das Configurações Gerais do projeto

   Caso você entre em contato com o nosso suporte, os campos de ID's (Projeto, Cópia de trabalho, Usuário e Contratos) podem ser requisitados para facilitar a análise de possíveis problemas.

   
   

   • Nome do Projeto: permite alterar o nome do projeto.
   • Grupo id: identificador do grupo para o projeto mobile.
   • Artefato id: identificador do artefato para o projeto mobile.
   • Versão: Define uma versão ao seu projeto.
   • Tema Web: Seleciona um tema para ser utilizado exclusivamente nos formulários Web.
   • Tema Mobile: Seleciona um tema para ser utilizado exclusivamente nos formulários Mobile.
   • define a versão atual do projeto.
   • Backup Automático: permite que o Cronapp crie backups automáticos do seu projeto. Para mais informações, acesse Backup Cronapp.
   • Data de Criação do Projeto em horário GMT.
   • ID do Projeto: identificador do seu projeto na estrutura interna do Cronapp.
   • ID Cópia de Trabalho: identificador da cópia de trabalho do projeto na estrutura interna do Cronapp.
   • Tipo do Projeto: pode ser web ou mobile.
     • Web: projeto não possui módulo aplicação mobile;
     • Mobile: projeto contém módulo aplicação mobile e pode ou não conter módulo aplicação web.
   • Administrador: nome do criador do projeto.
   • ID do Usuário: identificador do criador do projeto. 
   • ID do Contrato: identificador do contrato Cronapp vinculado ao criador do projeto.
   • PerfilPaís e Idioma: define o perfil padrão do banco de dados e dos Parâmetros do sistema.o país e o idioma que serão usados por alguns recursos do projeto, por exemplo, os blocos de programação Formatar Data e Formatar Data com Fuso. 
   • Codificação: define o tipo de codificação de caracteres nos arquivos do projeto, o padrão é o "UTF-8".

   • Rota Principal Web: define a página inicial ao abrir a URL da aplicação web. Só é possível alternar entre a página login (Localização: Formulários/Web/login 

     Tooltip
     onlyIcon true appendIcon info-circle
     Endereço: src/main/webapp/views/login.view.html

     ) ou qualquer página dentro do diretório Público (Localização: Formulários/Web/Público/ 

     Tooltip
     onlyIcon true appendIcon info-circle
     Endereço: src/main/webapp/views/public/

     ).

   • Rota Principal Mobile: define a tela inicial ao abrir a URL da aplicação mobile. Só é possível alternar entre a tela login (Localização: Formulários/Mobile/login 

     Tooltip
     onlyIcon true appendIcon info-circle
     Endereço: src/main/mobileapp/www/views/login.view.html

     ) ou qualquer tela dentro do diretório Público (Localização: Formulários/Mobile/Público/ 

     Tooltip
     onlyIcon true appendIcon info-circle
     Endereço: src/main/mobileapp/www/views/public/

     ).

   
   

   Informações
   Caso você entre em contato com o nosso suporte, os campos de ID's (Projeto, Cópia de trabalho, Usuário e Contratos) podem ser requisitados para facilitar a análise de possíveis problemas.

   Âncora
   abaConfiguracoesProjeto abaConfiguracoesProjeto
   Âncora
   aba-configuracoes-projeto aba-configuracoes-projeto

   Aba Configurações do Projeto

   Permite realizar diversas configurações relacionadas a segurança do projeto.

   Image Removed

   Essa aba possui diversos campos de configurações agrupados em subabas (acordeão). Clique sobre as subabas para expandir ou recolher seus campos. 

   Permissões

   Os campos dessa subaba permitem definir formas de autorização para alguns recursos do projeto (Figura 3).

   
   

   Image Added

   Figura 3 Figura 2 - Aba Configurações do Projeto - Permissões

   
   

   • Expor Metadados: permite obter os metadatas OData do sistema através do endereço:
     <URL do sistema>/api/cronapi/odata/v2/app/$metadata
     Expor os metadados pode ser útil ao obter campos de um web services na fonte de dados, veja mais detalhes no tópico "Obter campos do serviço com metadados" na documentação da Fonte de dados.
     • É possível restringir o acesso aos metadados para os permissionáveis do sistema através do ícone cadeado no final do campo, esse ícone ficará desabilitado ao desmarcar a caixa de checagem do recurso.

   • Expor Entidades: permite obter os dados diretamente das entidades através do endereço
      <URL do sistema>/api/cronapi/odata/v2/app/<Entidade>. 

     • É possível restringir o acesso às consultas das entidades para os permissionáveis do sistema através do ícone cadeado no final do campo, esse ícone ficará desabilitado ao desmarcar a caixa de checagem do recurso.

       Aviso
       Como informado no tópico "Uso de entidades vs. fonte de dados" do Manual de Boas Práticas, essa opção não é recomendada.

   • Permitir abrir o projeto em Iframe: possibilita que o conteúdo do seu projeto seja aberto e compartilhado em outras páginas. Por padrão, já vem habilitado com a opção "Permitir da mesma origem" e cada propriedade possui um tipo de restrição diferente, podendo diminuir ou aumentar a segurança do X-Frame.
     • Qualquer endereço: remove completamente a segurança do X-Frame, permitindo que sua aplicação possa ser chamada por qualquer endereço.
     • Não permitir: desabilita a chamada do projeto via Iframe.

     • Permitir da mesma origem: possibilita que o Iframe seja usado apenas por endereços dentro da URL Base. Por exemplo: o endereço "exemplo1.ide.cronapp.io/usuarios" será aceito, pois a página "usuarios" está contida no domínio "exemplo1.ide.cronapp.io/".

       Informações
       title Observação
       O servidor pode sobrescrever as opções colocadas na aplicação, por tanto, caso o comportamento do projeto não esteja como selecionado na aplicação, provavelmente já existe uma configuração pré-definida no servidor.

   • Exibir Chaves Compostas: a fonte de dados concatena todas as primary keys de entidades com chaves compostas no atributo "_objectKey", dessa forma é possível trabalhar com uma única chave primária. Exemplo: <chave1>~<chave2>~<chaveN>
     • ativadoAtivado: utiliza todas as chaves primárias, de modo a manter a compatibilidade com projetos das versões antigas do Cronapp;
     • desativadoDesativado: utiliza o atributo "_objectKey".
   • Adicionar Campos de Pesquisa: exibe um campo display da classe relacionada.
     Por exemplo: Ao listar a entidade que possui a chave estrangeira de um relacionamento 1 para N (pessoa - telefone), os campos apresentados serão:
     
     • ativadoAtivado: telefone(id, numero, pessoa, pessoa_nome), o campo pessoa possui a chave estrangeira e pessoa_nome o display; 
     • desativadoDesativado: telefone(id, numero, pessoa), o campo pessoa possui a chave estrangeira e não existe campo display; 
     País e Idioma: define o país e o idioma que serão usados por alguns recursos do projeto, por exemplo, os blocos servidor para formatação de data e hora.

   Âncora
   subabaConfAutenticacaoSeguranca subabaConfAutenticacaoSeguranca

   Autenticação e Segurança

   A subaba Autenticação e Segurança possuem campos que permitem definir as formas de autenticação e segurança do sistema.

   
   

   Image Added

   Figura 3.1 - Aba Configurações do Projeto - Autenticação

   
   

   • GUID: chave única de autenticação para do sistema. 

   • Token: token de autenticação da aplicação.

     Informações
     title Observação
     Tanto o campo GUID, quanto o Token permitem, por exemplo, que um usuário possa fazer uma única autenticação para dois sistemas distintos. Acesse o tópico "Autenticação entre projetos Cronapp" na documentação da Fonte de dados para maiores informações.

   • Expiração do Token (segundos): tempo em que o token ficará ativo.
   • Converter Fuso Horário do Cliente: permite salvar data e hora em banco a partir do fuso horário do cliente. Acesse Entendendo o funcionamento dos tipos data e hora para mais informações.
   • Após esse tempo o token será atualizado automaticamente.
   • Manter Log de Auditoria (dias): define o tempo que os dados da auditoria em log ficarão salvos no banco de dados (tabela AUDIT_LOG)Fuso Horário: define o fuso horário do sistema. Acesse Entendendo o funcionamento dos tipos data e hora para mais informações.
   • Recaptcha: chave recaptcha para validação do lado servidor. Acesse Captcha para mais informações.
   • Autenticação: define o tipo de autenticação da aplicaçãodo projeto. A depender do tipo de autenticação selecionado, a subaba de Configurações de Autenticação aparecerá logo abaixo do campo Autenticação.

     • Nenhuma

       ;

       : sem autenticação.
       

     • Sessão; autenticação via sessão no servidor da aplicação;.
     • Token; autenticação via jwt;.
     • Active Directory: clique aqui para mais detalhesexibe a subaba Configurações da Autenticação com os campos desse tipo de autenticação.
     • LDAP:  clique aqui para mais detalhesexibe a subaba Configurações da Autenticação com os campos desse tipo de autenticação.
     • SSO (Oauth2): clique aqui para mais detalhes.
     • SAML: clique aqui para mais detalhes.
     Permitir abrir o projeto em Iframe: possibilita que o conteúdo do seu projeto seja aberto e compartilhado em outras páginas. Por padrão, já vem habilitado com a opção "Permitir da mesma origem" e cada propriedade possui um tipo de restrição diferente, podendo diminuir ou aumentar a segurança do X-Frame.
   • Qualquer endereço: remove completamente a segurança do X-Frame, permitindo que sua aplicação possa ser chamada por qualquer endereço.
   • Não permitir: desabilita a chamada do projeto via Iframe.

   Permitir da mesma origem: possibilita que o Iframe seja usado apenas por endereços da mesma origem, como, por exemplo: "exemplo1.ide.cronapp.io/usuários" em que o endereço foi alterado, mas a origem continuou a mesma do "exemplo1.ide.cronapp.io/" alterando apenas o host da URL (o que fica após a barra depois do link).

   Informações

   title	Observação

   O servidor pode sobrescrever as opções colocadas na aplicação, por tanto, caso o comportamento do projeto não esteja como selecionado na aplicação, provavelmente já existe uma configuração pré-definida no servidor.
   • : exibe a subaba Configurações da Autenticação com os campos desse tipo de autenticação.
   • SAML: exibe a subaba Configurações da Autenticação com os campos desse tipo de autenticação.
   • Login por Redes Sociais: essa opção só é permitida para as autenticações do tipo Sessão ou Token. Quando selecionado exibe a aba Redes Sociais na janela de Configurações do Projeto.
   • Autenticação Mútua (Certificado Digital): essa opção só é permitida para as autenticações do tipo Sessão e Token. Acesse Autenticação mútua (certificado digital) para maiores informações.
   • Permitir que os Usuários se Cadastrem: habilita o recurso para que os usuários do projeto possam se cadastrar.
     

   Configuração Avançada

   Possui campos para definir as regras de segurança das senhas dos usuários do sistema (Figura 3.1).

   
   

   Informações
   Vale destacar dois pontos sobre os campos de regras de senhas: Esses campos só são válidos para as autenticações do tipo Sessão e Token. Para funcionar, é necessário que o campo Política de Senha nas configurações do atributo password da classe User no Diagrama de dados esteja definido como "Completo", ao invés do padrão "Nenhum".

   Informações
   O valor "0" nos campos de regra de senha desativa a propriedade. Por exemplo, ao informar o valor "0" no campo Tempo de ociosidade (minutos), o usuário nunca será deslogado.

   
   

   • Tamanho mínimo da senha: quantidade mínima de caracteres.
   • Número de tentativas antes do bloqueio: define a quantidade máxima de tentativas com a senha errada para o bloquear o usuário.
   • Tempo de bloqueio: tempo que o usuário permanecerá bloqueado após errar a senha do login pelo número definido no campo "Número de tentativas antes do bloqueio".
   • Tempo de ociosidade (minutos): tempo para deslogar o usuário por inatividade no sistema.
   • Mínimo de caracteres maiúsculos: só serão aceitas senhas com a quantidade mínima de caracteres maiúsculos informado nesse campo. 
   • Mínimo de caracteres numéricos: só serão aceitas senhas com a quantidade mínima de caracteres numéricos informado nesse campo. 
   • Mínimo de caracteres especiais: só serão aceitas senhas com a quantidade mínima de caracteres especiais informado nesse campo. Lista dos caracteres especiais:
     Image Added
   • Aceitar apenas senhas fortes: ao marcar esse campo, todas as senhas devem passar pelos critérios abaixo:
     1. Não serão aceitas senhas que contenham 3 ou mais caracteres em sequência das seguintes sequências:
        • Alfabeto minúsculo: "abcdefghijklmnopqrstuvwxyz",
        • Alfabeto maiúsculo: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        • Sequência numérica: "0123456789";
     2. Não serão aceitas senhas que contenham 3 ou mais caracteres em sequência da disposição do teclado "QWERTY";
     3. Não serão aceitas senhas que contenham apenas espaços em branco.
   • Não permitir senhas repetidas: impede o usuário de reutilizar a mesma senha usadas nas 3 últimas redefinições de senhas.

   Âncora
   subabaConfAutenticacao subabaConfAutenticacao

   Configurações da Autenticação

   A subaba Configurações de Autenticação (destaque 2 da figura 3.2) só será exibida ao selecionar as opções abaixo no campo Autenticação (destaque 1 da figura 3.2). Acesse a documentação de cada tipo de autenticação para mais detalhes sobre seus campos de configurações.

   
   

   • Active Directory;
   • LDAP;
   • SSO (Oauth2);
   • SAML.

   
   

   Image Added

   Figura 3.2 - A subaba Configurações da Autenticação só é exibida ao selecionar determinadas autenticações

   Banco de Dados

   Campos para configurações com o Banco de dados do sistema.

   
   

   Image Added

   Figura 3.3 - Aba Configurações do Projeto - Banco de Dados

   
   

   • Descarregar dados da transação: define o tipo de descarga de dados para a transação no projeto, podendo ser:
     • Sempre: padrão utilizado, faz com que a descarga dos dados seja feita no banco de dados antes que a consulta seja executada;
     • Ao comitar: faz a descarga dos dados no banco e grava essas mudanças quando houver uma chamada de commit ou flush.
   • Login por Redes Sociais: essa opção só é permitida para as autenticações do tipo Sessão e Token, e quando selecionado exibe a aba "Redes Sociais" na janela de Configurações do Projeto.
   • Autenticação Mútua (Certificado Digital): essa opção só é permitida para as autenticações do tipo Sessão e Token. Acesse Autenticação mútua (certificado digital) para maiores informações.

   Os campos abaixo são exibidos apenas nas autenticações Active Directory e LDAP.

   • Fuso Horário: define o fuso horário do sistema. Acesse Entendendo o funcionamento dos tipos data e hora para mais informações.
   • Converter Fuso Horário do Cliente: permite salvar data e hora em banco a partir do fuso horário do cliente. Acesse Entendendo o funcionamento dos tipos data e hora para mais informações.

   Tema

   Possui campos para a seleção dos temas e skins das aplicações clientes. A primeira linha permite configurar o Tema e Skin da aplicação Web, enquanto a segunda alterna o Tema e Skin da aplicação mobile.

   
   

   Image Added

   Figura 3.4 - Aba Configurações do Projeto - Tema

   
   

   1. Preview do tema: exibe uma imagem de exemplo do tema selecionado.
   2. Nome do tema. 
   3. Buscar: abre a janela de seleção dos temas.
   4. Preview do skin: exibe as 5 principais cores do skin selecionado.
   5. Endereço do skin.
   6. Buscar: abre a janela de seleção dos skins criados.
   7. Limpar: remove a seleção do skin, retornando as configurações padrão do tema selecionado.

   Swagger / Open API

   Habilita os recursos que estarão disponíveis na janela de recursos do Swagger / Open API.

   
   

   Image Added

   Figura 3.5 - Aba Configurações do Projeto - Swagger / Open API

   
   

   • Ativar documentação de API's REST: habilita o recurso do Swagger através do endereço "<domínio>/api/metadata/". Caso essa opção esteja desabilitada, será exibido um erro 403.
   • Ativar para autenticação: exibe os endpoints de autorização (/auth e /auth/refresh) na tela do Swagger, permitindo testar os recursos privados. 
   • Ativar para entidades: exibe os recursos REST habilitados nas classes do Diagrama de dados.
   • Ativar para fontes de dados: exibe os recursos REST habilitados nas Fontes de dados.
   • Ativar para blocos: exibe os recursos REST habilitados nas configurações dos Blocos de programação.

   Configurações de E-mail

   Os campos abaixo são utilizados em conjunto com os recursos de envio automático de senha e recuperação de senha do usuário.

   
   

   Image Added

   Figura 4 - Aba Configurações do Projeto - Configurações de E-mail

   Servidor de E-mail SMTP

   Dados do servidor do e-mail (Figura 4).

   • Host do Servidor SMTP: endereço SMTP do servidor de e-mail.
   • Usuário de Login do Servidor SMTP: login do usuário do servidor SMTP que irá disparar os e-mails.
   • Senha de Login do Servidor SMTP: senha do usuário do servidor SMTP.
   • Protocolo usado pelo Servidor SMTP: protocolo usado pelo servidor SMTP.
   • Porta do Servidor SMTP: porta usada pelo servidor SMTP.
   • Habilita o uso do Comando AUTH: permitir o uso de comandos de autenticação.
   • Habilita o uso do Comando STARTTLS: permitir o uso de comandos STARTTLS.
   • Tamanho do Batch: define a quantidade de e-mails que serão enviados por lote.
   • Expressão Cron: define regras de agendamento para o disparo de e-mails através de Cron expressions.

   Dados do Remetente (Reset de Senha)

   Dados do remetente (Figura 4).

   • Nome: nome do remetente do e-mail.
   • Email: endereço do e-mail usado para disparar os e-mails
   • Domínio Padrão: domínio padrão do servidor. Exemplo: minhaempresa.local.
   • Servidor LDAP: (ou Active Directory) IP ou host do servidor. Exemplo: 192.168.1.1.
   • Grupo: restringe o acesso a um grupo específico do AD / LDAP. Clique aqui para mais detalhes.
   • Inscrição Automática: quando ativado, caso o usuário não esteja registrado na base interna da aplicação, o mecanismo de logon irá inclui-lo automaticamente após sua autenticação no Active Directory/LDAP.

   Aba Controle de versão

   A aba só será exibida quando o projeto estiver sob controle de versão (GitGIT). Image Removed

   
   

   Image Added

   Figura 3 5 - Aba Controle de versão

   
   

   Com exceção do campo URL do Repositório, todos os outros campos permitem atualizações.

   • URL do Repositório: endereço informado ao exportar projeto.
   • Usuário do sistema de versionamento. 
   • Senha do sistema de versionamento.
   • Nome do Autor na assinatura do commit.
   • Email do Autor na assinatura do commit.
   • Botão Autorizar Github: esse botão será exibido apenas quando a URL do repositório for um link do Github, ao clicar, um token OAuth será gerado, vinculando sua conta do Github ao seu projeto no Cronapp. Vejas mais detalhes no tópico "Autenticação com o Github" na documentação Versionamento usando Git.

   Âncora
   abaRedesSociais abaRedesSociais

   Aba Redes Sociais

   A aba só será exibida se a opção Login por Redes Sociais estiver ativa na subaba Autenticação da aba Configurações do Projeto estiver ativa. Ela permite configurar o sign-up por login social para usuários com contas ativas no Cronapp e também nas seguintes redes sociais: Facebook, Github, Linkedin e Google.

   É necessário acessar a área de desenvolvedor de cada rede social e configurar a sua aplicação. Para mais detalhes, acesso o tutorial Login por redes sociais.

   
   

   Image RemovedImage Added

   Figura 4 6 - Aba Redes Sociais

   
   

   1. Checkbox Inscrição Automática: faz o cadastro automático durante o primeiro login social.
      
   Colunas:
   1. Nome da rede social.
   2. Checkbox Rede social: define quais redes sociais poderão autenticar na sua aplicação;
3. Ao ativar a opção Cronapp, 
1. ID da Aplicação: o
ID
1. identificador de autorização é
obtido 
1. obtido após cadastrar sua aplicação na área de desenvolvedor da rede social.
2. Segredo da Aplicação: a chave secreta de autorização é obtida após cadastrar sua aplicação na área de desenvolvedor da rede social
.

Aba Configurações da Autenticação

A aba só será exibida se a opção "SSO (Oauth2)" ou "SAML" estiver selecionada no campo Autenticação na aba Configurações do Projeto. Ela permite adicionar as informações necessárias para os tipos de autenticação especificados.

Image Removed

Figura 5 - Aba Configurações de Autenticação do SSO (OAuth2)

4. ID do Cliente: O ID do cliente encontrado nas configurações do provedor de autenticação SSO.
5. Segredo do Cliente: O segredo do cliente encontrado nas configurações do provedor de autenticação SSO.
6. URI do Token de Acesso: URI do provedor OAuth2 que fornece o token de acesso para a aplicação.
7. URI de Autorização do Usuário: URI para o qual o usuário será redirecionado, se for necessário, para autorizar o acesso ao recurso.
8. URI de Informações do Usuário: URI para obter detalhes atuais do usuário.
9. Escopos: Limita a quantidade de acesso concedida.
   • openid: fornece tokens para autenticação;
   • profile: fornece o acesso às informações sobre o usuário, como: nome, sobrenome, nome preferencial e ID de objeto;
   • email: concede acesso ao endereço de e-mail principal do usuário.
Chave Principal Customizada Oauth2: campo opcional que permite definir qual o identificador do usuário será retornado após a autenticação. Caso não seja preenchido, uma lista padrão retornará com os dados do usuário: id, e-mail, nome e outros
1. .