DocumentaciónWorkfrontGuía de Workfront

HTTP > Realizar una solicitud OAuth 2.0 módulo

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Usuario
NOTE
Adobe Workfront Fusion requiere una licencia Adobe Workfront Fusion además de una licencia Adobe Workfront.

Para realizar una solicitud HTTP(S) Adobe Workfront Fusion a servidores que requieran una autorización de OAuth 2.0, primero debe crear una conexión OAuth. Adobe Workfront Fusion garantiza que todas las llamadas realizadas con esta conexión tengan los encabezados de autorización adecuados y que actualicen automáticamente los tokens asociados cuando sea necesario.

Workfront Fusion admite los siguientes flujos de autenticación de OAuth 2.0:

  • Flujo de código de autorización
  • Flujo implícito

Otros flujos, como el flujo de credenciales de contraseña de propietario de recursos y el flujo de credenciales de cliente, no se admiten automáticamente a través de este módulo.

Para obtener más información sobre la autenticación de OAuth 2.0, consulte El marco de autorización de OAuth 2.0.

NOTE
Si se está conectando a un producto de Adobe que actualmente no tiene un conector dedicado, le recomendamos que utilice el módulo de Adobe Authenticator.
Para obtener más información, consulte módulo de Adobe Authenticator.

Requisitos de acceso

Debe tener el siguiente acceso para utilizar la funcionalidad de este artículo:

Adobe Workfront plan*
Pro o superior
Adobe Workfront licencia*
Plan, Trabajo
Adobe Workfront Fusion licencia**

Requisito de licencia actual: no se requiere licencia de Workfront Fusion.

O

Requisito de licencia heredado: Workfront Fusion para automatización e integración de trabajo

Producto

Requisito de producto actual: si tiene el plan Select o Prime Adobe Workfront, su organización debe adquirir Adobe Workfront Fusion así como Adobe Workfront para utilizar la funcionalidad descrita en este artículo. Workfront Fusion está incluido en el plan Workfront de Ultimate.

O

Requisito de productos heredados: su organización debe comprar Adobe Workfront Fusion y Adobe Workfront para utilizar la funcionalidad descrita en este artículo.

Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.

Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias

Creando una conexión para una solicitud OAuth

