Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Índice:
Índice | ||
---|---|---|
|
Objetivo
O objetivo deste documento mostrar como se cadastra Neste documento será exibido o passo a passo para cadastrar no RM um novo aplicativo externo no RM.
Um aplicativo externo deve ser criado cadastrado no RM para permitir a comunicação do RM 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 criar 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: Provedor do aplicativo, Chave Pública e Chave Primária:, que estão em negito.
Caso o aplicativo seja o Facebook, é necessário preencher somente os campos de chave;
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/) e URL de Descoberta (https://accounts.google.com/.well-known/openid-configuration) utilizada pelo Portal do Aluno.
Se o provedor do aplicativo for WSO2, deve-se preencher todos os campos da tela, inclusive a URL de Descoberta (https://<domínio do WSO2>/oauth2/oidcdiscovery/.well-known/openid-configuration) utilizada pelo Portal do Aluno.
Se o provedor do aplicativo for Custom, deve-se preencher todos os campos da tela, em exceção o "Escopo Padrão" que não é obrigatório, mas pode ser necessário dependendo o provedor escolhido.
O Escopo Padrão determina as informações que você obtêm do aplicativo utilizado (ex: LinkedIn) sobre o usuário durante o processo de autorização.
Image AddedImage Removed
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.
Ao marcar o campo Logar Automático (complementar após funcionalidade em teste) A Url de Retorno (Url de callback) é utilizado somente para no login Winforms (MDI), no portal Corpore.NET e Portal do Aluno é utilizada a própria Url de login. É possível utilizar o link do portal (http://Servidor:Porta/Corpore.Net/Login.aspx), o próprio site do cliente, um link disponibilizado pelo provedor do aplicativo ou um link disponibilizado no RM.Host (http://Servidor:PortaHttp/RMRestCallback/oauth/callback);
Apenas se o campo Ativo estiver marcado será possível utilizar este aplicativo externo no RM.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.
Image Removed
Image Added Podem ser customizadas as cores 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: Image Added Tela de Login: Image Added |
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: Image Added Tela de Login: Image Added |
Observação: Pode-se cadastrar apenas uma customização por aplicativo.
Visualização de correspondência entre usuários
(Colocar um exemplo do resultado)É possível visualizar pelo sistema quais são os usuários do RM que possuem vínculo criado com algum aplicativo externo. Basta acessar a tela Aplicativos Externos > Anexos > Correspondência entre usuários. Essa funcionalidade está disponível a partir da versão 12.1.22.
Image Added
Usuários que tem permissão a tela de Aplicativos externos conseguem excluir o(s) match(es) através deste anexo. Caso a exclusão seja feita, quando o usuário que teve seu match excluído logar novamente pelo aplicativo do provider, a associação será criada automaticamente, de forma transparente. Veja no documento Guia do Login OAuth as regras de Vínculo com o usuário da Linha RM.
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|