Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
titleImportante

Como o TOTVS Educa Mobile e o Portal Corpore.Net utilizam a mesma parametrização para suas funcionalidades, caso o cliente já tenha o Portal Corpore.Net instalado e disponibilizado, as permissões para as funcionalidades já foram concedidas e a parametrização realizada.

Após o item concluir esse guia de instalação e configuração não é mais necessário nenhuma configuração adicional. Caso queira verificar algum detalhe sobre parâmetros ou permissões, consulte i item "02 - Parametrização e permissões".

Certifique-se que o "RM.Host.exe" ou "RM.Host.Service.exe" do servidor de aplicação esteja iniciado e acesse a URL http://SeuDominio/EducaMobile.

1.2 - Aplicação Externa


Existe a possibilidade de adicionar links para sites externos da instituição no menu principal do Educa Mobile. Basta alterar o arquivo Menu.XML (Localizado em <Diretório de instalação do ERP>\CorporeRM\EducaMobile\Areas\Educacional), inserindo um novo item de Menu conforme o quadro abaixo:

Bloco de código
languagexml
firstline1
titleExemplo - Item de menu externo
linenumberstrue
(...)
	<MenuItem>
     	<Tag>0</Tag>
     	<Caption>NOME DO MENU</Caption>
     	<Image>Areas/Educacional/Content/images/mn_AplicacaoExterna.png</Image>
     	<ExternalURL>LINK DA APLICAÇÃO EXTERNA</ExternalURL>
     	<TipoUser>A</TipoUser>
     	<SetContext>S</SetContext>
     	<Module>S</Module>
	</MenuItem>
(...)

Referência


  • TAG - ID de segurança de perfil de acesso do RM. O valor zero não irá validar perfil de acesso por usuário neste item de menu. (Uso interno, valor padrão 0)
  • CAPTION - Nome da funcionalidade a ser acessada
  • IMAGE - caminho da imagem a ser vinculada a funcionalidade no menu
  • EXTERNALURL - URL a ser redirecionada
  • TIPOUSR - Menu disponível para A - aluno ou P - professor
  • SETCONTEXT - S ou N se deverá abrir a seleção de contexto antes de redirecionar para URL Externa
  • MODULE - Indicativo do módulo associado a funcionalidade (Uso interno, valor padrão S)

Âncora
URL Segura (HTTPs)
URL Segura (HTTPs)


A funcionalidade de Aplicação Externa incluí a página indicada dentro de uma TAG de IFrame do Educa Mobile.

Caso seja incluído uma URL segura (HTTPs), alguns browsers podem bloquear o acesso, apresentando o erro: "Refused to display 'https://www.URLEXTERNA.com/' in a frame because it set 'X-Frame-Options' to 'sameorigin'.".

A URL a ser adicionada deve atender os seguintes critérios:

  • A URL segura, de destino, deve estar no mesmo domínio do Educa Mobile; ou
  • O site referenciado deve permitir acesso do Educa Mobile via IFRAME. No servidor WEB deverá permitir a URL receber requisições do Educa Mobile.


Bloco de código
languagexml
firstline1
titleWeb.config
linenumberstrue
(...)
	<httpProtocol>
    	<customHeaders>
      		<add name="X-Frame-Options" value="ALLOW-FROM https://educamobile.instituicao.com.br" />
    	</customHeaders>
	</httpProtocol>
(...)

Exemplo de configuração do Web.Config no IIS do servidor WEB da aplicação destino


Caso não tenha acesso ao Servidor Web da URL, não será possível realizar a configuração acima, sendo assim não poderá utilizar este endereço como Aplicação Externa.


1º exemplo: adicionando a URL do Google (https://www.google.com.br) não será exibida no Educa Mobile, pois este link tem a origem de um servidor diferente e o browser irá bloquear.

2º exemplo: quero adicionar a URL do site de LMS da instituição no Educa Mobile. Devo disponibilizar o Educa Mobile no mesmo domínio ou permitir acesso a URL do Educa Mobile no servidor WEB da aplicação de LMS.


Nota
titleReferências

Um exemplo de configuração do parâmetro "X-Frame-Options"  no Corpore.Net

https://centraldeatendimento.totvs.com/hc/pt-br/articles/360023802492-RM-Frame-utilizar-o-RM-Portal-Corpore-Net-em-iFrame


Especificação técnica sobre a restrição de segurança

https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options