Saltar al contenido

¡Transforma tus conexiones en dinero para el final del año con nuestro nuevo Programa de Indicación de Clientes! Descubre más

✕

Actividad de generación de tokens JWT

Introducción

Una actividad JWT Generar token, que utiliza su conexión JWT, genera un JSON Web Token (JWT) y está destinado a ser utilizado como un objetivo para consumir datos en una operación.

Crear una actividad de generación de token JWT

Se crea una instancia de una actividad JWT Generar token a partir de una conexión JWT utilizando su tipo de actividad Generar token.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño de tela de diseño o cópielo y péguelo en él. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Se puede editar una actividad Generar token de JWT existente desde estas ubicaciones:

Configurar una actividad de generación de token JWT

Sigue estos pasos para configurar una actividad JWT Generar token:

Paso 1: Ingrese un nombre y especifique la configuración

En este paso, asigne un nombre a la actividad y especifique el tipo de JWT, la configuración dependiente del tipo de JWT y la configuración opcional. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

Configuración de la actividad Generar token JWT, paso 1

Consejo

Campos con un icono de variable soporte utilizando variables globales, variables del proyecto y variables de Jitterbit. Comience escribiendo un corchete abierto [ En el campo o haciendo clic en el icono de variable para ver una lista de las variables existentes.

  • Nombre: Introduzca un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Generar token de JWT y no debe contener barras diagonales. / o dos puntos :.

  • Tipo de JWT: Seleccione entre firmar el JWT con una Firma Web JSON (JWS) o encriptarlo usando JSON Web Encryption (JWE).

    Importante

    Si no se requieren firmas ni cifrado, seleccione el tipo JWT JWS y el tipo de firma Ninguna.

    • JWE: Si utiliza el tipo JWT JWE:

      • Tipo de algoritmo de gestión de claves: Uno de asimétrico o simétrico.

        • Asimétrico: Si utiliza el algoritmo de administración de claves Asimétrico, escriba:

          Configuración de la actividad de generación de token JWT paso 1 jwe asym

          • Algoritmos de gestión de claves asimétricas: Uno de RSA1_5, RSA_OAEP o RSA_OAEP_256.
          • Clave de cifrado pública: Ingrese una clave pública.

        • Simétrico: Si utiliza el tipo de algoritmo de administración de claves Simétrico:

          Configuración de la actividad de generación de token JWT, paso 1, jwe sym

          • Algoritmos de administración de claves simétricas: Uno de A128KW, A192KW o A256KW.
          • Clave secreta de cifrado: Ingrese una clave secreta.
          • Codificado en Base64: Seleccione si se requiere codificación Base64.

      • Algoritmos de cifrado de contenido: Uno de A128CBC_HS256, A128GCM, A192CBC_HS384, A192GCM, A256CBC_HS512 o A256GCM.

    • JWS: Si utiliza el tipo JWT JWS:

      • Tipo de firma: Uno de los siguientes: Asimétrica, Simétrica o Ninguna.

        • Asimétrica: Si se utiliza el tipo de firma Asimétrica:

          Configuración de la actividad de generación de token JWT, paso 1, jws asym

          • Algoritmos de firma: Uno de los siguientes: ES256, ES384, ES512, PS256, PS384, PS512, RS256, RS384 o RS512.

          • Clave privada: Introduzca una clave privada.

            Precaución

            Una clave privada que contiene caracteres de espacio en blanco, como caracteres de nueva línea (\n) puede provocar el siguiente error cuando se suministra desde una transformación:

            Error Code: Error executing generateToken activity. The Exception is: Key contains whitespace characters. Please provide a valid key without whitespace.,
Error Desc: Error executing generateToken activity. The Exception is: Key contains whitespace characters. Please provide a valid key without whitespace.,
Stack Trace: org.jitterbit.connector.sdk.exceptions.ActivityExecutionException: Error executing generateToken activity. The Exception is: Key contains whitespace characters. Please provide a valid key without whitespace.

            Para evitar esto, elimine los espacios en blanco de la clave o considere usar el símbolo CreateJwtToken función si su caso de uso lo permite.

        • Simétrico: Si se utiliza el tipo de firma Simétrico:

          Configuración de la actividad Generar token JWT, paso 1, jws sym

          • Algoritmos de firma: Uno de HS256, HS384 o HS512.
          • Clave secreta: Ingrese una clave secreta.
          • Codificado en Base64: Seleccione si se requiere codificación Base64.

        • Ninguno: Si se utiliza el tipo de firma Ninguno, no aparecen campos adicionales.

  • Configuración opcional: Haga clic para expandir configuraciones opcionales adicionales:

    Configuración de la actividad de generación de token JWT, paso 1, opcional

    • Propiedades de la carga útil: La carga útil JWT.
    • Propiedades del encabezado: Metadatos relevantes para la carga útil JWT.

    Como se muestra arriba, cada definición de carga útil y encabezado tiene las siguientes propiedades:

    • Clave: El nombre o la clave del objeto de carga útil o encabezado. Por ejemplo, alg, typ, cty, o kid para objetos de encabezado.
    • Valor: Los datos asociados con la clave para un objeto de carga útil o encabezado.
    • Tipo de dato: El tipo de dato que representa el valor de un objeto de carga útil o de encabezado. El tipo de dato debe ser uno de los siguientes: boolean, decimal, number, o string.

    Para obtener más información sobre las cargas útiles y los encabezados de JWT, consulte IETF RFC 7519: Token web JSON (JWT).

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Se muestran los esquemas de solicitud y respuesta. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

Configuración de la actividad Generar token JWT, paso 2

  • Esquemas de datos: Estos esquemas de datos son heredados por las transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.

    Nota

    Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

    Los nodos de carga útil y de encabezado key, value y dataType Los campos corresponden a las propiedades descritas en Configuración opcional en el paso 1.

    El conector JWT utiliza la biblioteca JWT de Java. Los nodos y campos del esquema se basan en las selecciones realizadas en el paso 1. Para obtener más información sobre la especificación JWT, consulte IETF RFC 7519: JSON Web Token (JWT).

  • Actualizar: Haz clic en el icono de actualización. o la palabra Refresh para regenerar esquemas desde el extremo JWT. Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al esquema, como en una transformación adyacente.

  • Atrás: Haga clic para guardar temporalmente la configuración de este paso y regresar al paso anterior.

  • Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad JWT Generar token, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de la operación, lo que incluye la posibilidad de encadenar operaciones que se encuentren en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para más detalles, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades JWT Generar token se pueden usar como objetivo con estos patrones de operación:

Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.

Cuando esté listo, desplegar y ejecutar la operación y validar el comportamiento comprobando los registros de operación.