Atividade Gerar Token JWT

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 Gerar Token JWT

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:

• A tela de design (veja Menu de ações do componente em Tela de design).
• A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).

Configurar uma atividade Gerar Token JWT

Siga estas etapas para configurar uma atividade JWT Gerar Token:

• Etapa 1: Insira um nome e especifique as configurações
  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.

• Etapa 2: Revise os esquemas de dados
  Quaisquer esquemas de solicitação ou resposta são exibidos.

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.

• 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 Nenhum.

  • 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 de 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 de A128CBC_HS256, A128GCM, A192CBC_HS384, A192GCM, A256CBC_HS512 ou A256GCM.

  • JWS: Se estiver usando o tipo JWT JWS:

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

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

        

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

        • Chave privada: Insira uma chave privada.

          Atenção

          Uma chave privada contendo caracteres 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 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 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 em branco. Por favor, forneça uma chave válida sem espaços em branco.
          

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

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

        

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

      • Nenhum: Se estiver usando o tipo de assinatura Nenhum, nenhum campo adicional aparece.

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

  

  • Propriedades do Payload: O payload JWT.
  • Propriedades do Cabeçalho: Metadados relevantes para o payload 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 dos 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 que você confirme que deseja descartar as alterações.

Passo 2: Revisar os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário deste passo é 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 do endpoint JWT. Esta ação também regenera um esquema em outros locais ao longo do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

• Voltar: Clique para armazenar temporariamente a configuração deste 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 pede para você confirmar que deseja descartar as alterações.

Próximos passos

Após configurar uma atividade Gerar Token JWT, 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 de menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para mais detalhes, veja o menu de ações da atividade em Conceitos básicos de conectores.

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

• Padrão de transformação
• Padrão de duas transformações (como o primeiro ou segundo alvo)

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.