Guia de Autorização

A autenticação e autorização refere-se ao processo de concessão de permissões de acesso de um usuário ou aplicativo aos dados e recursos do SoftExpert Suite.

Onde:

• Usuário Final (End User) corresponde ao usuário do SoftExpert Suite. O Usuário Final solicita acesso aos recursos protegidos (por exemplo, workflows, documentos, etc.)
• Meu Aplicativo (My App) é o cliente que solicita acesso aos recursos protegidos (por exemplo, um aplicativo móvel, web ou uma integração).
• Servidor do SoftExpert que hospeda os recursos protegidos e fornece autenticação e autorização via API Key ou Basic HTTP.

Uso do API Key

Para integrar com segurança o SoftExpert Suite ao seu aplicativo, uma das formas recomendadas atualmente é o uso do API Key, o API Key utiliza a especificação JSON Web Tokens (Token JWT). Para isso, todas as solicitações feitas às APIs e Web Services devem utilizar HTTPS e incluir o API Key do usuário, a fim de autenticar e autorizar o acesso.

O API Key do usuário pode ser encontrado na tela de "Conta do usuário". Cada usuário pode ter apenas um API Key, que permite o acesso aos menus configurados no grupo de acesso associado a ele.

cuidado

A partir da versão 2.1, é obrigatório que o uso do protocolo HTTPS seja adotado para aumentar significativamente a segurança no uso da solução. É altamente recomendável que a organização obtenha um certificado digital válido emitido por uma autoridade certificadora confiável. Caso contrário, os usuários do SoftExpert Suite poderão receber alertas de segurança durante o uso da solução. É importante salientar que o envio de credenciais de acesso via HTTP é considerado uma grave falha de segurança e deve ser evitado sob todas as circunstâncias.

API Gateway

O API Gateway é um componente importante da arquitetura de sistemas baseados em APIs. No caso do SoftExpert Suite, ele é responsável pela camada de controle de acesso aos recursos disponibilizados por meio de APIs e Web Services.

Para enviar suas requisições para o API Gateway, é necessário utilizar a URL https://my-domain.softexpert.com/apigateway/, sendo que o <my-domain> deve ser equivalente ao utilizado no acesso de usuários ao SoftExpert Suite.

Com o uso do API Gateway, é possível implementar políticas de controle de acesso, como autenticação e autorização, além de monitorar o tráfego de requisições e respostas entre os clientes e os recursos. Isso aumenta a segurança e o controle sobre o uso das APIs e Web Services do SoftExpert Suite.

Usuário para Integrações

É recomendável a criação de um usuário exclusivo no SoftExpert Suite para realizar integrações. Este usuário deve possuir apenas um grupo de acesso vinculado e associado a uma única licença MANAGER. Este usuário também não deve ser sincronizado com o AD (Active Directory) e não deve ser utilizado para acessar o sistema no dia-a-dia, pois este usuário deve ser de uso exclusivo para as integrações. Desta forma, facilita tanto a gestão das permissões de acesso desse usuário às integrações disponibilizadas, quanto à manutenção do histórico de integrações realizadas, o qual pode ser extraído observando os registros inseridos por este usuário.

Próximos passos

• Antes de continuar, certifique-se de ter criado um API Token em sua Conta de Usuário no SoftExpert Suite.
• Por fim, aprenda como usar o token de acesso solicitado lendo o Guia de como usar o token de acesso.