Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Índice:
Índice | ||
---|---|---|
|
Objetivo
Neste documento será exibido o passo a passo para cadastrar no RM um novo aplicativo externo.
Um aplicativo externo deve ser cadastrado no RM para permitir a comunicação do sistema com aplicativos terceiros, que não são da TOTVS. Por exemplo, a partir da versão 12.1.22 do RM, será possível utilizar aplicativos externos, tais como o Google, Facebook ou APIs terceiras para realizar login na MDI.
Criando um novo Aplicativo
Para cadastrar um novo aplicativo no RM, basta acessar o menu Serviços Globais > Gestão > Aplicativos Externos. É importante que o aplicativo no provedor já tenha sido criado - ver mais sobre como criar aplicativo no Facebook, Google ou WSO2.
Ao incluir um novo aplicativo, deve-se informar os campos obrigatórios, que estão em negrito.
Quando o provedor do aplicativo for o Google, deve-se preencher os campos: Chave Pública, Chave Primária e Url de Retorno (Endereço Recomendado: https://www.google.com.br/). Caso o aplicativo seja o Facebook, é necessário preencher somente os campos de chave;
Se o provedor do aplicativo for WSO2 ou do tipo Custom, deve-se preencher todos os campos da tela;
Além das chaves, a URL de autorização, de recuperação do token de acesso e de recuperação de informações da conta de usuário devem ser obtidas diretamente no provedor de origem do aplicativo.
A Url de Retorno (passado no Url de callback) é utilizado somente para no login Winforms (MDI), no portal é utilizada a própria Url de login.
Apenas se o campo Ativo estiver marcado será possível utilizar este aplicativo externo para fazer login nos sistemas.
A imagem anexada no cadastro do aplicativo pode ser usada como ícone ou como botão na tela principal de login. A recomendação de tamanho das imagens é de:
- Ícone: 16 x 16 (Medida em pixels)
- Botão: 75 x 24 (Medida em pixels)
Após cadastrar o aplicativo, é possível customizar o botão que aparecerá na tela de login. Veja o tópico abaixo: Customização do Aplicativo Externo.
Observação: Não é permitido cadastrar mais de um aplicativo do provedor Facebook, Google ou WSO2.
Customização do Aplicativo Externo
É possível customizar algumas cores do botão do aplicativo externo, desde que possuam Provedor do tipo 'Custom' ou 'WSO2'. Para visualizar essas propriedades, basta acessar o menu Anexos > Customização do Aplicativo Externo.
Podem ser customizadas a cor de fundo, do texto e da borda. Caso exista alguma imagem cadastrada no aplicativo externo, ela será usada como ícone no botão.
Expandir | ||
---|---|---|
| ||
Configuração: Tela de Login: |
Para que essa imagem apareça como botão, basta marcar a opção Usar imagem cadastrada como background. Com essa configuração não é possível editar as cores ou texto do botão.
Expandir | ||
---|---|---|
| ||
Configuração: Tela de Login: |
Observação: Pode-se cadastrar apenas uma customização por aplicativo.
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|