Visão geral das integrações
O Omniscol se integra ao seu sistema de informação por várias vias, conforme a necessidade.
Visão sintética
| Mecanismo | Para que serve | Sentido do fluxo |
|---|---|---|
| iCal | Permitir que professores / alunos vejam seu horário na agenda pessoal | Omniscol → agenda |
| Links de compartilhamento | Divulgar um horário somente leitura ou abrir uma entrada de dados específica conforme o contexto | Omniscol → web público |
| Iframe | Incorporar um horário em uma página no mesmo domínio que o Omniscol; bloqueado em um site externo (segurança) | Omniscol → mesmo domínio |
| API Omniscol | Integrações sistema a sistema conforme os direitos e as opções da conta | Conforme a configuração |
| MCP | Conectar um agente de IA compatível com MCP ao Omniscol | Agente de IA ↔ Omniscol |
| OAuth2 / OIDC (servidor) | Conectar um serviço de terceiros identificado por cliente registrado + consentimento + token com escopo (base do MCP e do OneRoster) | Serviço ↔ Omniscol |
| OIDC / SSO (login) | Autenticação dos usuários via provedor de identidade (Google Workspace, Microsoft Entra ID, OIDC genérico) | Conforme a configuração |
| Sincronização com sistemas externos | Framework de conectores: Aurion, Auriga, Edusign, novos conectores por projeto | Bidirecional |
| Painéis de exibição | Exibir o horário em telas públicas | Omniscol → telas |
Escolher a integração adequada
- Divulgar um horário a um professor / aluno — assinatura iCal.
- Conceder acesso de leitura a um responsável / uma auditoria — link de compartilhamento.
- Sincronizar os alunos a partir do seu ERP / SI — veja Sincronização com sistemas externos que lista os conectores disponíveis. Se seu ERP não constar da lista, a adição de um conector é definida com o suporte Omniscol.
- Autenticação única — OIDC / SSO.
- Assistente de IA externo na conta, se a opção estiver ativada — MCP para os clientes compatíveis.
- Exibição pública nas instalações — painéis de exibição.
Boas práticas de segurança
- Utilizar OIDC / SSO, quando a opção estiver ativada, para autenticar usuários reais.
- Reservar as chaves de API para integrações sistema a sistema, com escopo mínimo e rotação periódica.
- Definir datas de expiração curtas nos links de compartilhamento.
- Não colocar uma chave de API em um repositório Git público.