Ir para o conteúdo

Atividade JWT Gerar Token no Jitterbit Studio

Introdução

Uma atividade JWT Gerar Token, utilizando sua conexão JWT, gera um Token Web JSON (JWT) e é destinada a ser usada como um alvo para consumir dados em uma operação.

Criar uma atividade JWT Gerar Token

Uma instância de uma atividade JWT Gerar Token é criada a partir de uma conexão JWT usando seu tipo de atividade Gerar Token.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade JWT Gerar Token existente pode ser editada a partir destes locais:

Configurar uma atividade JWT Gerar Token

Siga estas etapas para configurar uma atividade JWT Gerar Token:

Etapa 1: Insira um nome e especifique as configurações

Neste passo, forneça um nome para a atividade e especifique o tipo de JWT, as configurações dependentes do tipo de JWT e as configurações opcionais. Cada elemento da interface do usuário deste passo é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Menu de endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, veja Alterar o endpoint atribuído em Telasa de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint atualmente selecionado.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade de JWT Gerar Token e não deve conter barras / ou dois pontos :.

  • Tipo de JWT: Selecione entre assinar o JWT usando uma Assinatura Web JSON (JWS) ou criptografá-lo usando Criptografia Web JSON (JWE).

    Importante

    Se assinaturas ou criptografia não forem necessárias, selecione o tipo de JWT JWS e o tipo de Assinatura Nenhuma.

    • JWE: Se estiver usando o tipo de JWT JWE:

      • Tipo de algoritmo de gerenciamento de chave: Um de Assimétrico ou Simétrico.

        • Assimétrico: Se estiver usando o tipo de algoritmo de gerenciamento de chave Assimétrico.

          • Algoritmos de gerenciamento de chave assimétricos: Um de RSA1_5, RSA_OAEP ou RSA_OAEP_256.
          • Chave de criptografia pública: Insira uma chave pública.

        • Simétrico: Se estiver usando o tipo de algoritmo de gerenciamento de chave Simétrico.

          • Algoritmos de gerenciamento de chave simétrica: Um dos A128KW, A192KW ou A256KW.
          • Chave secreta de criptografia: Insira uma chave secreta.
          • Codificado em Base64: Selecione se a codificação em Base64 é necessária.

      • Algoritmos de criptografia de conteúdo: Um dos A128CBC_HS256, A128GCM, A192CBC_HS384, A192GCM, A256CBC_HS512 ou A256GCM.

    • JWS: Se estiver usando o tipo JWT JWS:

      • Tipo de assinatura: Um dos Assimétrico, Simétrico ou Nenhum.

        • Assimétrico: Se estiver usando o tipo de assinatura Assimétrico.

          • Algoritmos de assinatura: Um dos ES256, ES384, ES512, PS256, PS384, PS512, RS256, RS384 ou RS512.

          • Chave privada: Insira uma chave privada.

            Atenção

            Uma chave privada contendo caracteres de espaço em branco, como caracteres de nova linha (\n), pode causar o seguinte erro quando fornecida a partir de uma transformação:

            Código de Erro: Erro ao executar a atividade generateToken. A exceção é: A chave contém caracteres de espaço em branco. Por favor, forneça uma chave válida sem espaços em branco.,
Descrição do Erro: Erro ao executar a atividade generateToken. A exceção é: A chave contém caracteres de espaço em branco. Por favor, forneça uma chave válida sem espaços em branco.,
Stack Trace: org.jitterbit.connector.sdk.exceptions.ActivityExecutionException: Erro ao executar a atividade generateToken. A exceção é: A chave contém caracteres de espaço em branco. Por favor, forneça uma chave válida sem espaços em branco.

            Para evitar isso, remova os caracteres de espaço em branco da chave ou considere usar a função CreateJwtToken se o seu caso de uso permitir.

        • Simétrico: Se estiver usando o tipo de assinatura Simétrico.

          • Algoritmos de assinatura: Um de HS256, HS384 ou HS512.
          • Chave secreta: Insira uma chave secreta.
          • Codificado em Base64: Selecione se a codificação em Base64 é necessária.

        • Nenhum: Se usar o tipo de assinatura None, nenhum campo adicional aparece.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais.

    • Propriedades do Payload: O payload do JWT.
    • Propriedades do Cabeçalho: Metadados relevantes para o payload do JWT.

    Como mostrado acima, cada definição de payload e cabeçalho possui as seguintes propriedades:

    • Chave: O nome ou chave do objeto de payload ou cabeçalho. Por exemplo, alg, typ, cty ou kid para objetos de cabeçalho.
    • Valor: Os dados associados à chave para um objeto de payload ou cabeçalho.
    • Tipo de Dados: O tipo de dados que representa o valor de um objeto de payload ou cabeçalho. O tipo de dados deve ser um de boolean, decimal, number ou string.

    Para mais informações sobre os payloads e cabeçalhos JWT, consulte IETF RFC 7519: JSON Web Token (JWT).

  • Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Esquemas de dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    Nota

    Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

    Os campos key, value e dataType dos nós de payload e header correspondem às propriedades descritas em Configurações Opcionais no passo 1.

    O conector JWT utiliza a biblioteca Java JWT. Os nós e campos do esquema são baseados nas seleções feitas no passo 1. Para mais informações sobre a especificação JWT, consulte IETF RFC 7519: JSON Web Token (JWT).

  • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para regenerar esquemas a partir do endpoint JWT. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração para este passo e retornar ao passo anterior.

  • Concluído: Clique para salvar a configuração de todos os passos e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer passo. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximos passos

Após configurar uma atividade JWT Gerar Token, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como passos da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, consulte o menu de ações da atividade em Conceitos básicos do conector.

Atividades JWT Gerar Token podem ser usadas como um alvo com esses padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.