# Setup de grupos Moodle

Sendo admin do Moodle:

* Criar um novo serviço externo (`Administração do site` → `Servidor` → `Web services` → `Serviços externos` → `Adicionar`) conforme abaixo:
  1. Nome: `confweb-lti-external-service`
  2. Nome breve: `ConferênciaWeb`

<figure><img src="https://4071737184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7hXYp2PZ9COGqQOKpE%2Fuploads%2F7dT2g8rnSuzaGr1sW4od%2FUntitled.png?alt=media&#x26;token=a499e431-e186-4f59-9a49-ecac9d50440a" alt=""><figcaption></figcaption></figure>

No Moodle 3.8 o caminho é Administração do site → Plugins → Web services → Serviços externos → Adicionar

* Na tela seguinte, clique em Adicionar funções

<figure><img src="https://4071737184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7hXYp2PZ9COGqQOKpE%2Fuploads%2FYnUKnba3boSnGiGl8HfW%2FUntitled%20(1).png?alt=media&#x26;token=86888f69-3e91-4e37-8562-9778c8aed09b" alt=""><figcaption></figcaption></figure>

3. Selecione as seguintes funções
   * `core_group_get_activity_groupmode`
   * `core_group_get_course_user_groups`
   * `core_course_get_course_module_by_instance`
   * `core_group_get_course_groups`
   * `core_webservice_get_site_info`
   * `core_calendar_create_calendar_events`
   * `core_calendar_delete_calendar_events`
   * `core_calendar_update_event_start_day`

<figure><img src="https://4071737184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7hXYp2PZ9COGqQOKpE%2Fuploads%2F4BetSLQV52d8pRzsKqD6%2FUntitled%20(4).png?alt=media&#x26;token=b30f5478-c39e-4f0a-87cf-c43e69998056" alt=""><figcaption></figcaption></figure>

Clique em Adicionar funções

<figure><img src="https://4071737184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7hXYp2PZ9COGqQOKpE%2Fuploads%2F4knSs49mNE6LRp13phoN%2FUntitled%20(5).png?alt=media&#x26;token=7546d709-2381-4441-ac6e-7caaf5e17db5" alt=""><figcaption></figcaption></figure>

Criar um novo token (Administração do site → Servidor → Web services → Gerenciar tokens) conforme abaixo:

<figure><img src="https://4071737184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7hXYp2PZ9COGqQOKpE%2Fuploads%2FCmERBC55qYsOCnArhBin%2FUntitled%20(6).png?alt=media&#x26;token=5516544b-2ae3-4481-8b14-abd030c5d5d8" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
É importante notar que:

* O nome do usuário é o nome de quem está criando o token;

* O serviço precisa ser o recém-criado (confweb-lti-external-service);

* O checkbox do Válido até está DESMARCADO. Caso queira posteriormente invalidar o token, o mesmo pode ser excluído na página Gerenciar tokens.
  {% endhint %}

* Ao clicar em Salvar mudanças, a seguinte página mostrará o token uma única vez, então anote em algum lugar seguro.

<figure><img src="https://4071737184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7hXYp2PZ9COGqQOKpE%2Fuploads%2Fa6LDetaV4wUTmmSGqLi3%2FUntitled%20(7).png?alt=media&#x26;token=9e90861e-c265-4f2b-b1db-a6191194548f" alt=""><figcaption></figcaption></figure>

* Caso exista um papel específico atribuído a web services, garanta que as seguintes permissões foram atribuídas:

* `mod/lti:view`

* `moodle/course:view`

* `webservice/rest:use`

* Na página de configuração do curso (Página inicial do curso → Configurações), na aba de Grupos é necessário que o campo Modalidade grupo seja Grupos separados ou Grupos visíveis e o campo Forçar modalidade grupo, seja Sim, conforme abaixo:

<figure><img src="https://4071737184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7hXYp2PZ9COGqQOKpE%2Fuploads%2FjA041wjCukDV83cFW0fZ%2FUntitled%20(8).png?alt=media&#x26;token=69feb825-9660-4cb0-9254-d82122d175c9" alt=""><figcaption></figcaption></figure>

* Enviar para o Service Desk da RNP (<atendimento@rnp.br>):
  * Identificar-se como instituição que utiliza o ConferênciaWeb via Moodle
  * Informar a chave LTI configurada (ex: Moodle-ESR-LTI-1). Caso o Moodle ainda não tenha credencial LTI configurada, informar que ainda não faz uso do ConferênciaWeb e que precisa de uma credencial LTI
  * Informar o token criado através do passo a passo acima (ex: 4d107ac7a4612d3f142da4884f2a17fa)
  * Informar a URL de webservices da instância do Moodle onde o token foi criado (ex: <https://moodle.h.elos.dev/webservice/rest/server.php>)

{% hint style="info" %}
Dica 1: ao acessar a URL, uma mensagem de “token inválido” será apresentada, o que significa que é a URL correta.
{% endhint %}

{% hint style="info" %}
Dica 2: a URL pode ou não ter o path /moodle antes do /webservice, vai depender das configurações do Moodle.
{% endhint %}