Os dados de autenticação de cliente para
certificados SSL X509 podem propagar para o ambiente local e
podem ser usados para autorização.
Ao implementar um fluxo de mensagens para usar autenticação SSL, é
possível verificar certificados de cliente autenticados para autorização. Quando
um perfil de segurança é configurado para autorização e configurado no
nó de entrada, os dados são passados para um gerenciador de segurança. Um gerenciador de segurança
do broker recebe partes relevantes do certificado para autorização
e o envia para o analisador de propriedades. Durante a autenticação, os dados
da identidade ou do token de segurança que são fornecidos substituem os
valores nos campos de identidade da árvore de propriedades. Esses dados, por exemplo
podem ser de um cabeçalho de transporte Basic-Auth ou um token de WS-Security.
Os dados do parâmetro no certificado substituem os campos na árvore de
propriedades. Esses campos são reconfigurados com novos dados:
- O IdentitySourceType é configurado para nome de usuário,
- O IdentitySourceToken é configurado para o nome do
assunto do certificado de cliente,
- O IdentitySourceIssuedBy é configurado para o
nome do emissor do certificado de cliente.
Quando você usa os nós SOAPInput, HTTPInput, SCAInput ou TCPIPServerInput,
os campos da árvore de propriedades contêm as informações do certificado de
cliente. Embora a propagação não seja ativada automaticamente, quando
ela é ativada, um certificado é processado em todo o fluxo de mensagens
e propagado para os nós da saída ou da solicitação. Preenchendo o ambiente
local, os dados do certificado são disponibilizados para o restante
do fluxo.
Um nível mais alto de autenticação (tal como, basic-Auth ou WS-Security)
pode sobrescrever a árvore de propriedades. Em razão de dados da árvore de propriedades
ausentes, você não consegue autorizar o cliente no nó de Entrada. Entretanto,
é possível usar um nó SecurityPEP para localizar os campos de autenticação
(ou outro certificado) no ambiente local para executar a autorização.
É possível localizar certificados de cliente por meio da variável local LocalEnvironment.input_node_name.Input.TransportSecurity.ClientAuth.Certificate, em que input_node_name é SOAP, HTTP, SCA ou TCPIP.
Nós diferentes acessam o certificado de cliente de maneiras diferentes:
- Use um nó PEP de Segurança para autorização do campo subject em um certificado de cliente que é recebido por um nó SOAPInput. Especifique o XPath a seguir na propriedade "local do token de identidade"
em um nó PEP de Segurança.
$LocalEnvironment/SOAP/Input/TransportSecurity/ClientAuth/Certificate/Subject
- Use um nó de Cálculo Java™ para
recuperar o campo emissor em um certificado de cliente que
é recebido por um nó HTTPInput.
String clientCertSubject = localEnv.getFirstElementByPath("HTTP/Input/TransportSecurity/ClientAuth/Certificate/Issuer").getValueAsString();
- Use um nó de Cálculo para configurar o campo subject
de um certificado que é recebido por um nó TCPIPServerInput.
SET LocalEnvironment.TCPIP.Input.TransportSecurity.ClientAuth.Certificate.Subject = 'BROKERUSER';