Wikihelp
Seção
< All Topics

Portal SSO – Configurações Aplicativos

Atualização

Configurações – Aplicativos

Objetivo

A aba Aplicativos permite gerenciar os aplicativos integrados ao Portal SSO.

Nessa tela é possível:

– visualizar aplicativos cadastrados;

– ordenar aplicativos;

– verificar licença;

– abrir detalhes de configuração;

– alterar status, nome, descrição e perfis;

– configurar campos técnicos de cada integração.

Colunas da lista

Ordem

Define a posição do aplicativo na home.

É possível usar os botões de seta para cima e para baixo para trocar a ordem com o aplicativo anterior ou posterior.

Impacto:

– altera a ordenação visual dos cards na home;

– a alteração é gravada no JSON do aplicativo.

Aplicativo

Exibe nome, descrição e ícone do aplicativo.

Tipo

Indica o tipo de execução do aplicativo.

Tipos comuns:

– REDIRECT: abre uma URL retornada pelo backend;

– FORM_POST: envia um formulário automaticamente para a URL retornada pelo backend;

– MULTI_REDIRECT: usado quando o backend pode montar redirecionamentos conforme parâmetros adicionais.

Status

Indica se o aplicativo está ativo ou inativo.

Licença

Mostra se o aplicativo possui licença válida.

Impacto:

– sem licença, o aplicativo não aparece na home;

– o botão de detalhes fica desabilitado visualmente quando não há licença;

– a licença é validada pelo backend.

Configuração

Permite abrir o modal de edição do aplicativo.

Modal de edição do aplicativo

Ao clicar em detalhes, é aberto o modal de configuração do aplicativo.

O modal exibe:

– ícone/logo do aplicativo;

– campos gerais;

– campos técnicos da integração;

– em alguns casos, abas específicas, como aliases do Workalove.

Ícone/logo do aplicativo

Permite enviar uma imagem personalizada para o card do aplicativo.

Impacto:

– a imagem é salva em Base64 no JSON do aplicativo;

– se não houver imagem personalizada, o portal usa o ícone padrão da pasta de assets;

– imagens muito grandes aumentam o tamanho do JSON.

Campos comuns dos aplicativos

Ativo

Define se o aplicativo pode aparecer na home.

Impacto:

– ativo: o aplicativo pode aparecer, desde que perfil e licença também permitam;

– inativo: o aplicativo não aparece na home.

Ordem

Define a posição do card na home.

Nome do aplicativo

Texto exibido como título do card.

Impacto:

– altera o nome visível para o usuário final;

– não altera o código técnico do aplicativo.

Descrição do aplicativo

Texto exibido no card.

Impacto:

– ajuda o usuário a entender a finalidade do aplicativo;

– textos muito longos podem ser abreviados visualmente.

Perfis autorizados

Lista de perfis que podem visualizar o aplicativo.

Exemplo:

ALUNO,PROFESSOR,ADMIN

Impacto:

– o portal compara essa lista com os perfis retornados pelo RM para o usuário logado;

– se o usuário não possuir nenhum perfil listado, o aplicativo não aparece;

– se o campo estiver incorreto, usuários podem perder acesso ao aplicativo.

Aplicativos disponíveis

Portal do Aluno

Código:

EDUALUNOPORTAL

Tipo:

FORM_POST

Principais campos:

– Endereço do Servidor de Portal;

– Alias do RM;

– Atalho.

Impacto:

– o backend monta a autenticação para o Portal do Aluno;

– o front não expõe usuário e senha em URL;

– se o atalho for preenchido, o backend pode direcionar o usuário para uma área específica.

Portal do Professor

Código:

EDUPROFESSORPORTAL

Tipo:

REDIRECT

Principais campos:

– Endereço do Servidor de Portal;

– Alias do RM.

Impacto:

– o backend gera o token necessário e retorna a URL de acesso ao Portal do Professor;

– o front apenas abre a URL retornada.

Portal de Gestão

Código:

EDUGESTAOPORTAL

Tipo:

REDIRECT

Principais campos:

– Endereço do Servidor de Portal;

– Alias do RM.

Impacto:

