English
Español
Autenticação via Headers em Web Services
Disponível após configuração do ambiente para fluxo de autenticação reestruturado.
Importante
Esta configuração só é aplicável aos produtos Gestão de Pessoas | HCM e Gestão de Riscos e Segurança. Para outros produtos, ela não terá efeito.
A partir desta configuração, as chaves <user>,<password> e <encryption>não deverão ser enviadas pelo Body do SOAP. As chamadas passam a suportar autenticação via header Authorization conforme descrito abaixo. O corpo da requisição fica dedicado aos dados da operação.
- Basic:
Authorization: Basic <Base64(usuario:senha)> - Bearer:
Authorization: Bearer <Token da Plataforma Senior> - Encryption:
Authorization: Encryption <autenticação via logon integrado com criptografia, conforme descrito na documentação de logon integrado com criptografia> - Trusted: Método de autenticação baseado em token, utilizado internamente para chamadas de métodos agendados.
Observação
Com o fluxo de autenticação reestruturado ativado, as chamadas WSDL passam a ser retornadas sem os campos <user>, <password> e <encryption> no corpo da requisição.
Comparativo
- Modelo antigo (descontinuado)<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.exemplo.com.br">
<soapenv:Header/><soapenv:Body>
<ser:ConsultarColaborador>
<user>usuario</user>
<password>senha</password>
<encryption>0</encryption>
<parameters>
<!-- parâmetros -->
</parameters>
</ser:ConsultarColaborador>
</soapenv:Body>
</soapenv:Envelope>
- Novo modelo
POST /Servico HTTP/1.1
Authorization: Basic <base64(usuario:senha)> ou Authorization: Bearer <accessToken>
Content-Type: text/xml; charset=utf-8
SOAPAction: "ConsultarColaborador"
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.exemplo.com.br">
<soapenv:Header/>
<soapenv:Body>
<ser:ConsultarColaborador>
<parameters>
<!-- parâmetros -->
</parameters>
</ser:ConsultarColaborador>
</soapenv:Body>
</soapenv:Envelope>
Como obter o token – Bearer token
Para integrar via token:
- Cadastrar a aplicação
Cadastre conforme a documentação oficial da Platform Authentication. Esse processo gera
clientId eclientSecret . - Obter o token
Utilize a API
/anonymous/loginWithKey conforme manual > /anonymous/loginWithKeyO retorno inclui
accessToken , que deve ser enviado no headerAuthorization: Bearer < accessToken > .
Erros comuns e correções
| Erro | Causa | Solução |
|---|---|---|
| 400 – Autenticação inválida | Credenciais ainda enviadas no Body | Remova |
| 401 – Unauthorized | Header ausente ou malformado | Revise Authorization: Basic ou Authorization: Bearer . |
| 403 – Forbidden | Token expirado/sem escopo | Renove via |
| SOAP Fault / 415 | SOAPAction/MIME incorretos | Use o SOAPAction exato do WSDL e Content-Type: text/xml; charset=utf-8. |
Links úteis:
Platform Authentication (Cadastrar aplicação);
Conceder acesso para terceiros.
Autenticação via regra LSP
Quando o fluxo de autenticação reestruturado estiver habilitado, a autenticação de web services em regras será realizada, por padrão, por meio do parâmetro
Para chamadas externas, é necessário preencher o parâmetro
English
Español
