Ir para o conteúdo

Plugin de Segurança de Serviço Web OASIS (obsoleto) para grupos de agentes Jitterbit

Introdução

O plugin de Segurança de Serviço Web OASIS da Jitterbit é utilizado para adicionar um cabeçalho de segurança OASIS Web Services Security (WSS) a uma solicitação de serviço web. O cabeçalho inclui um elemento UserNameToken. Opcionalmente, o cabeçalho pode incluir um elemento Timestamp.

Esta página detalha os passos para usar o plugin de Segurança de Serviço Web OASIS:

  1. Baixar e adicionar o plugin
  2. Associar o plugin a um grupo de agentes
  3. Atribuir o plugin O plugin pode ser atribuído a qualquer um desses itens de projeto do Design Studio ou componentes de projeto do Studio:
  4. Definir variáveis globais para o plugin
  5. Completar a configuração da operação

Importante

Plugins fornecidos pela Jitterbit são obsoletos.

Versões e atualização

Existem três versões deste plugin disponíveis:

  • OASIS Web Service Security 1.0.0.0
    Esta versão está obsoleta e não deve ser usada.

  • OASIS Web Service Security 1.2.0.0
    Esta versão contém funcionalidade básica, mas não inclui suporte para Endereçamento de Serviços Web.

  • OASIS Web Service Security 1.3.0.0
    Esta versão contém toda a mesma funcionalidade da versão 1.2.0.0 e também inclui suporte parcial para Web Services Addressing, com a adição dessas variáveis globais: WSA.Action, WSA.To e WSA.ToMustUnderstand. Esta é a versão recomendada atualmente.

Se você estiver usando uma versão de plugin inferior e quiser atualizar para uma versão superior, o processo de atualização é manual. Ou seja, você deve desassociar o plugin mais antigo de qualquer item de projeto ao qual ele esteja atribuído e, em seguida, atribuir o plugin mais novo. Cada versão de plugin é independente.

Baixar e adicionar o plugin

O plugin OASIS Web Service Security deve ser baixado no link fornecido abaixo e adicionado à organização.

Associar o plugin a um grupo de agentes

Se estiver usando um grupo de agentes em nuvem, você pode pular esta etapa, pois todas as versões do plugin OASIS Web Service Security já estão associadas aos grupos de agentes em nuvem da Jitterbit por padrão. Recomendamos usar a versão 1.3.0.0.

Se estiver usando um grupo de agentes privado, você deve associar este plugin fornecido pela Jitterbit a um grupo de agentes privado. Isso tornará o plugin disponível em todos os agentes privados dentro do grupo de agentes privado. Para associar o plugin:

  1. Faça login no portal Harmony e vá para o Console de Gerenciamento. Em seguida, use o menu no canto superior esquerdo para navegar até Personalizações > Plug-ins.
  2. Na tabela, localize a linha "OASIS Web Service Security," prestando atenção ao número da versão. A versão mais alta é recomendada. No extremo direito, use o dropdown Ação para selecionar Associar Grupo de Agentes.
  3. Na janela pop-up, selecione um grupo de agentes privado e clique em Salvar.

Dica

A documentação detalhada sobre a associação de plugins está disponível em Personalizações > Plug-ins.

Atribuir o plugin

Este plugin pode ser atribuído a qualquer um desses itens de projeto do Design Studio ou componentes de projeto do Studio:

Nota

Ao conectar-se ao Workday, o plugin OASIS é necessário usando apenas o conector Workday do Design Studio. O conector Workday do Studio possui funcionalidade integrada para cabeçalhos OASIS usando o nome de usuário e a senha fornecidos durante a configuração da conexão.

Para atribuir este plugin no Design Studio:

  1. Crie uma operação de chamada de serviço web.
  2. Dentro da operação, clique com o botão direito na chamada de serviço web e selecione Plugin. Na janela pop-up, em Plugins disponíveis, selecione "OASIS Web Service Security" e clique em Atribuir. Em seguida, clique em OK.

Para atribuir este plugin no Studio:

  1. Adicione uma atividade SOAP a uma operação.
  2. Configure a atividade SOAP. Na última etapa da configuração, abaixo da exibição dos esquemas de dados, clique em Adicionar Plugin(s) para expandir esta seção e selecione a caixa de seleção ao lado de "OASIS Web Service Security." Em seguida, clique em Concluído.

Dica

A documentação detalhada sobre a atribuição de plugins está disponível em Aplicando plugins de pipeline (Design Studio) ou Plugins adicionados a uma atividade (Studio).

Defina variáveis globais para o plugin

Para que um plugin atribuído a uma chamada de serviço web ou atividade SOAP funcione, quaisquer variáveis globais necessárias pelo plugin devem ser definidas. Essas variáveis são definidas em um script, que deve ser colocado antes da chamada de serviço web ou da atividade SOAP na operação, para que as variáveis possam ser inicializadas.

Dica

Para mais informações, consulte estas páginas:

Um modelo de script é fornecido abaixo, seguido pela documentação sobre as variáveis que podem ser usadas com este plugin:

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>
Nome Tipo Obrigatório Descrição
WSS.User String Obrigatório O nome de usuário que permitirá o acesso ao serviço web.
WSS.Password String Obrigatório A senha associada ao nome de usuário que permitirá o acesso ao serviço web.
WSS.IncludeTimestamp Boolean Obrigatório Se definido como true ou não definido, o cabeçalho criado incluirá um elemento wsu:Timestamp. Se definido como false, o elemento Timestamp não será incluído.
WSS.TimeToLive Integer Obrigatório O tempo de vida da solicitação, em segundos. Este valor é ignorado se o elemento IncludeTimestamp for false.
WSS.UsePasswordDigest Boolean Obrigatório Se definido como false ou não definido, #PasswordText é usado como o valor do atributo Type no elemento Password por padrão. Defina como true para usar #PasswordDigest.
WSS.IncludeNonce Boolean Opcional Se definido como true ou não definido, o elemento UserNameToken contém um elemento Nonce por padrão. Defina como false para suprimir o elemento Nonce.
WSS.IncludeCreated Boolean Opcional Se definido como true ou não definido, o elemento UserNameToken contém um elemento Created por padrão. Defina como false para suprimir o elemento Created.
WSS.UseMilliSecondPrecision Boolean Opcional Se definido como false ou não definido, o timestamp gerado no elemento Created usará uma precisão de 10-2 (0,01) segundos. Defina como true para usar precisão de milissegundos (Algumas implementações de serviço web não aceitam isso.).
WSS.MustUnderstand Boolean Opcional Se definido como true ou não definido, o valor do atributo mustUnderstand no cabeçalho de segurança WSS que é inserido no envelope SOAP é definido como true. Defina como false para suprimir este elemento.
WSA.Action String Opcional O valor do elemento wsa:Action no cabeçalho.

Nota

Esta variável é suportada apenas na versão 1.3.0.0 ou superior do plugin.
WSA.To String Opcional O valor do elemento wsa:To no cabeçalho.

Nota

Esta variável é suportada apenas na versão 1.3.0.0 ou superior do plugin.
WSA.ToMustUnderstand Boolean Opcional Se definido como false ou não definido, o valor do atributo mustUnderstand do elemento wsa:To no cabeçalho que é inserido no envelope SOAP é definido como false. Defina como true para exigir que o destinatário processe a entrada do cabeçalho wsa:To.

Nota

Esta variável é suportada apenas na versão 1.3.0.0 ou superior do plugin.

Configuração completa da operação

A parte do plugin da configuração da operação está completa após você ter (1) o script definindo as variáveis a serem usadas com o plugin e (2) o plugin atribuído a uma chamada de serviço web (Design Studio) ou atividade SOAP (Studio) na operação.

Para completar a configuração da operação, configure as transformações de solicitação e resposta do serviço web, juntamente com quaisquer fontes ou destinos adicionais para a operação.

Uma operação completa no Design Studio:

Operação do Design Studio

Uma operação completa no Studio:

Operação do Studio

Dica

Para detalhes sobre como completar a operação, consulte Criar uma operação (Design Studio) ou Criação e configuração de operações (Studio).