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 OASIS Web Services Security (WSS) encabezado de seguridad a 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:

Descargar y agregar el complemento
Asociar el complemento con un grupo de agentes
Asignar el complemento El complemento se puede asignar a cualquiera de estos Design Studio elementos del proyecto o Integration Studio Componentes del proyecto:
- Design Studio llamada de servicio web utilizando un método de servicio web
- Design Studio llamada de servicio web utilizando un extremo de Workday
- Integration Studio Actividad SOAP
Establecer variables globales para el complemento
Configuración completa de la operación

Importante

Los complementos proporcionados por Jitterbit están obsoletos.

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 la misma funcionalidad 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 usa una versión anterior del complemento y desea actualizar a una versión superior, el proceso de actualización es manual. Es decir, debe desasignar el complemento anterior de cualquier elemento del proyecto al que lo tenga asignado y luego asignar el complemento más reciente. 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.

Seguridad del servicio web OASIS 1.3.0.0 (ZIP)

Asociar el complemento con un grupo de agentes

Si usa 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 a los grupos de agentes en la nube de Jitterbit de forma predeterminada. Recomendamos usar la versión 1.3.0.0.

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

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

Consejo

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:

Design Studio llamada a servicio web utilizando un método de servicio web
Design Studio llamada a servicio web utilizando un extremo de Workday
Integration Studio Actividad SOAP

Nota

Al conectarse a Workday, se requiere el complemento OASIS mediante el conector Design Studio Workday únicamente. El conector Workday de Integration Studio 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:

Cree una llamada de servicio web operación.
Dentro de la operación, haga clic derecho en la llamada al servicio web y seleccione Plugin. En la ventana emergente, en Plugins disponibles, seleccione "OASIS Web Service Security" y haga clic en Asignar. Luego, haga clic en Aceptar.

Para asignar este complemento en Integration Studio:

Agregue una actividad SOAP a una operación.
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 complemento(s) para expandir esta sección y seleccione la casilla junto a "Seguridad del servicio web OASIS". Luego, haga clic en Finalizar.

Consejo

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 a un servicio web o una actividad SOAP funcione, se deben configurar las variables globales que requiere. Estas variables se configuran en un secuencia de comandos, que debe colocarse antes de la llamada al servicio web o la actividad SOAP en la operación para que se puedan inicializar.

Consejo

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

Secuencia de comandos como elemento de proyecto en Creación de un secuencia de comandos (Design Studio)
Variables globales (Design Studio)
Secuencia de comandos como componente del proyecto en Tipos de Secuencia de comandos y creación (Integration Studio)
Variables globales (Integration Studio)

A continuación se proporciona una modelo de secuencia de comandos, seguida de documentación sobre las variables que se pueden usar 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á.
`WSS.TimeToLive`	Entero	Obligatorio	Duración de la solicitud, en segundos. Este valor se ignora si `IncludeTimestamp` elemento es `false`.
`WSS.UsePasswordDigest`	Booleano	Obligatorio	Si se establece en `false` o no establecido, `#PasswordText` se utiliza como el valor de la `Type` atributo en el `Password` Elemento por defecto. Establecer en `true` utilizar `#PasswordDigest`.
`WSS.IncludeNonce`	Booleano	Opcional	Si se establece en `true` o no establecido, el `UserNameToken` El elemento contiene un `Nonce` Elemento por defecto. Establecer 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. Establecer 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. Establecido 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.
`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 origen o destino adicional para la operación.

Una operación completa en Design Studio:

operación de Desig Studio

Una operación completa en Integration Studio:

operación de Integration Studio

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).