DocumentaciónWorkfrontGuía de Workfront

HTTP > Realizar una solicitud de OAuth 2.0 módulo

Last update: Fri Feb 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

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

Con el fin de hacer una Adobe Workfront Fusion Solicitud HTTP(S) a servidores que requieren una autorización 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 actualicen automáticamente los tokens asociados cuando sea necesario.

Workfront Fusion admite los siguientes flujos de autenticación 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 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 Workfront Fusion requisito de licencia.

O

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

Product

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

O

Requisito de productos heredados: su organización debe comprar Adobe Workfront Fusion así como 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 su Workfront administrador.

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

Creación de una conexión para una OAuth solicitud

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

  1. Cree un cliente de OAuth en target servicio con el que desea Adobe Workfront Fusion para comunicarse. Es muy probable que esta opción se encuentre en el Desarrollador del servicio dado.

    1. Al crear un cliente, introduzca la dirección URL adecuada en la Redirect URL o Callback URL campo:

      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 esto 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 el Authorize URI y Token URI en la documentación de API del servicio determinado. Son direcciones URL a través de las cuales Workfront Fusion se comunica con target servicio. 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 se puede 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 Connection del módulo, haga clic en Añadir.

  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: introduzca el Authorize URI y Token URI de la documentación de API del servicio.
    • Implícito: introduzca el Authorize URI de 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 se puede crear 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 el flujo de código de autorización de y token para Implicit flow

    • _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 ID 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

    • código: el 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 ID de cliente y el secreto especificados a través de client_secret_post método. 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 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 ID 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 ID de cliente y el secreto especificados a través de client_secret_post método. 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 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 client_secret_basic método. 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 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. Clic Continuar para guardar la configuración de conexión.

  8. Continuar a 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 utilizar el HTTP > Crear un OAuth 2.0 solicitar al módulo que se conecte Google.

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

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

  3. Clic Añadir situado 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 Google API en el Google documentación.
    Separador de ámbitos ESPACIO
    ID de cliente

    Introduzca su Google ID de cliente.

    Para crear un ID de cliente, consulte Crear credenciales de OAuth in Connect Adobe Workfront Fusion hasta Google Services uso de un cliente de OAuth personalizado.
    Secreto de cliente

    Introduzca su Google Secreto del cliente.

    Para crear un secreto de cliente, consulte Crear credenciales de OAuth in Connect Adobe Workfront Fusion hasta Google Servicios que utilizan un cliente de OAuth personalizado.
    Autorizar parámetros

    Añadir access_type - offline par clave-valor.

    Nota: Si tiene problemas de autenticación, por ejemplo, con la actualización de tokens, intente agregar la variable prompt - consent par clave-valor.

  5. Clic Continuar para guardar la configuración de conexión.

  6. Continuar a Configuración del módulo de solicitud OAuth 2.0.

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

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

Configuración del módulo de solicitud OAuth 2.0

Cuando haya establecido un Oauth 2Conexión .0 tal 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 la variable HTTP >Realizar una solicitud de OAuth 2.0 módulo, 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, consulte Asignación de información de un módulo a otro en Adobe Workfront Fusion.

Conexión
Para obtener información sobre la configuración de 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, consulte Tratamiento 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, consulte 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 los datos mediante 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 forma 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 añade un Accept-Encoding encabezado 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