Este guia diz respeito ao módulo Drupal "Infomaniak_Connect", que permite aos utilizadores autenticarem-se no seu site Drupal (seja ele alojado pela Infomaniak ou não) utilizando as suas credenciais Infomaniak.

Introdução

• Permitir que os utilizadores iniciem sessão através de uma conta Infomaniak no seu site Drupal permite que os seus visitantes comentem, inscrevam-se em cursos ou acedam a qualquer conteúdo reservado aos membros com um único clique, sem terem de criar uma nova conta.
• Isto poupa tempo aos utilizadores e é um método mais seguro para si, pois não tem de gerir palavras-passe adicionais.
• O funcionamento deste módulo externo é idêntico às opções “Autenticar com o Google”, “Autenticar com o Facebook” ou “Autenticar com a Apple”; ele utiliza os protocolos padrão OAuth2 e OpenID Connect para permitir uma autenticação única (SSO).

A. Criar uma aplicação com o Auth Infomaniak

Para isso:

1. Clique aqui para acessar a gestão do seu produto Auth no Manager Infomaniak (precisa de ajuda?).
2. Clique no botão para Criar uma nova aplicação:
   
3. Escolha o tipo “Interface Web”.
4. Atribua um nome à sua aplicação.
5. No campo URL, indique o nome de domínio correspondente ao seu site Drupalao qual você adiciona /openid-connect-authorize (consulte a documentação do GitHub, se necessário).
6. Clique no botão para concluir a criação do aplicativo:
   
7. Anote cuidadosamente as 2 informações obtidas ao finalizar seu aplicativo OAuth2:
   

B. Configurar a extensão Drupal

Via SSH, instale, se necessário, o Composer para poder importar as extensões openid_connect e infomaniak_connect. Para isso:

• Se necessário, edite o arquivo composer.json, pois a versão de openid_connect ainda não é considerada estável. Adicione:

• "minimum-stability": "dev",
  "prefer-stable": true

• Os comandos SSH para a instalação das 2 extensões estão aqui:
  • https://www.drupal.org/project/openid_connect
  • https://www.drupal.org/project/infomaniak_connect

Em seguida, no Drupal:

1. Procure o módulo Infomaniak entre os módulos pré-instalados.
2. Selecione-o.
3. Clique no botão Instalar:
   
4. A instalação das dependências será iniciada:
   
5. Em Configuração, clique para configurar a conexão OpenID:
   
6. Clique no botão de edição:
   
7. Os únicos campos a preencher são ID do cliente e Segredo do cliente, e devem ser obtidos a partir das informações do ponto A acima:
    
8. Não se esqueça de guardar as alterações efetuadas nas configurações da extensão.
9. Na aba Configurações, você pode escolher o tipo de exibição para sua página de login; não se esqueça de salvar:
   
10. Um botão adicional, para login com suas credenciais Infomaniak, agora está visível na sua página de login para usuários: