Saltar al contenido

Complemento de seguridad del servicio web OASIS (obsoleto) para la nube Jitterbit y grupos de agentes privados

Introducción

El complemento de seguridad de servicios web OASIS de Jitterbit se utiliza para agregar un Seguridad de servicios web OASIS (WSS) encabezado de seguridad para una solicitud de servicio web. El encabezado incluye un UserNameToken elemento. Opcionalmente, el encabezado puede incluir un Timestamp elemento.

Esta página detalla los pasos para utilizar el complemento de seguridad del servicio web OASIS:

  1. Descargar y agregar el complemento
  2. Asociar el complemento con un grupo de agentes
  3. Asignar el complemento El complemento se puede asignar a cualquiera de estos Design Studio elementos del proyecto o Integration Studio componentes del proyecto:
  4. Establecer variables globales para el complemento
  5. Configuración completa de la operación

Importante

Los complementos proporcionados por Jitterbit están obsoletos. Consulte Obsolescencia y soporte en Complementos.

Versiones y actualizaciones

Hay tres versiones de este complemento disponibles:

  • Seguridad del servicio web OASIS 1.0.0.0
    Esta versión está obsoleta y no debe utilizarse.

  • Seguridad del servicio web OASIS 1.2.0.0
    Esta versión contiene funcionalidad básica, pero no incluye soporte para direccionamiento de servicios web.

  • Seguridad del servicio web OASIS 1.3.0.0
    Esta versión contiene todas las mismas funciones que la versión 1.2.0.0 y también incluye soporte parcial para Direccionamiento de servicios web, con la adición de estas variables globales: WSA.Action, WSA.To, y WSA.ToMustUnderstand Esta es la versión recomendada actual.

Si actualmente está utilizando una versión anterior del complemento y desea actualizarlo a una versión superior, el proceso de actualización es manual. Es decir, debe anular la asignación del complemento anterior de cualquier elemento del proyecto al que lo tenga asignado y, luego, asignar el complemento más nuevo. Cada versión del complemento es independiente.

Descargue y agregue el complemento

El complemento de seguridad del servicio web OASIS debe descargarse en el enlace que se proporciona a continuación y agregarse a la organización.

Asociar el complemento con un grupo de agentes

Si utiliza un grupo de agentes en la nube, puede omitir este paso, ya que todas las versiones del complemento de seguridad de servicios web de OASIS ya están asociadas con los grupos de agentes en la nube de Jitterbit de forma predeterminada. Recomendamos utilizar la versión 1.3.0.0.

Si utiliza un grupo de agentes privados, debe asociar este complemento proporcionado por Jitterbit con un grupo de agentes privados. Esto hará que el complemento esté disponible en todos los agentes privados dentro del grupo de agentes privados. Para asociar el complemento:

  1. Inicie sesión en el portal Harmony y vaya a la Management Console. Luego, use el menú en la parte superior izquierda para navegar a Personalizaciones > Complementos.
  2. En la tabla, busque la fila "OASIS Web Service Security" y preste atención al número de versión. Se recomienda la versión más alta. En el extremo derecho, utilice el menú desplegable Acción para seleccionar Asociar Grupo de agentes.
  3. En la ventana emergente, seleccione un grupo de agentes privados y haga clic en Guardar.

Sugerencia

La documentación detallada sobre la asociación de complementos está disponible en Personalizaciones > Complementos.

Asignar el complemento

Este complemento se puede asignar a cualquiera de estos Design Studio elementos del proyecto o Integration Studio componentes del proyecto:

Nota

Al conectarse a Workday, se requiere el complemento OASIS mediante el conector Workday de Design Studio solamente. El Integration Studio Conector de Workday tiene una funcionalidad incorporada para los encabezados OASIS utilizando el nombre de usuario y la contraseña proporcionados durante la configuración de la conexión.

Para asignar este complemento en Design Studio:

  1. Cree una llamada de servicio web operación.
  2. Dentro de la operación, haga clic derecho en la llamada del servicio web y seleccione Plugin. En la ventana emergente, en Available plugins, seleccione "OASIS Web Service Security" y haga clic en Assign. Luego, haga clic en OK.

Para asignar este complemento en Integration Studio:

  1. Agregue una actividad SOAP a una operación.
  2. Configure la actividad SOAP. En el último paso de la configuración, debajo de la visualización de esquemas de datos, haga clic en Agregar complementos para expandir esta sección y seleccione la casilla de verificación junto a "Seguridad del servicio web OASIS". Luego, haga clic en Finalizar.

Sugerencia

