Ir para o conteúdo

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:

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

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.

  • 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étrica: 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 de JWT JWS:

      • Tipo de assinatura: Um dos tipos 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.

            Cuidado

            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 caracteres 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 caracteres 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 caracteres em branco.

            Para evitar isso, remova os caracteres 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 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 do JWT.
    • Propriedades do Cabeçalho: Metadados relevantes para o payload do JWT.

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

    • Chave: O nome ou chave do objeto payload ou cabeçalho. Por exemplo, alg, typ, cty ou kid para objetos de cabeçalho.
    • Valor: Os dados associados à chave para um objeto payload ou cabeçalho.
    • Tipo de Dados: O tipo de dados que representa o valor de um objeto payload ou cabeçalho. O tipo de dados deve ser um dos seguintes: 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 solicita que você confirme 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 cabeçalho correspondem às propriedades descritas em Configurações Opcionais na etapa 1.

    O conector JWT utiliza a biblioteca Java JWT. Os nós e campos do esquema são baseados nas seleções feitas na etapa 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 esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas 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 etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade JWT Gerar Token, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas 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.