Configure y utilice las aplicaciones OAuth 2 personalizadas de su organización mediante el flujo JWT
Para integrarse con Workfront y permitir que la aplicación cliente se comunique con Workfront en nombre del usuario, debe:
- Creación de una aplicación OAuth2
- Crear un certificado de clave pública
- Creación de un token web JSON (JWT)
Crear una aplicación OAuth2
Para obtener instrucciones sobre cómo crear la aplicación OAuth2, consulte Crear una aplicación OAuth2 mediante la autenticación de servidor (flujo JWT) en Crear aplicaciones OAuth2 para integraciones de Workfront
Crear un certificado de clave pública
El JWT debe estar firmado y codificado en base 64 para su inclusión en la solicitud de acceso. Las bibliotecas JWT proporcionan funciones para realizar estas tareas.
El token debe firmarse con la clave privada para un certificado de firma digital. Si lo hace, puede utilizar la clave privada de cualquier certificado asociado para firmar el JWT.
El algoritmo utilizado es RS256 (firma RSA con SHA-256). Se trata de un algoritmo asimétrico y utiliza un par de claves pública y privada. El proveedor de identidad tiene una clave privada (secreta) utilizada para generar la firma y el consumidor del JWT obtiene una clave pública para validar la firma.
Para generar la clave pública, siga uno de estos pasos.
-
Abra el terminal de MacOS/Linux, ejecute el siguiente comando y cargue
certificate_pub.crtcon el botón Agregar clave pública en la configuración de la aplicación OAuth2 en Workfront.code language-none openssl req -x509 -sha256 -nodes -newkey rsa:2048 -keyout private.key -out certificate_pub.crt -
Use el botón Generar un par de claves pública y privada en la configuración de la aplicación OAuth2 en Workfront para generar RSA.
Creación de un token web JSON
Un token web JSON para la autenticación de cuenta de servicio requiere un conjunto particular de notificaciones y debe firmarse con un certificado de firma digital válido. Le recomendamos que utilice una de las bibliotecas o herramientas disponibles públicamente para crear su JWT.
La siguiente tabla contiene información sobre los campos que pueden ser necesarios al configurar el token JWT.
Intercambie el JWT para recuperar un token de acceso
-
Envíe una solicitud de POST a:
code language-none https://yourdomain.my.workfront.com/integrations/oauth2/api/v1/jwt/exchange -
El cuerpo de la solicitud debe contener parámetros con codificación URL con el ID del cliente, el secreto del cliente y JWT:
code language-none client_id={client_id_value}&client_secret={client_secret_value}&jwt_token={base64_encoded_JWT}