Instrucciones generales para crear una conexión en el módulo HTTP > Realizar una solicitud OAuth 2.0

  1. Cree un cliente OAuth en el servicio target con el que desea que Adobe Workfront Fusion se comunique. Es muy probable que esta opción se encuentre en la sección Desarrollador del servicio proporcionado.

    1. Al crear un cliente, ingrese la dirección URL correspondiente en el campo Redirect URL o Callback URL:

      table 0-row-2 1-row-2
      América/APAC https://app.workfrontfusion.com/oauth/cb/oauth2
      EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2

    2. Después de crear el cliente, el servicio dado muestra 2 claves: Client ID y Client Secret. Algunos servicios llaman a estos App Key y App Secret . Guarde la clave y el secreto en una ubicación segura, de modo que pueda proporcionarlos al crear la conexión en Workfront Fusion.

  2. Busque Authorize URI y Token URI en la documentación de API del servicio proporcionado. Son direcciones URL a través de las cuales Workfront Fusion se comunica con el servicio target. Las direcciones sirven para la autorización de OAuth.

    note note
    NOTE
    Si el servicio utiliza un flujo implícito, solo necesitará el Authorize URI.
    note info
    INFO
    Ejemplo: Direcciones de Yahoo:
    • URI autorizado:
    https://api.login.yahoo.com/oauth2/request_auth
    • URI de token:
    https://api.login.yahoo.com/oauth2/get_token

  3. (Condicional) Si el servicio de destino utiliza ámbitos (derechos de acceso), compruebe cómo el servicio separa los ámbitos individuales y asegúrese de establecer el separador en la configuración avanzada en consecuencia. Si el separador no está configurado correctamente, Workfront Fusion no consigue crear la conexión y recibe un error de ámbito no válido.

  4. Después de completar los pasos anteriores, puede empezar a crear la conexión OAuth en Workfront Fusion. Añada el módulo de procesamiento de respuestas y solicitudes HTTP(S) de OAuth 2.0 a su escenario.

  5. En el campo Conexión del módulo, haga clic en Agregar.

  6. Rellene los campos siguientes para crear una conexión:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 layout-auto html-authored no-header
    Nombre de conexión Introduzca el nombre de la conexión.
    Tipo de flujo

    Seleccione el flujo para obtener tokens.

    • Código de autorización: escriba Authorize URI y Token URI desde la documentación de API del servicio.
    • Implicit: escriba Authorize URI desde la documentación de API del servicio.
    Ámbito Agregar ámbitos individuales. Puede encontrar esta información en la documentación para desarrolladores (API) de un servicio determinado.
    Separador de ámbitos

    Seleccione por qué se deben separar los ámbitos especificados anteriormente. Puede encontrar esta información en la documentación para desarrolladores (API) de un servicio determinado.

    Advertencia: si el separador no está configurado correctamente, Workfront Fusion no crea la conexión y recibe un error de ámbito no válido.
    ID de cliente Introduzca el ID de cliente. Obtuvo el ID de cliente al crear un cliente de OAuth en el servicio al que desea conectarse.
    Secreto de cliente Introduzca el Secreto del cliente. Obtuvo el Secreto del cliente al crear un cliente de OAuth en el servicio que desea conectar.
    Autorizar parámetros

    Agregue los parámetros que desee incluir en la llamada de autorización. Los siguientes parámetros estándar siempre se incluyen automáticamente y no es necesario añadirlos.

    Parámetros estándar:

    • response_type

      code para Flujo de código de autorización y token para Flujo implícito

    • redirect_uri

      table 0-row-2 1-row-2 layout-auto html-authored no-header
      América/APAC https://app.workfrontfusion.com/oauth/cb/oauth2
      EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2

    • client_id

      El ID de cliente que recibió al crear la cuenta
    Parámetros de token de acceso

    Añada cualquier parámetro que desee incluir en la llamada de token. Los siguientes parámetros estándar siempre se incluyen automáticamente y no es necesario añadirlos.

    Parámetros estándar:

    • grant_type: authorization_code

    • redirect_uri:

      table 0-row-2 1-row-2 layout-auto html-authored no-header
      América/APAC https://app.workfrontfusion.com/oauth/cb/oauth2
      EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2

    • client_id: El identificador de cliente que recibió al crear la cuenta se incluye automáticamente en el cuerpo de la solicitud

    • client_secret: El secreto de cliente que recibió al crear la cuenta se incluye automáticamente en el cuerpo de la solicitud

    • code: código devuelto por la solicitud de autorización

    Nota:

    El estándar OAuth 2.0 admite al menos 2 métodos de autenticación de cliente durante este paso (client_secret_basic y client_secret_post). Workfront Fusion envía automáticamente el secreto y el identificador de cliente especificados a través del método client_secret_post. Por lo tanto, estos parámetros se incluyen automáticamente como parte del cuerpo de solicitud de token.

    Para obtener más información sobre la autenticación de OAuth 2.0, consulte El marco de autorización de OAuth 2.0.
    Actualizar parámetros de token

    Añada cualquier parámetro que desee incluir en la llamada de token. Los siguientes parámetros estándar siempre se incluyen automáticamente y no es necesario añadirlos.

    Parámetros estándar:

    • grant_type: refresh_token

    • refresh_token: El token de actualización más reciente obtenido por el servicio al que se está conectando

    • client_id: El identificador de cliente que recibió al crear la cuenta se incluye automáticamente en el cuerpo de la solicitud

    • client_secret: El secreto de cliente que recibió al crear la cuenta se incluye automáticamente en el cuerpo de la solicitud

    Nota:

    El estándar OAuth 2.0 admite al menos 2 métodos de autenticación de cliente durante este paso (client_secret_basic y client_secret_post). Workfront Fusion envía automáticamente el secreto y el identificador de cliente especificados a través del método client_secret_post. Por lo tanto, estos parámetros se incluyen automáticamente como parte del cuerpo de solicitud de token.

    Para obtener más información sobre la autenticación de OAuth 2.0, consulte El marco de autorización de OAuth 2.0.
    Encabezados personalizados

    Especifique las claves y los valores adicionales que se incluirán en el encabezado de los pasos de Token y RToken de actualización.

    Nota:

    El estándar OAuth 2.0 admite al menos 2 métodos de autenticación de cliente durante este paso (client_secret_basic y client_secret_post). Workfront Fusion no admite automáticamente el método client_secret_basic. Si el servicio al que se está conectando espera que el ID de cliente y el Secreto del cliente se combinen en una sola cadena y luego se codifique base64 en el encabezado Autorización, debe agregar ese encabezado y valor clave aquí.

    Para obtener más información sobre la autenticación de OAuth 2.0, consulte El marco de autorización de OAuth 2.0.
    Colocación del token

    Seleccione si desea enviar el token en encabezado, cadena de consulta o en ambos al conectarse a la dirección URL especificada.

    Normalmente, los tokens se envían en el encabezado de la solicitud.
    Nombre de token de encabezado Introduzca el nombre del token de autorización en el encabezado. Predeterminado: Bearer.
    Query string parameter name Introduzca el nombre del token de autorización en la cadena de consulta. Predeterminado: access_token.

  7. Haga clic en Continuar para guardar la configuración de conexión.

  8. Continuar con la configuración del módulo de solicitud OAuth 2.0.

