Link de compartilhamento

Um link de compartilhamento no Omniscol é uma URL assinada que dá acesso a um recurso sem conexão prévia:

• o horário de uma turma ou de um professor,
• uma tela de preenchimento direcionada, por exemplo de disponibilidades,
• o módulo Gestão de ausências em consulta,
• uma visão específica para uma equipe externa (auditoria, comunicação).

Para os horários públicos, o acesso é somente leitura. Alguns links de compartilhamento internos podem, no entanto, autorizar uma ação limitada, como o preenchimento de um formulário específico. O caso típico é o link de preenchimento das disponibilidades dos professores: a instituição pode enviá-lo a um professor com um prazo, sem criar para ele um login Omniscol.

Segurança

Cada link embarca um JWT assinado. Para os links web e API, a assinatura depende da conta que gerou o link e do hash da sua senha. Para os links iCal, o hash de verificação é construído sobre o mesmo princípio. Quatro consequências:

1. Data de expiração obrigatória — o link expira automaticamente na data escolhida. É uma proteção importante: nenhum link eterno.
2. Invalidação na alteração de senha — se a conta portadora altera a sua senha (ou a redefine para o mesmo valor, o que altera o sal aleatório), todos os links que ela gerou são invalidados imediatamente.
3. Invalidação pela conta portadora — se essa conta for desativada ou excluída, os links que ela portava deixam de funcionar.
4. Perímetro limitado — o link abre apenas a visão ou a ação prevista. Não o descreva como um acesso global à conta.

Para uma difusão coletiva, use uma conta de serviço claramente identificada em vez de uma conta pessoal. A conta de serviço torna-se a portadora administrativa dos links emitidos e pode ser rotacionada ou desativada se uma campanha de compartilhamento precisar ser invalidada.

Diferença em relação a um token de API

Criação de um link

O botão Compartilhamento aparece nas telas compartilháveis (horários, disponibilidades, ausências). Clique, escolha uma data de expiração e copie a URL no formato desejado.