4
1
Integração
Este documento trata da integração dos sistemas de autorização utilizados pelas
Unimeds com o Chat Intercâmbio. Através de uma biblioteca de funções de integração o
Chat prove serviços de gerenciamento tais como criação, abertura, bloqueio e desbloqueio
de salas, seleção do usuário responsável em uma sala, visualização de históricos, entre
outros. Esta integração é feita através de web services.
1.1
Integração utilizando web services
Para realizar a integração com o Chat Intercâmbio o Autorizador deverá utilizar uma
linguagem com suporte à web services, implementar o cadastro de tokens (mais
informações no item 0) e implementar de maneira correta as funções definidas nos schemas
e wsdl’s que serão utilizados.
1.1.1
Autenticação
Na API Web Service o Chat autentica a aplicação (sistema externo) que está
executando as funções, sendo que a autenticação dos usuários finais é responsabilidade de
cada sistema Autorizador.
Cada sistema externo deve possuir um token exclusivo que será utilizado nas suas
solicitações. Sem o token a execução do serviço será bloqueada pelo módulo de
autenticação. Para fazer a geração do token é necessário cadastrar a aplicação como um
usuário
da Unimed. O processo é semelhante à geração de tokens para usuários (mais
informações no item 0), porém o usuário da aplicação deve ser cadastrado apenas com o
perfil
Usuário_Aplicacao
quer será utilizado para identificar o usuário como um sistema
externo.
A autenticação e autorização na execução das funções web services é feita através do
protocolo Basic do HTTP/1.1. Este protocolo define a autenticação dos usuários a partir de
duas informações: nome do usuário (username) e senha. Ambas informações são
codificadas no formato Base64 e enviadas no cabeçalho da solicitação HTTP (mais
informações ver os documentos
RFC 2616
e
RFC 2617
).