Instrucciones para crear una conexión con Google en el HTTP >Crear un módulo de solicitud OAuth 2.0

El siguiente ejemplo muestra cómo usar el módulo de solicitud HTTP > Hacer que un módulo de solicitud OAuth 2.0 se conecte a Google.

  1. Asegúrese de haber creado un proyecto, configurado la configuración de OAuth y generado sus credenciales tal como se describe en Conectar Adobe Workfront Fusion a Google Services mediante un cliente de OAuth personalizado.

  2. Abra el módulo HTTP >Realizar una solicitud OAuth 2.0.

  3. Haga clic en Agregar junto al cuadro de conexión.

  4. Introduzca los siguientes valores:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto html-authored no-header
    Nombre de conexión Introduzca el nombre de la conexión.
    Tipo de flujo Código de autorización
    Autorizar URI https://accounts.google.com/o/oauth2/v2/auth
    Token URI https://www.googleapis.com/oauth2/v4/token
    Ámbito Agregar ámbitos individuales. Para obtener más información sobre los ámbitos, consulte Ámbitos de OAuth 2.O para las API Google en la documentación de Google.
    Separador de ámbitos ESPACIO
    ID de cliente

    Escriba su ID de cliente Google.

    Para crear un ID de cliente, consulte Crear credenciales de OAuth en Connect Adobe Workfront Fusion para Google Services mediante un cliente de OAuth personalizado.
    Secreto de cliente

    Escriba el secreto de cliente de Google.

    Para crear un secreto de cliente, consulte Crear credenciales de OAuth en Connect Adobe Workfront Fusion para Google servicios mediante un cliente de OAuth personalizado.
    Autorizar parámetros

    Agregar access_type - offline par clave-valor.

    Nota: Si tiene problemas de autenticación, por ejemplo, al actualizar el token, intente agregar el par clave-valor prompt - consent 1.

  5. Haga clic en Continuar para guardar la configuración de conexión.

  6. Continuar con la configuración del módulo de solicitud OAuth 2.0.

Instrucciones para conectarse a Microsoft Graph API a través del módulo HTTP > Realizar una solicitud OAuth 2.0

Para obtener instrucciones acerca de Microsoft Graph API, consulte Llamar a MS Graph REST API a través de Adobe Workfront Fusion HTTP > Realizar una solicitud OAuth 2.0 módulo.

Configuración del módulo de solicitud OAuth 2.0

Cuando haya establecido una conexión Oauth 2.0 como se describe en Creación de una conexión para una OAuth solicitud, continúe configurando el módulo como desee. Todos los tokens de autorización se incluyen automáticamente en esta solicitud y en cualquier otra solicitud que utilice la misma conexión.

Al configurar el módulo HTTP >Realizar una solicitud OAuth 2.0, Workfront Fusion muestra los campos que se indican a continuación. Un título en negrita en un módulo indica un campo obligatorio.

Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro en Adobe Workfront Fusion.

Conexión
Para obtener información sobre cómo configurar una conexión, consulte Creación de una conexión para una solicitud de OAuth en este artículo.
Evaluar todos los estados como errores (excepto 2xx y 3xx)

Utilice esta opción para configurar la gestión de errores.

Para obtener más información, vea Control de errores en Adobe Workfront Fusion.

