HTTP > Make an OAuth 2.0 request módulo

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

Para realizar una petición 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 utilizar el módulo de Adobe Authenticator.
Para obtener más información, consulte Módulo de Adobe Authenticator.

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
paquete de Adobe Workfront Cualquiera
Licencia de Adobe Workfront

Nuevo: estándar

O

Actual: Trabajo o superior

Licencia de Adobe Workfront Fusion**

Actual: no se requiere licencia de Workfront Fusion.

O

Heredado: Workfront Fusion para la automatización e integración del trabajo

Producto

Nuevo:

  • Seleccione o paquete de Prime Workfront: su organización debe adquirir Adobe Workfront Fusion.
  • Paquete de Ultimate Workfront: Workfront Fusion está incluido.

O

Actual: Su organización debe adquirir Adobe Workfront Fusion.

Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación.

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

Crear una conexión para una solicitud OAuth

Instrucciones generales para crear una conexión en el módulo HTTP > Make an OAuth 2.0 request

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

    1. Al crear un cliente, introduzca 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, para 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.
  3. (Condicional) Si el servicio de destino utiliza ámbitos (derechos de acceso), compruebe cómo separa los ámbitos individuales y asegúrese de establecer el separador en los ajustes avanzados en consecuencia. Si el separador no se ha establecido correctamente, Workfront Fusion no consigue crear la conexión y se recibe un error de ámbito no válido.

  4. Después de completar los pasos anteriores, puede comenzar a crear la conexión OAuth en Workfront Fusion. Añada el módulo de solicitud HTTP > Crear un OAuth 2 a su escenario.

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

  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 17-row-2 18-row-2 layout-auto html-authored no-header
    Connection name Introduzca el nombre de la conexión.
    Environment Seleccione si está utilizando un entorno de producción o de no producción.
    Type Seleccione si utiliza una cuenta de servicio o una cuenta personal.
    Flow type

    Seleccione el flujo para obtener tókenes.

    • Authorization Code: escriba Authorize URI y Token URI desde la documentación de API del servicio.
    • Implicit: introduzca Authorize URI desde la documentación de API del servicio.
    Scope Añada ámbitos individuales. Puede encontrar esta información en la documentación para desarrolladores (API) de un servicio determinado.
    Scope separator

    Seleccione por qué se deben separarse 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 se establece correctamente, Workfront Fusion no crea la conexión y se recibe un error de ámbito no válido.

    Client ID Introduzca el ID de cliente. Ha obtenido el ID de cliente al crear un cliente de OAuth en el servicio al que desea conectarse.
    Client Secret Introduzca el secreto de cliente. Ha obtenido el secreto de cliente al crear un cliente de OAuth en el servicio al que desea conectarse.
    Authorize parameters

    Añada 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 Authorization Code flow 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

    Access token parameters

    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

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

    Refresh token parameters

    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 secreto y el ID 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.

    Custom Headers

    Especifique claves y valores adicionales para incluir en el encabezado de los pasos Token y Refresh Token.

    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 añadir 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.

    Token placement

    Seleccione si desea enviar el token en header, query string o en ambos al conectarse a la dirección URL especificada.

    Normalmente, los tokens se envían en el encabezado de la solicitud.

    Header token name 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 Continue para guardar la conexión y volver al módulo.

  8. Continúe con Configurar el módulo de solicitud Crear un OAuth 2.0.

Instrucciones para crear una conexión con Google en HTTP >Make an OAuth 2.0 request module

El siguiente ejemplo muestra cómo usar el módulo de solicitud HTTP > Make an OAuth 2.0 para conectarse 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 el artículoConectar Adobe Workfront Fusion a Google Services mediante un cliente de OAuth personalizado.

  2. Abra el módulo HTTP > Make an OAuth 2.0 request.

  3. Haga clic en Add 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 9-row-2 10-row-2 layout-auto html-authored no-header
    Connection name Introduzca un nombre para la conexión.
    Environment Seleccione si está utilizando un entorno de producción o de no producción.
    Type Seleccione si utiliza una cuenta de servicio o una cuenta personal.
    Flow type Authorization Code
    Authorize URI https://accounts.google.com/o/oauth2/v2/auth
    Token URI https://www.googleapis.com/oauth2/v4/token
    Scope Añada ámbitos individuales. Para obtener más información sobre los ámbitos, consulte Ámbitos de OAuth 2.O para las API de Google en la documentación de Google.
    Scope separator SPACE
    Client ID

    Introduzca su ID de cliente de Google.

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

    Client Secret

    Introduzca el secreto de cliente de Google.

    Para crear un secreto de cliente, consulte Crear credenciales de OAuth en el artículo Connect Adobe Workfront Fusion para Google servicios mediante un cliente de OAuth personalizado.

    Authorize parameters

    Añada el par clave-valor access_type - offline .

    Nota: Si tiene problemas para autenticarse, por ejemplo, al actualizar el token, intente añadir el par clave-valor prompt - consent .

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

  6. Continúe con Configurar el módulo de solicitud Crear un OAuth 2.0.

Configuración del módulo de solicitud Make a OAuth 2.0

Después de establecer una conexión OAuth 2.0, siga configurando el módulo como desee. Todos los tókenes de autorización se incluyen automáticamente en esta solicitud y en cualquier otra que utilice la misma conexión.

Al configurar el módulo HTTP > Make an OAuth 2.0 request, Workfront Fusion muestra los campos que se indican a continuación. El 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 Asignar información de un módulo a otro en Adobe Workfront Fusion.

Conmutador Asignar

Connection
Para obtener información sobre cómo configurar una conexión, consulte Crear una conexión para una solicitud de OAuth en este artículo.
Evaluate all states as errors (except for 2xx and 3xx)

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

Para obtener más información, consulte Control de errores.

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

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

  • Raw

    El tipo de cuerpo Raw es generalmente adecuado para la mayoría de las solicitudes de cuerpo HTTP, incluso en situaciones donde la documentación para desarrolladores no especifica los datos a 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 PUBLICAR datos que utilizan 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, se utiliza use multipart/form-data en su lugar.

    Ejemplo:

    Ejemplo del formato de petición HTTP resultante:

    field1=value1&field2=value2

  • Multipart/form-data

    Multipart/form-data es una solicitud HTTP de varias partes que se usa 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.

    • Text

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

    • File

      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 >Get a File) o ingrese el nombre de archivo y los datos de archivo manualmente.

Parse response

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

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

Timeout
Introduzca el tiempo de espera de la solicitud en segundos (1-300). El valor predeterminado es de 40 segundos.
Share cookies with other HTTP modules
Active esta opción para compartir cookies del servidor con todos los módulos HTTP de su escenario.
Self-signed certificate
Para usar un certificado autofirmado o una clave privada para TLS, haga clic en Extraer y proporcione el archivo y la contraseña del certificado o la clave privada.
Reject connections that are using unverified (self-signed) certificates
Active esta opción para rechazar conexiones que utilicen certificados TLS no verificados.
Follow redirect
Active esta opción para seguir las redirecciones de URL con respuestas 3xx.
Follow all redirects
Active esta opción para seguir las redirecciones URL con todos los códigos de respuesta.
Disable serialization of multiple same query string keys as arrays
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.
Request compressed content

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

Esto añade un encabezado Accept-Encoding para solicitar contenido comprimido.

Use Mutual TLS

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
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3