Actividad de Generación de Tokens JWT¶

Introducción¶

Una actividad Generar token de JWT, 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 Generar token de JWT 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 o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más detalles, consulte Creación de una instancia de actividad en Reutilización de componentes.

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

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).

Configurar una Actividad de Generación de Token JWT¶

Siga estos pasos para configurar una actividad Generar token de JWT:

• Paso 1: Ingrese un nombre y especifique la configuración
  Proporcione un nombre para la actividad y especifique el tipo de JWT, las configuraciones dependientes del tipo de JWT y las configuraciones opcionales.

• Paso 2: Revise los esquemas de datos
  Se muestran todos los esquemas de solicitud o respuesta.

Paso 1: Ingrese un Nombre y Especifique la Configuración¶

En este paso, proporcione un nombre para la actividad y especifique el tipo de JWT, las configuraciones dependientes del tipo de JWT y las configuraciones opcionales. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

• Nombre: Ingrese 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 usando una Firma web JSON (JWS) o cifrarlo usando JSON Web Encryption (JWE).

  Importante

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

  • 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 tipo de algoritmo de administración de claves Asimétrico:

        

        • 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:

        

        • Algoritmos de administración de claves simétricas: Uno de A128KW, A192KW o A256KW.
        • Clave secreta de cifrado: Ingrese una clave secreta.
        • Codificación 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:

        

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

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

        

        • Algoritmos de firma: Uno de HS256, HS384 o HS512.
        • Clave secreta: Ingrese una clave secreta.
        • Codificación 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:

  

  • 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 de 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 datos: El tipo de datos que representa el valor de un objeto de carga o encabezado. El tipo de datos 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: JSON Web Token (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 almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

• 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 solicitará que confirme que desea descartar los cambios.

Paso 2: Revisar los Esquemas de Datos¶

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

• Esquemas de datos: Estos esquemas de datos son heredados por las transformaciones adyacentes y se muestran nuevamente durante el mapeo de la 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: Haga clic en el icono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo de JWT. Esta acción también regenera un esquema en otras ubicaciones en todo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

• Atrás: Haga clic para almacenar 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 los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos Pasos¶

Después de configurar una actividad Generar token de JWT, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran 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 obtener más información, 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:

• Patrón de Transformación
• Patrón de dos transformaciones (como primer o segundo objetivo)

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 ejecute la operación y validar el comportamiento comprobando los registros de operación.