Histórico da Página
...
Atenção: será necessário que a instituição tenha um cadastro válido na plataforma do Facebook;
2º- Acesse o menu “Meus Aplicativos” em seguida o item “Adicionar um novo aplicativo”;
...
5º- Será exibido as configurações do login do Facebook. Nesta etapa, você deverá informar a URL em que está hospedada o portal do aluno da instituição, no campo “URI’s de redirecionamento do OAuth válidos”. Como exemplo, nós iremos informar um endereço baseado em “localhost”, pois o Portal do Aluno de exemplo encontra-se na mesma máquina em que é feito a configuração (definimos o endereço: (http://localhost:8080/web/app/edu/PortalEducacional/).
6º- Clique no menu lateral na opção “Configurações”. Nessa seção, será necessário definir apenas a configuração “Domínio do aplicativo”, que no caso é “localhost”. Também é possível definir configurações adicionais como Logo da empresa, URL da política de privacidade, URL de Termos de Serviço e etc (que são opcionais para o funcionamento do serviço desejado, mas recomendável que a instituição faça seu preenchimento).
7º- Na mesma página do item anterior, será necessário adicionarmos para qual plataforma nosso aplicativo será utilizado. Desta forma, clique no botão “Adicionar Plataforma” e escolha a opção “Site”.
Após essa ação, será criado uma seção na página que contém o campo “URL do Site”, onde iremos informar o local onde está hospedado o portal do aluno (http://localhost:8080/web/app/edu/PortalEducacional/).
8º- ATENÇÃO: Com o objetivo de melhorar a segurança do aplicativo Facebook em integração ao ERP TOTVS, sugerimos que a instituição de ensino ative a opção no print abaixo, para evitar tentativas de acesso mal intencionados, a partir do roubo de token de acesso dos usuários. Para ativar essa configuração acesse o menu “Configurações” e em seguida “Avançado”. Localize e ative o item “Exigir Chave Secreta do Aplicativo” (Somente permita chamadas de um servidor e exija o segredo do aplicativo ou comprovação do segredo do aplicativo para todas as chamadas de API). Para finalizar salve as configurações.
Observação: a partir da versão 12.1.22 do RM, a configuração "Exigir Chave Secreta do Aplicativo” não deve estar ativada.
9º- Uma vez definida todas as configurações necessárias para funcionamento do aplicativo de Login via Facebook, precisaremos de alguns dados para fazermos a ligação do aplicativo com o sistema RM. Para isso, acesse o menu “Painel”, onde estão as informações necessárias para fazer essa integração. Anote os dados destacados conforme a imagem abaixo;
10º- Acesse o RM, em seguida vá na aba “Gestão”, localize o grupo “Comunicação” e em seguida clique no menu “Aplicativos Externos”. Caso o mesmo não esteja disponível, será necessário aplicar permissão para o usuário nas configurações de perfis de acesso do sistema de Serviços Globais;
11º- Crie um novo registro na visão de aplicativos externos. Neste registro deverão ser incluídas todas as informações destacadas no passo 9. Atenção, no campo “Provedor do Aplicativo” deveremos selecionar o valor “1 - Facebook”.
12º- Ao cadastrar todas as configurações no aplicativo como também no sistema RM, deveremos ativar a integração no portal do aluno. Para isso, no arquivo de configurações do portal do aluno “\RM\Atual\Release\FrameHTML\web_src\app\Edu\PortalEducacional\js\edu-contantes.global.config.js” deverá ser configurada a variável “EDU_CONST_GLOBAL_ID_CONFIG_SSO_FACEBOOK” com valor do Id de Configuração do Aplicativo externo cadastrado no RM, neste exemplo “22” a variável de configuração.
13º- Por último, será necessário publicar o aplicativos Facebook para habilitar seu funcionamento ser tornar público. Acesse o menu “Revisão do Aplicativo”, e ative “sim” para o item “Tornar [NOME DO APLICATIVO] público?”.
Acesso do aluno após as configurações no Facebook para desenvolvedores:
No primeiro acesso que o aluno fizer com o facebook será exibido uma mensagem falando que o TOTVS portal do aluno receberá as permissões para o perfil público, lista de amigos e endereço de email. Ainda na mesma tela o aluno pode editar as informações que ele deseja e assim continuar o processo. Após este passo e o aluno logar é exibido uma mensagem onde é informado que o portal não armazena nenhuma informação pessoal sendo opcional aceitar, porém o login com o facebook só irá continuar se ele associar as contas. Segue:
Primeiro acesso pelo facebook é exibido essa mensagem:
...
Informações | ||
---|---|---|
| ||
...