– usado para acessar o Portal de Gestão Educacional;

– depende da configuração correta de servidor e alias.

LMS Moodle

Código:

LMSMOODLE

Tipo:

REDIRECT

Principais campos:

– URL Moodle;

– Token API Moodle;

– Redirect;

– É WorkNow?;

– Sufixo para usuário sem ID Moodle.

Impacto:

– o backend utiliza essas informações para gerar o redirecionamento ao Moodle;

– o token precisa ser válido no Moodle.

Blackboard

Código:

LMSBLACKBOARD

Tipo:

FORM_POST

Principais campos:

– IDP Entity ID;

– IDP SSO URL;

– SP Entity ID;

– ACS URL;

– Relay State;

– Certificado;

– Chave privada.

Impacto:

– usado para autenticação SAML;

– certificado e chave privada devem estar corretos;

– o front apenas envia o formulário retornado pelo backend.

Workalove

Código:

WORKALOVE

Tipo:

MULTI_REDIRECT

Principais campos:

– URL Workalove;

– aliases configurados em aba própria.

Aliases do Workalove

O Workalove possui configuração auxiliar de aliases por contexto.

Cada alias pode conter:

– ativo;

– coligada;

– filial;

– nível de ensino;

– alias;

– nome de exibição;

– usuário da API;

– token da API.

Regras:

– os campos são obrigatórios;

– coligada, filial e nível de ensino aceitam -1 ou valores positivos;

– 0, vazio ou menor que -1 não são válidos.

Impacto:

– o backend escolhe a credencial correta comparando o contexto da chamada;

– o usuário/token do Workalove não ficam no JSON visual público do app.

Pergamum

Código:

BIBPERGAMUM

Tipo:

REDIRECT

Principais campos:

– URL Pergamum;

– Código da Empresa.

Impacto:

– usado para redirecionamento autenticado à biblioteca Pergamum.

Minha Biblioteca

Código:

BIBMINHABIBLIOTECA

Tipo:

REDIRECT

Principais campos:

– URL Minha Biblioteca;

– Senha da Instituição.

Impacto:

– usado para geração do acesso à plataforma Minha Biblioteca.

Pearson

Código:

BIBPEARSON

Tipo:

FORM_POST

Principais campos:

– URL Pearson;

– Senha da Instituição.

Impacto:

– o backend retorna um formulário com dados necessários;

– o front submete o formulário automaticamente em nova aba.

PHL

Código:

BIBPHL

Tipo:

REDIRECT

Principais campos:

– URL do Portal PHL;

– Key do Cliente;

– ID do Cliente.

Impacto:

– usado para montar o redirecionamento legado do PHL.

Office 365

Código:

OFFICE365

Tipo:

REDIRECT

Principais campos:

– URL Office 365.

Impacto:

– cria atalho para ambiente Microsoft 365 institucional.

AvaliA

Código:

AVALIA

Tipo:

FORM_POST

Principais campos:

– URL Avalia;

– Código da instituição;

– Senha da instituição;

– Campo de usuário;

– Prefixo do usuário;

– Sufixo do usuário.

Impacto:

– define como o usuário será identificado na integração;

– prefixo e sufixo ajudam a adaptar o login enviado ao AvaliA.

Link Institucional

Código:

CUSTOMREDIRECT

Tipo:

REDIRECT

Principais campos:

– URL Custom Redirect.

Impacto:

– usado para criar atalhos simples para serviços externos;

– o backend retorna a URL final para abertura.

Botão Salvar no modal

Grava o JSON do aplicativo no banco.

Após salvar:

– a home passa a usar os novos dados;

– o card pode mudar nome, descrição, ícone ou ordem;

– alterações em perfis podem liberar ou ocultar o aplicativo para determinados usuários.

Boas práticas

– Configure primeiro o status, nome, descrição, ordem e perfis.

– Depois preencha os campos técnicos da integração.

– Valide se a licença está ativa.

– Teste o acesso com um usuário do perfil autorizado.

– Evite textos muito longos nos cards.

– Use imagens leves para ícones.

– Não altere o código do aplicativo; altere apenas nome e descrição exibidos.