Sincronização do Badiu.Net com Moodle

Nesta seção, explicaremos como a plataforma Badiu.Net realiza a integração com o Moodle. Abordaremos como cadastrar as instâncias da plataforma Moodle dentro do sistema Badiu.Net.

A integração entre a plataforma Badiu.Net e o Moodle ocorre de forma bidirecional, permitindo consultas, escrita e edição de dados em ambas as plataformas. Essa comunicação é validada por chaves de autenticação registradas em ambas, garantindo a segurança na transmissão de dados por meio dos protocolos HTTP. Não se recomenda o uso de HTTP sem o SSL ativado.

No Moodle, a conexão é realizada por meio de três plugins que funcionam como conectores: Badiu.Net (badiunet), Badiu WebService (badiuws) e Badiu Auth (badiuauth).

O plugin Badiu.Net estabelece a base de conexão entre o Moodle como um todo e a plataforma Badiu.Net. Ele gerencia tokens de várias instâncias da plataforma Badiu.Net, possui funcionalidades de proxy, realiza consultas SQL, entre outras operações.

O Badiu Webservice é um plugin que disponibiliza serviços para criação de cursos, consulta de conteúdos e execução de comandos SQL. No entanto, este conector está programado para ser desativado no futuro, já que suas funcionalidades serão incorporadas ao plugin Badiu.Net.

O Badiu Auth é o plugin responsável por autenticar os usuários no Moodle utilizando as credenciais gerenciadas pela plataforma Badiu.Net.

Esses conectores são a base de comunicação entre o Moodle e a plataforma Badiu.Net. Todos os módulos que compõem a plataforma Badiu.Net utilizam essa estrutura para efetuar a comunicação com as instâncias do Moodle, incluindo módulos como o Badiu MReport, o Badiu SGA e o Badiu GC2.

1 - Cadastrar instância do Moodle no Badiu.Net

Neste tópico, explicaremos passo a passo como efetuar o cadastro da plataforma Moodle no sistema Badiu.Net. Esse cadastro é o primeiro procedimento necessário para realizar a integração entre as duas plataformas.

Para realizar o cadastro da instância do Moodle no sistema Badiu.Net, acesse a plataforma Badiu.Net utilizando uma conta de administrador ou um perfil que permita efetuar o cadastro de uma aplicação cliente. Ao entrar, navegue até a página principal de administração do sistema e selecione Plataforma Moodle seguido de Aplicação Cliente, como ilustrado na figura a seguir.

Outra alternativa é acessar diretamente pelo navegador o endereço: BADIUNET_URL/admin/server/appclient/index 

Ao acessar essa página, será exibida a tela de gerenciamento da aplicação cliente, conforme mostrado na figura abaixo.

Clique no botão Cadastrar Cliente para iniciar o cadastro. 

Em seguida, será exibido o formulário de cadastro, como ilustrado na figura seguinte.

Preencha os campos com os dados correspondentes à plataforma Moodle. A tabela a seguir especifica cada campo do formulário.

Ao efetuar o cadastro, será exibida a tela de gerenciamento com as instâncias da plataforma Moodle cadastradas, conforme ilustrado na figura a seguir.

Na versão atual da plataforma Badiu.Net, o token de acesso é exibido de forma oculta, por questões de segurança. Na versão I, todo token era exibido.

2 - Dados de Autenticação

Ao cadastrar a instância da plataforma Moodle, são criados automaticamente um token e uma chave de autenticação. O token é utilizado para autenticar a troca de dados, enquanto a chave de autenticação é usada para validar o cadastro do sistema Badiu.Net na plataforma Moodle.

Por questões de segurança, o token de acesso não é exibido completamente. A chave de autenticação deve ser cadastrada na plataforma Moodle e, a partir dela, o token de acesso também será registrado na plataforma Moodle. Este procedimento será detalhado no item 4.1.

3-  Adicionar Moodle ao Módulo de Autenticação

As instâncias da plataforma Moodle integradas ao sistema Badiu.Net que compartilham autenticação de usuários precisam ser registradas no módulo de autenticação da Badiu.Net.

O registro no módulo de autenticação permite que, quando o usuário efetuar logoff na plataforma Badiu.Net, a mesma operação seja estendida para as instâncias do Moodle nas quais estiver logado na mesma sessão do navegador. Caso outros sistemas também estejam integrados e precisem realizar logoff a partir do Badiu.Net, eles devem ser registrados nesse módulo.

O registro deve ser feito no painel de gestão de integração de login, cujo endereço de acesso é: BADIUNET_URL/auth/core/sync/index

Ao acessar esse endereço, será exibido o painel de gerenciamento, como ilustrado na figura a seguir.

Neste painel, devem ser cadastrados os endereços de logoff de todos os sistemas que integram o Badiu.Net. No caso da plataforma Moodle, o endereço de logoff é: MOODLE_URL/auth/badiuauth/logout.php

Esse endereço é uma das funcionalidades do plugin Badiu Auth, que é um dos conectores da plataforma Moodle com o Badiu.Net.