HTTP > Make an OAuth 2.0 request módulo
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.
Requisitos de acceso
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:
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 de solicitud HTTP > Crear una OAuth 2.0
- Instrucciones para crear una conexión con Google en el módulo de solicitud HTTP >Make y OAuth 2.0
- Instrucciones para conectarse a la API de Microsoft Graph mediante el módulo de solicitud HTTP > Crear una OAuth 2.0
Instrucciones generales para crear una conexión en el módulo HTTP > Make an OAuth 2.0 request
-
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.
-
Al crear un cliente, introduzca la dirección URL correspondiente en el campo
Redirect URL
oCallback 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
-
Después de crear el cliente, el servicio dado muestra 2 claves:
Client ID
yClient Secret
. Algunos servicios llaman a estosApp Key
yApp Secret
. Guarde la clave y el secreto en una ubicación segura, para que pueda proporcionarlos al crear la conexión en Workfront Fusion.
-
-
Busque
Authorize URI
yToken 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
. -
(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.
-
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.
-
En el campo Conexión del módulo, haga clic en Add.
-
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
yToken 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 ytoken
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
yclient_secret_post
). Workfront Fusion envía automáticamente el secreto y el ID de cliente especificados a través del métodoclient_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
yclient_secret_post
). Workfront Fusion envía automáticamente el secreto y el ID de cliente especificados a través del métodoclient_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
yclient_secret_post
). Workfront Fusion no admite automáticamente el métodoclient_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
. - Authorization Code: escriba
-
Haga clic en Continue para guardar la conexión y volver al módulo.
-
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.
-
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.
-
Abra el módulo HTTP > Make an OAuth 2.0 request.
-
Haga clic en Add junto al cuadro de conexión.
-
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
. -
Haga clic Continue para guardar la configuración de conexión.
-
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.