URL
Introduzca la dirección URL a la que desea enviar una solicitud, como un punto final de API, un sitio web, etc.
Método
Seleccione el método de solicitud HTTP que necesita para configurar la llamada de API. Para obtener más información, vea Métodos de solicitud HTTP en Adobe Workfront Fusion.
Encabezados
Añada los encabezados de la solicitud en forma de objeto JSON estándar. Por ejemplo, {"Content-type":"application/json"}
Cadena de consulta
Introduzca los pares de clave-valor de consulta deseados.
Tipo de cuerpo

El cuerpo HTTP son los bytes de datos transmitidos en un mensaje de transacción HTTP inmediatamente después de los encabezados si hay alguno que utilizar.

  • RAW

    El tipo de cuerpo sin procesar suele ser adecuado para la mayoría de las solicitudes de cuerpo HTTP incluso en situaciones en las que la documentación para desarrolladores no especifica datos para enviar.

    Especifique una forma de analizar los datos en el campo Content type.

    A pesar del tipo de contenido seleccionado, los datos se introducen en cualquier formato estipulado o requerido por la documentación del desarrollador.

  • Application/x-www-form-urlencoded

    Este tipo de cuerpo es para almacenar en POST datos usando application/x-www-form-urlencoded.

    Para application/x-www-form-urlencoded, el cuerpo del mensaje HTTP enviado al servidor es esencialmente una cadena de consulta. Las claves y los valores se codifican en pares clave-valor separados por & y con un = entre la clave y el valor.

    Para datos binarios, use multipart/form-data en su lugar.

    Ejemplo:

    Ejemplo del formato de solicitud HTTP resultante:

    field1=value1&field2=value2

  • Multipart/form-data

    Multipart/form-data es una solicitud HTTP multipart que se utiliza para enviar archivos y datos. Normalmente se utiliza para cargar archivos en el servidor.

    Añada campos para enviarlos en la solicitud. Cada campo debe contener un par clave-valor.

    • Texto

      Introduzca la clave y el valor que se enviarán dentro del cuerpo de la solicitud.

    • Archivo

      Introduzca la clave y especifique el archivo de origen que desea enviar en el cuerpo de la solicitud.

      Asigne el archivo que desea cargar desde el módulo anterior (como HTTP >Obtener un archivo o Google Drive >Descargar un archivo), o bien introduzca el nombre de archivo y los datos de archivo manualmente.

Respuesta de análisis

Active esta opción para analizar automáticamente las respuestas y convertir las respuestas JSON y XML, de modo que no necesite utilizar los módulos JSON > Parse JSON o XML > Parse XML.

Antes de poder utilizar contenido JSON o XML analizado, ejecute el módulo una vez manualmente para que el módulo pueda reconocer el contenido de la respuesta y le permita asignarlo en módulos posteriores.

Tiempo de espera
Introduzca el tiempo de espera de la solicitud en segundos (1-300). El valor predeterminado es 40 segundos.
Compartir cookies con otros módulos HTTP
Active esta opción para compartir cookies del servidor con todos los módulos HTTP de su escenario.
Certificado autofirmado
Cargue el certificado si desea utilizar TLS con el certificado autofirmado.
Rechazar conexiones que utilizan certificados no verificados (autofirmados)
Active esta opción para rechazar conexiones que utilicen certificados TLS no verificados.
Seguir redirección
Active esta opción para seguir las redirecciones de URL con respuestas 3xx.
Seguir todas las redirecciones
Active esta opción para seguir las redirecciones URL con todos los códigos de respuesta.
Deshabilitar la serialización de varias claves de cadena de consulta iguales que matrices
De manera predeterminada, Workfront Fusion administra varios valores para la misma clave de parámetro de cadena de consulta de URL que las matrices. Por ejemplo, www.test.com?foo=bar&foo=baz se convertirá en www.test.com?foo[0]=bar&foo[1]=baz. Active esta opción para deshabilitar esta función.
Solicitar contenido comprimido

Active esta opción para solicitar una versión comprimida del sitio web.

Esto agrega un encabezado Accept-Encoding para solicitar contenido comprimido.

Utilizar TLS mutuo

Active esta opción para utilizar TLS mutuo en la solicitud HTTP.

Para obtener más información sobre TLS mutuo, consulte Usar TLS mutuo en módulos HTTP en Adobe Workfront Fusion.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43