Links de compartilhamento públicos

Um link de compartilhamento público é uma URL assinada que dá acesso a uma tela de consulta — na maioria das vezes um horário — em modo somente leitura sem login. É o canal mais simples para divulgar um calendário a alguém que não tem (e não terá) conta Omniscol: um responsável, um parceiro externo, um setor administrativo.

Formatos disponíveis

Conforme o contexto e os direitos do usuário que compartilha, o Omniscol pode gerar várias URLs assinadas:

• Página web responsiva — exibição navegável no estilo portal, com vistas semana / dia / lista. É o que vê quem abre o link em um navegador.
• Fluxo iCal (.ics) — assinatura dinâmica para Google Calendar, Apple Calendar, Outlook. Consulte iCal — assinatura e link dinâmico.
• JSON (API) — para os desenvolvedores e as integrações máquina a máquina, quando esse formato é permitido.

Esses formatos não são uma promessa universal: a janela modal exibe as abas realmente geradas para a seleção atual.

O que é possível compartilhar?

O compartilhamento não se limita à tela de consulta dos horários: o mesmo ícone de compartilhamento Compartilhamento aparece na maioria das telas do Omniscol.

Em modo somente leitura, você pode compartilhar:

• o horário de uma entidade — aluno, turma, professor, sala ou disciplina: o caso mais comum (pais, colegas, professores externos, setores técnicos);
• a tela de horário completa do módulo Horário;
• os seis painéis de controle (professores, salas, recursos, disciplinas, turmas, alunos);
• as telas de acompanhamento das ausências (professores, turmas, alunos, pessoal);
• as escalas de serviço do módulo Gestão de pessoal (grade, atribuições, planejamento, folha de presença);
• as telas de visualização, de reorganização e de diagramação de um horário;
• a tela de detalhes de um professor ou de um membro do pessoal.

Em modo leitura e escrita — os dois únicos casos — você compartilha o registro das disponibilidades de um professor ou de um membro do pessoal: o link dedicado permite à pessoa em questão informar e validar suas disponibilidades, e editar seu perfil, até a data de validade, sem conta nem senha Omniscol. O link é vinculado à sua identidade e só é oferecido na sua própria ficha. As disponibilidades de turma, de sala, de grupo ou de disciplina permanecem telas de edição internas: elas não são coletadas por link de compartilhamento.

Cada URL assinada carrega o perímetro solicitado e uma data de validade.

Criar um link de compartilhamento

No módulo Horário, selecione o horário a compartilhar (aluno, turma, sala…) e clique no ícone de compartilhamento Compartilhamento. A janela Compartilhamento que se abre oferece:

• Data de validade — data até a qual as URLs geradas permanecem válidas.
• Abas Web, iCal e JSON — visíveis conforme os formatos gerados para o compartilhamento.

Em seguida você copia a URL desejada. A janela modal pode exibir um QR code para os links destinados a uma consulta humana.

Limitar ou invalidar um link

O compartilhamento público não mantém um registro dos links emitidos: o Omniscol não fornece nem lista consolidada dos links já transmitidos, nem contador de acessos, nem revogação link por link. A invalidação passa portanto pela conta titular (senha, desativação) e pela data de validade.

Para limitar o risco:

• escolha uma data de validade curta;
• compartilhe apenas o perímetro necessário;
• utilize, para as divulgações de equipe, uma conta de serviço identificada em vez de uma conta pessoal;
• em caso de divulgação indesejada, altere ou redefina a senha da conta titular, ou desative essa conta se necessário.

A alteração da senha invalida os links vinculados a essa conta, mesmo que a nova senha seja idêntica em texto claro, porque o hash armazenado muda. A desativação ou exclusão da conta titular também corta o acesso.

Segurança

• A URL contém um token assinado e difícil de adivinhar.
• O link expõe apenas as telas inscritas no seu token, não o restante da conta. Para um horário de entidade (e para qualquer fluxo iCal), o filtro fica fixado no token: o destinatário permanece restrito a essa entidade — um responsável que dispõe do link do horário do filho não pode alcançar o horário de outro aluno. Um compartilhamento de tela de horário completa, por sua vez, reflete os direitos da conta que o gerou: para uma divulgação externa específica, compartilhe o horário da entidade precisa em vez da tela inteira.
• A validade é limitada pela data de validade.
• A validade depende também da conta titular: alteração de senha, desativação ou exclusão invalidam os links associados.
• Qualquer pessoa que possua a URL pode consultar o perímetro compartilhado até a expiração ou invalidação.

Incorporar um horário em uma página (iframe)

Hoje, isso não é possível em outro site. Para se proteger contra o sequestro de clique, o Omniscol impede ser exibido em um quadro (iframe) hospedado em um domínio diferente do seu. Se você tentar incorporar um horário no seu ambiente virtual de aprendizagem, na sua intranet ou no seu site público, o navegador recusa exibir o quadro. Esse bloqueio de segurança é imposto pelo Omniscol e não pode ser alterado a partir da conta da instituição.

A única exceção, rara na prática, é uma página servida em exatamente o mesmo domínio que a sua instância Omniscol.

Para divulgar mesmo assim um horário em um site externo, três soluções simples:

• um link para a URL de compartilhamento: o leitor abre o horário em uma nova aba, sem quadro incorporado;
• uma assinatura iCal, para que o horário apareça na agenda da pessoa (Google Agenda, Outlook…) — consulte iCal — assinatura e link dinâmico;
• um painel de display, para uma tela pública nas dependências — consulte Painel de display.