# Autenticação

> As regras para entrar na plataforma: senha forte, senha inicial dos alunos, reCAPTCHA no cadastro, login com Google e limite de dispositivos por aluno.

A tela de autenticação define as regras para entrar na plataforma. Por exemplo: toda senha precisa de 8 caracteres, e cada aluno fica conectado em até 3 dispositivos. Ela não muda o visual das telas de login.

## Como funciona

A tela fica em **Configurações > Segurança > Autenticação**. Ela vale para alunos e administradores. Tem quatro abas:

| Aba | O que define |
|---|---|
| **Senhas** | Se a conta exige senha forte, com quais critérios, e qual é a senha inicial de um aluno novo |
| **Proteção contra bots** | O reCAPTCHA do Google no cadastro gratuito da página de login |
| **Google** | Se o aluno pode entrar com a conta Google. Usa as credenciais do seu projeto no Google Cloud |
| **Dispositivos** | Em quantos dispositivos um aluno fica conectado ao mesmo tempo |

As quatro abas são um formulário só. Mude o que quiser em todas. Depois, clique uma vez em **Salvar agora**, na barra que aparece no rodapé.

Esta tela cuida das regras. O visual das telas de login, cadastro e recuperação de senha (logo, cor, imagem) fica em [Telas de acesso](https://help.cademi.cloud/pt/configuracoes/telas-de-acesso.md). Os canais de cadastro gratuito ficam em [Configurações de alunos](https://help.cademi.cloud/pt/configuracoes/cadastro-de-alunos.md).

## Senhas

### Senha forte

**Exigir senha forte** aplica os seus critérios a toda senha criada ou alterada na conta. Vale para alunos e administradores.

**A regra mais importante:** ligar a senha forte não tira ninguém da plataforma. As senhas em uso continuam funcionando. As sessões abertas continuam abertas. A regra vale na próxima vez que alguém define uma senha.

Com a exigência ligada, aparecem **Nível de proteção** e **Critérios da senha**:

| **Nível de proteção** | Tamanho mínimo | Exige |
|---|---|---|
| **Padrão** | 8 caracteres | 1 letra maiúscula, 1 minúscula e 1 número |
| **Reforçada** | 10 caracteres | 1 caractere especial, 1 maiúscula, 1 minúscula e 1 número |
| **Máxima** | 12 caracteres | 2 caracteres especiais, 1 maiúscula, 1 minúscula, 2 números e 4 letras no total |
| **Personalizada** | O que você definir | A tela marca sozinha quando você muda qualquer critério |

Os **Critérios da senha** são:

- **Tamanho mínimo**, de 6 a 128 caracteres;
- **Caracteres especiais**;
- **Letras maiúsculas**;
- **Letras minúsculas**;
- **Números**;
- **Letras no total**.

Cada critério tem uma quantidade mínima. Informe 0 para não exigir uma categoria.

A **Pré-visualização** ajuda você a ver a regra:

- Com a senha forte ligada, ela mostra um exemplo de senha que atende aos critérios. **Gerar outro exemplo** mostra outro. O exemplo serve só para você ver o tamanho e a mistura que está exigindo.
- Com a senha forte desligada e uma **Senha padrão** preenchida, ela mostra essa senha.

Com a senha forte desligada, uma senha nova ou alterada precisa de pelo menos 6 caracteres.

### Senha inicial dos alunos novos

Quando um aluno é criado, a plataforma define a primeira senha dele. Isso vale para compra, importação, cadastro gratuito e aluno criado pela equipe. A senha vai no e-mail de boas-vindas ([E-mails](https://help.cademi.cloud/pt/configuracoes/e-mails.md)).

Como a plataforma define a senha:

- **Com senha forte ligada**: uma senha aleatória que atende aos critérios. Cada aluno recebe uma diferente.
- **Com senha forte desligada**: você escolhe em **Usar um dado do aluno como senha inicial**. As opções são **Não usar dados do aluno**, **Usar e-mail como senha inicial** e **Usar CPF/documento como senha inicial**.

Com **Não usar dados do aluno**, aparece **Senha padrão**:

- Preenchida, ela é a mesma senha para todo aluno novo. Precisa de pelo menos 6 caracteres.
- Em branco, cada aluno recebe uma senha individual, gerada automaticamente.

Com **Usar CPF/documento como senha inicial**, um aluno sem documento recebe uma senha gerada automaticamente.

**Atenção:** e-mail e documento são fáceis de descobrir. Uma senha padrão é a mesma para toda a base. A forma mais segura é ligar a senha forte: cada aluno novo recebe uma senha aleatória que segue os seus critérios.

### Recuperação e troca de senha

Quem esqueceu a senha clica em **Esqueceu sua senha?**, na tela de login. A pessoa recebe um link por e-mail. O link vale por 3 horas. A senha atual continua valendo até a pessoa concluir o link.

A equipe também pode agir pelo perfil do aluno no painel ([O perfil do aluno](https://help.cademi.cloud/pt/alunos/perfil-do-aluno.md)):

- **Reenviar boas-vindas** redefine a senha e a envia por e-mail. A senha nova segue a mesma regra da senha inicial.
- **Alterar senha** define a senha que você digitar.

**Atenção: é aqui que mais acontece erro.** **Reenviar boas-vindas** troca a senha do aluno. A senha anterior deixa de funcionar. Com uma **Senha padrão**, ou com e-mail ou documento como senha, o aluno volta a essa senha. Senão, ele recebe uma senha nova e aleatória. Você pode reenviar uma vez por aluno a cada 10 minutos.

O aluno troca a própria senha em **Alterar senha**, no perfil dele na área do aluno. Todas essas senhas seguem as regras desta aba.

## Proteção contra bots

**Proteção contra bots** pede a verificação "Não sou um robô" do reCAPTCHA do Google. Ela protege o formulário de cadastro gratuito da página de login contra envios automáticos. Ela usa as chaves do seu próprio cadastro no reCAPTCHA.

1. Ligue **Proteção contra bots**.
2. No bloco **Credenciais do reCAPTCHA**, clique em **Criar chaves no Google reCAPTCHA**.
3. No Google, crie chaves do tipo reCAPTCHA v2, caixa de seleção "Não sou um robô", para o endereço da sua plataforma.
4. Cole a **Chave do site**.
5. Cole a **Chave secreta**.
6. Clique em **Salvar agora**.

Sem as duas chaves, a tela não salva com a proteção ligada.

A verificação não aparece:

- no login;
- no login com Google;
- no formulário de cadastro em site externo.

Se o Google não responder à verificação, o cadastro é recusado. A pessoa tenta de novo.

## Google

**Login com Google** mostra a opção **Entrar com Google** nas telas de login e de cadastro dos alunos. Vale só para alunos. Administradores entram com e-mail e senha. Um e-mail que pertence a um administrador não entra pelo Google.

Como funciona para o aluno:

- O Google precisa ter verificado o e-mail da conta. Senão, o login é recusado.
- Um aluno que já existe entra com o Google pelo e-mail dele. Isso funciona mesmo com o cadastro gratuito desligado.
- A conta Google fica ligada a esse aluno. Outra conta Google com o mesmo e-mail não entra no lugar dela.
- Se o aluno trocar o e-mail no Google, ele continua entrando pela conta já ligada.
- Alguém sem cadastro só é criado se duas condições valem: **Permitir cadastro na página de login** está ligado em **Configurações > Alunos**, e a conta ainda tem espaço no limite de alunos do plano.
- Esse aluno novo nasce com a marca de cadastro gratuito e recebe a entrega gratuita da conta. Ele não recebe senha por e-mail: ele entra com o Google.
- Os **Domínios autorizados** do cadastro gratuito limitam só a criação de alunos novos pelo Google. Um aluno que já existe entra com o Google mesmo com um e-mail de outro domínio.

### Ligar o login com Google

1. Ligue **Login com Google**.
2. No bloco **Credenciais do Google Cloud**, clique em **Abrir Google Cloud Console**.
3. No seu projeto, crie uma credencial do tipo ID do cliente OAuth para aplicativo da Web.
4. Copie a **URL de redirecionamento autorizada** que a tela mostra.
5. No Google Cloud Console, cadastre exatamente essa URL em "URIs de redirecionamento autorizados".
6. Cole o **Client ID** gerado pelo Google.
7. Cole o **Client Secret** gerado pelo Google.
8. Clique em **Salvar agora**.

Sem os dois campos, a tela não salva com o login ligado.

## Dispositivos

**Acessos simultâneos dos alunos** define em quantos dispositivos cada aluno fica conectado ao mesmo tempo. Em **Limite por aluno**, informe de 1 a 999. Em branco, vale o padrão de 3 dispositivos.

Um dispositivo é um navegador em que o aluno fez login. Se ele volta pelo mesmo navegador, é o mesmo dispositivo.

Pense no limite como um número de vagas. Cada dispositivo novo ocupa uma vaga. Quando as vagas acabam e o aluno entra num dispositivo a mais, a Cademí desconecta os dispositivos com o login mais antigo. Ela desconecta quantos precisar para caber no limite. O login que acabou de acontecer fica.

O dispositivo desconectado perde a sessão na hora, inclusive o "lembrar de mim". É assim que a plataforma desestimula o compartilhamento de conta: quem empresta a senha é desconectado quando o outro entra.

**Atenção: é aqui que mais acontece erro.** O Pedro entra no notebook, no celular e no tablet. O limite é 3. Depois, ele entra no computador do trabalho. Resultado: o notebook, onde ele entrou primeiro, é desconectado. O Pedro acha que foi desconectado do nada. Para evitar isso, aumente o **Limite por aluno** se o uso em vários aparelhos é legítimo.

- Diminuir o limite não desconecta ninguém na hora. A regra vale no próximo login de cada aluno.
- Administradores não têm limite de dispositivos.
- Sair da conta (logout) não libera a vaga. O dispositivo continua contando até ser desconectado por um login novo além do limite.
- O aluno não vê uma lista de dispositivos.
- Os eventos ficam nos **Logs** do perfil do aluno no painel: **Novo dispositivo registrado** e **Dispositivo removido por limite de dispositivos excedido**.

Aumente o limite quando uma família ou uma turma usa o mesmo cadastro de propósito. Diminua quando quer barrar a conta compartilhada.

## Bom saber

- **Mudar as regras de senha não troca a senha de ninguém.** Quem já tem senha continua entrando. A regra só vale para a próxima senha criada ou alterada.
- **Reenviar boas-vindas redefine a senha.** Se o aluno só esqueceu a senha, mande-o usar **Esqueceu sua senha?**. A senha atual continua valendo até ele concluir o link.
- **Documento como login.** A Cademí pode configurar uma conta para entrar com o documento em vez do e-mail. Isso vale para alunos e administradores. Nesse caso, o campo de login é o documento. O e-mail continua sendo o endereço de contato.
- **Mesmo e-mail para administrador e aluno.** O formulário de login é um só, e a plataforma tenta primeiro a senha de administrador. O **Esqueceu sua senha?** desse e-mail redefine a senha do administrador. O login com Google fica bloqueado para esse e-mail. Dê e-mails diferentes aos dois.
- **A verificação em dois fatores é dos administradores.** Cada um a liga no próprio perfil ([Administradores](https://help.cademi.cloud/pt/configuracoes/administradores.md)). Alunos não têm segunda etapa.

## Perguntas frequentes

**Quero obrigar senhas fortes. Alguém vai perder o acesso?** Não. As senhas em uso continuam funcionando. Os critérios valem quando alguém cria ou troca a senha.

**Por que o aluno foi desconectado do nada?** Ele provavelmente entrou em outro dispositivo e passou do limite. Outra pessoa também pode ter entrado com a senha dele. Confira os **Logs** no perfil dele. Se o uso em vários aparelhos é legítimo, aumente o **Limite por aluno**. Veja também [Por que o aluno não acessa](https://help.cademi.cloud/pt/alunos/por-que-o-aluno-nao-acessa.md).

**Liguei o login com Google. Por que o botão não aparece?** Confira se **Client ID** e **Client Secret** foram preenchidos e salvos. Se o Google mostra erro ao entrar, confira a **URL de redirecionamento autorizada**. Ela precisa estar cadastrada exatamente igual no Google Cloud Console.

**O reCAPTCHA vale no login?** Não. A proteção vale para o formulário de cadastro gratuito da página de login. O login com e-mail e senha não pede a verificação.