La documentación detallada sobre la asignación de complementos está disponible en Aplicación de complementos de canalización (Design Studio) o Complementos añadidos a una actividad (Integration Studio).

Establecer variables globales para el complemento

Para que un complemento asignado a una llamada de servicio web o una actividad SOAP funcione, se deben configurar todas las variables globales que requiere el complemento. Estas variables se configuran en un secuencia de comandos, que se debe colocar antes de la llamada de servicio web o la actividad SOAP en la operación para que se puedan inicializar las variables.

Consejo

Para obtener más información, consulte estas páginas:

A continuación se proporciona una modelo de secuencia de comandos, seguida de documentación sobre las variables que se pueden utilizar con este complemento:

Script
<trans>
$WSS.User = "user@example.com";
$WSS.Password = "mypassword";
$WSS.IncludeTimestamp = true;
$WSS.TimeToLive = 10;
$WSS.UsePasswordDigest = true;
$WSS.IncludeNonce = false;
$WSS.IncludeCreated = false;
$WSS.UseMilliSecondPrecision = false;
$WSS.MustUnderstand = false;
$WSA.Action = "http://example.com/examples-apply/ExampleRequest";
$WSA.To = "http://www.example.com/sys2/example-apply-v2-0";
$WSA.ToMustUnderstand = false;
</trans>
Nombre Tipo Obligatorio Descripción
WSS.User Cadena Obligatorio El nombre de usuario que permitirá el acceso al servicio web.
WSS.Password Cadena Obligatorio La contraseña asociada al nombre de usuario que permitirá el acceso al servicio web.
WSS.IncludeTimestamp Booleano Obligatorio Si se establece en true o no se establece, el encabezado creado incluirá un wsu:Timestamp elemento. Si se establece en false, el Timestamp El elemento no se incluirá.TABLEROWEND
WSS.TimeToLive Entero Obligatorio Duración de la solicitud, en segundos. Este valor se ignora si la solicitud IncludeTimestamp El elemento es false.
WSS.UsePasswordDigest Booleano Obligatorio Si se establece en false o no establecido, #PasswordTextse utiliza como el valor de la Type atributo en el Password Elemento por defecto. Establecido en true Para usar #PasswordDigest.
WSS.IncludeNonce Booleano Opcional Si se establece en true o no establecido, el UserNameToken El elemento contiene un Nonce Elemento por defecto. Establecido en false Para suprimir el Nonce elemento.
WSS.IncludeCreated Booleano Opcional Si se establece en true o no establecido, el UserNameToken El elemento contiene un Created Elemento por defecto. Establecido en false Para suprimir el Created elemento.
WSS.UseMilliSecondPrecision Booleano Opcional Si se establece en false o no se establece, la marca de tiempo generada en el Created El elemento utilizará una precisión de 10-2 (0,01) segundos. Establezca en true para utilizar precisión de milisegundos (Algunas implementaciones de servicios web no aceptan esto).
WSS.MustUnderstand Booleano Opcional Si se establece en true o no establecido, el valor de la mustUnderstand El atributo en el encabezado de seguridad WSS que se inserta en el sobre SOAP se establece en true Establecer en false para suprimir este elemento.TABLEROWEND
WSA.Action Cadena Opcional El wsa:Action valor del elemento en el encabezado.

Nota

Esta variable solo es compatible con la versión del complemento 1.3.0.0 o superior.
WSA.To Cadena Opcional El wsa:To valor del elemento en el encabezado.

Nota

Esta variable solo es compatible con la versión del complemento 1.3.0.0 o superior.
WSA.ToMustUnderstand Booleano Opcional Si se establece en false o no establecido, el valor de la wsa:To elemento mustUnderstand El atributo en el encabezado que se inserta en el sobre SOAP se establece en false Establecer en true exigir al destinatario que procese el wsa:To entrada de encabezado .

Nota

Esta variable solo es compatible con la versión del complemento 1.3.0.0 o superior.

Configuración completa de la operación

La parte del complemento de la configuración de la operación se completa después de tener (1) el secuencia de comandos que define las variables que se usarán con el complemento y (2) el complemento asignado a una llamada de servicio web (Design Studio) o actividad SOAP (Integration Studio) en la operación.

Para completar la configuración de la operación, configure las transformaciones de solicitud y respuesta del servicio web, junto con cualquier fuente o destino adicional para la operación.

Una operación completa en Design Studio:

operación del Design Studio

Una operación completa en Integration Studio:

Integration Studio operación

Consejo

Para obtener detalles sobre cómo completar la operación, consulte Crear una operación (Design Studio) o Creación y configuración de operaciones (Integration Studio).