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.(Colocar link do WSO2)
Ao incluir um novo aplicativo, deve-se informar os campos obrigatórios, que estão em negrito.negito.
Caso o aplicativo seja o Facebook, é necessário preencher somente os campos de chave;
Quando o provedor do aplicativo for o Google ou o Facebook, deve-se preencher os campos: Chave Pública e Chave Primária;, 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 ou do tipo 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 Added
Image 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.
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 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.
Visualização de correspondência entre usuários
É 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 | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|