Tykall's blog: Incluir UsernameToken en cabecera SOAP

Algunos servicios web requieren autenticación mediante Web Service Security en la que se pasen parámetros como usuario y contraseña a través de la cabecera SOAP del mensaje. En principio, esta opción NO está recogida en el adaptador SOAP de XI, pero existen dos alternativas que nos permitirán informar dichos parámetros:

A través del adaptador AXIS (requiere instalación previa y configuración)
Mediante un mapeo XSLT

A continuación mostraré un ejemplo de mapeo XSL que añade la capa SOAP a un mensaje determinado. El objetivo es conseguir transformar el mensaje XML:

<?xml version="1.0" encoding="ISO-8859-1"?>
<ns0:Foo xmlns:ns0="uri:something">
 <ns0:Bar>
  <![CDATA[<mensaje/>]]>
 </ns0:Bar>
</ns0:Foo>

En el mensaje XML de salida siguiente, con la capa SOAP indicada:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"        
               xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
 <soap:Header>   
  <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" 
                 xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" 
        soap:mustUnderstand="1">    
   <wsse:UsernameToken xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" 
        xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">     
    <wsse:Username>usuario</wsse:Username>     
    <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">password</wsse:Password>
   </wsse:UsernameToken>   
  </wsse:Security>  
 </soap:Header>  
 <soap:Body xmlns:ns1="uri:something">
  <ns1:Foo>    
   <ns1:Bar>
    <![CDATA[<mensaje/>]]>
   </ns1:Bar>   
  </ns1:Foo>  
 </soap:Body> 
</soap:Envelope>

Para ello se ha utilizado la siguiente transformación XSL:

<?xml version="1.0" encoding="ISO-8859-1"?>  
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"      
    xmlns:ns0="uri:something"
    xmlns:ns1="uri:something"
    xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"     
    version="1.0">   
 <xsl:output method="xml" version="1.0" encoding="ISO-8859-1" indent="yes" />    
 <xsl:attribute-set name="attr-soap">   
  <xsl:attribute name="soap:mustUnderstand">1
  </xsl:attribute>  
 </xsl:attribute-set>    
 <xsl:attribute-set name="attr-pasw">    
  <xsl:attribute name="Type">http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText
  </xsl:attribute>  
 </xsl:attribute-set>   
 <xsl:template match="/">    
  <soap:Envelope>       
   <soap:Header>     
    <xsl:element name="wsse:Security"
        use-attribute-sets="attr-soap">
     <xsl:element name="wsse:UsernameToken">
      <xsl:element name="wsse:Username">usuario
      </xsl:element>          
      <xsl:element name="wsse:Password"
          use-attribute-sets="attr-pasw">password
      </xsl:element>                        
     </xsl:element>               
    </xsl:element>    
   </soap:Header>       
   <soap:Body>         
    <ns1:Foo>
     <ns1:Bar>       
      <xsl:value-of select="ns0:Foo/ns0:Bar" />      
     </ns1:Bar>     
    </ns1:Foo>         
   </soap:Body>   
  </soap:Envelope>     
 </xsl:template>  
</xsl:stylesheet>

Debido a que estamos incluyendo la capa SOAP en el mapeo del mensaje, habrá que indicar en el canal de recepción que no se incluya la capa SOAP de nuevo. Esto se consigue marcando la casilla "Do Not Use SOAP Envelope" en el apartado Conversion Parameters del adaptador.

El marcar esta casilla, causará que el mensaje se envíe como tipo "application/xml", lo cual provocará en el receptor un mensaje de error HTTP 415 (Unsupported Media Type). Por ello será necesario incluir en el adaptador el módulo AF_Modules/MessageTransformBean, antes del propio módulo del adaptador, y configurar el parámetro Transform.ContentType con el valor text/xml. De este modo, el mensaje se enviará codificado como 'text/xml'.

Enlaces de referencia:

Enlaces de interés:

Tykall's blog

jueves, enero 13, 2011

Incluir UsernameToken en cabecera SOAP

1 comentario: