Ir para o conteúdo

Plugin OASIS Web Service Security (obsoleto) para Jitterbit Cloud e grupos de agentes privados

Introdução

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

Esta página detalha as etapas para usar o plugin OASIS Web Service Security:

  1. Baixe e adicione o plugin
  2. Associe o plugin a um grupo de agentes
  3. Atribuir o plugin O plugin pode ser atribuído a qualquer um destes Design Studio itens de projeto ou Integration Studio componentes do projeto:
  4. Defina variáveis globais para o plugin
  5. Configuração completa da operação

Importante

Os plugins fornecidos pelo Jitterbit estão obsoletos. Veja Deprecation and support em Plugins.

Versões e atualizações

Há 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 Web Services Addressing.

  • OASIS Web Service Security 1.3.0.0
    Esta versão contém todas as mesmas funcionalidades da versão 1.2.0.0 e também inclui suporte parcial para Web Services Addressing, com a adição destas variáveis globais: WSA.Action, WSA.To, e WSA.ToMustUnderstand. Esta é a versão recomendada atual.

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 desatribuir o plugin mais antigo de quaisquer itens de projeto aos quais ele foi atribuído e, em seguida, atribuir o plugin mais novo. Cada versão de plugin é independente.

Baixe e adicione o plugin

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

Associe o plugin a um grupo de agentes

Se estiver usando um grupo de agentes de 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 de nuvem do Jitterbit por padrão. Recomendamos usar a versão 1.3.0.0.

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

  1. Faça login no portal Harmony e vá para o Management Console. Em seguida, use o menu no canto superior esquerdo para navegar até Customizations > Plug-ins.
  2. Na tabela, localize a linha "OASIS Web Service Security", com atenção ao número da versão. A versão mais alta é recomendada. Na extrema direita, use o menu suspenso Ação para selecionar Associate Grupo de agentes.
  3. No pop-up, selecione um grupo de agentes privados 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 destes Design Studio itens de projeto ou Integration Studio componentes do projeto:

Nota

Ao conectar-se ao Workday, o plugin OASIS é necessário usando o conector Design Studio Workday somente. O Integration Studio Conector do Workday tem 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 chamada de serviço web operação.
  2. Dentro da operação, clique com o botão direito do mouse na chamada de serviço da web e selecione Plugin. No pop-up, em Plugins disponíveis, selecione "OASIS Web Service Security" e clique em Atribuir. Em seguida, clique em OK.

Para atribuir este plugin em Integration Studio:

  1. Adicione uma atividade SOAP para uma operação.
  2. Configure a atividade SOAP. Na última etapa da configuração, abaixo da exibição de esquemas de dados, clique em Add 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 Finished.

Dica

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

Definir variáveis globais para o plugin

Para que um plugin atribuído a uma chamada de serviço web ou atividade SOAP seja funcional, quaisquer variáveis globais exigidas 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 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á 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 wsu:Timestamp elemento. Se definido como false, o Timestamp elemento não será incluído.
WSS.TimeToLive Inteiro Obrigatório O tempo de vida da solicitação, em segundos. Este valor é ignorado se o IncludeTimestamp elemento é false.
WSS.UsePasswordDigest Boolean Obrigatório Se definido como false ou não definido, #PasswordTexté usado como o valor do Type atributo no Password elemento por padrão. Definido como true usar #PasswordDigest.
WSS.IncludeNonce Booleano Opcional Se definido como true ou não definido, o UserNameToken elemento contém um Nonce elemento por padrão. Definido como false para suprimir o Nonce elemento.
WSS.IncludeCreated Booleano Opcional Se definido como true ou não definido, o UserNameToken elemento contém um Created elemento por padrão. Definido como false para suprimir o Created elemento.
WSS.UseMilliSecondPrecision Booleano Opcional Se definido como false ou não definido, o registro de data e hora gerado no Created elemento usará uma precisão de 10-2 (0,01) segundos. Defina como true para usar precisão de milissegundos (Algumas implementações de serviços web não aceitam isso).
WSS.MustUnderstand Booleano Opcional Se definido como true ou não definido, o valor do mustUnderstand atributo no cabeçalho de segurança WSS que é inserido no envelope SOAP é definido como true. Definir para false para suprimir este elemento.
WSA.Action Cadeia de caracteres Opcional O wsa:Action valor do elemento no cabeçalho.

Nota

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

Nota

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

Nota

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

Configuração completa da operação

A parte do plugin da configuração da operação é concluída depois que você tem (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 da web (Design Studio) ou atividade SOAP (Integration Studio) na operação.

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

Uma operação completa no Design Studio:

operação do Design Studio

Uma operação completa em Integration Studio:

Integration Studio operação

Dica

Para obter detalhes sobre como concluir a operação, consulte Criar uma operação (Design Studio) ou Criação e configuração de operação (Integration Studio).