Llamar a la API de REST de MS Graph
Se accede a muchos servicios web de Microsoft a través de la API de Microsoft Graph. Puede crear una conexión a la API de Microsoft Graph con el módulo de solicitud Workfront Fusion HTTP > Crear una 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: cualquiera |
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 las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.
Registre Workfront Fusion en el portal de registro de aplicaciones de Microsoft
Para crear una conexión a la API de REST de Microsoft Graph, primero debe registrar Adobe Workfront Fusion.
-
Comience a registrar una nueva aplicación como se describe en Registre una aplicación con Microsoft identity platform en la documentación de Microsoft.
Como parte del registro, Microsoft requiere la siguiente información:
table 0-row-2 1-row-2 layout-auto html-authored no-header Nombre de aplicación Introduzca un nombre para la aplicación, como "Mi aplicación de Workfront Fusion". Dirección URL de redireccionamiento https://app.workfrontfusion.com/oauth/cb/oauth2
-
Cuando haya completado el registro de la aplicación, tome nota del ID de aplicación.
note important IMPORTANT Necesitará el ID de aplicación para configurar la conexión en Workfront Fusion. -
Genere un secreto de cliente. Anote este secreto.
Para obtener instrucciones, consulte Registrar una aplicación con Microsoft identity platform en la documentación de Microsoft.
note important IMPORTANT Necesitará el Secreto del cliente para configurar su conexión en Workfront Fusion. -
Configure los permisos para su aplicación.
Para obtener información específica sobre cómo localizar y configurar estos campos, consulte la sección "Configuración de permisos para Microsoft Graph" en Obtener acceso sin un usuario en la documentación de Microsoft.
table 0-row-2 1-row-2 layout-auto html-authored no-header ¿Qué tipo de permisos requiere su aplicación? Seleccione Delegated permissions
.Seleccionar permisos Seleccione los siguientes permisos:
-
offline_access
-
openid
-
Cualquier otro permiso requerido por sus integraciones (Ejemplo:
User.Read
)
Importante: Necesitará los permisos seleccionados para configurar su conexión en Workfront Fusion.
-
-
Continúe con Configuración de la conexión de la API de MS Graph en Workfront Fusion.
Configuración de la conexión de la API de MS Graph en Workfront Fusion
Después de registrar Workfront Fusion como se describe en Registrar Workfront Fusion en el portal de registro de aplicaciones de Microsoft, puede configurar la conexión en el módulo de solicitud HTTP > Crear una Oauth 2.0.
-
Añada un módulo de llamada HTTP > Crear un módulo de llamada OAuth 2.0 a su escenario.
-
Haga clic en Agregar junto al campo de conexión.
-
Configure los campos de conexión de la siguiente manera:
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 layout-auto html-authored no-header Nombre de conexión Introduzca un nombre para la conexión. Entorno Seleccione si desea conectarse a una cuenta de producción o de no producción. Tipo Seleccione si desea conectarse a una cuenta de servicio o a una personal. Tipo de flujo Seleccione Authorization Code
.Autorizar URI Escriba https://login.microsoftonline.com/common/oauth2/v2.0/authorize
.URI de token Escriba https://login.microsoftonline.com/common/oauth2/v2.0/token
.Ámbito Escriba los permisos que seleccionó al registrarse, como se describe en Registrar Workfront Fusion en el portal de registro de aplicaciones de Microsoft.
Para cada ámbito, haga clic en Agregar y escriba el permiso.
Ejemplo:
offline_access
.Separador de ámbito Seleccione SPACE
.Id. de cliente Introduzca el ID de aplicación del paso 2 en Registre Workfront Fusion en el portal de registro de aplicaciones de Microsoft. Secreto de cliente Escriba el Secreto de cliente que generó en el paso 3 de Registrar Workfront Fusion en el Portal de registro de aplicaciones de Microsoft. Autorizar parámetros Añada los siguientes parámetros Authorize. Para cada parámetro que esté agregando, haga clic en Agregar elemento e introduzca lo siguiente:
-
Clave:
response_mode
Valor:query
-
Clave:
prompt
Valor:consent
Parámetros de token de acceso No es necesario que introduzca nada en este campo. Actualizar parámetros de token -
Haga clic en Agregar elemento.
-
En el campo Clave, escriba
scope
. -
En el campo Valor, escriba todos los ámbitos especificados en el campo de ámbito, separados por espacios.
Ejemplo:
offline_access openid User.Read
Encabezados personalizados No es necesario que introduzca nada en este campo. Ubicación del token In the header
-
-
Haga clic en Continuar.
-
En la ventana que aparece, haga clic en Aceptar para completar la conexión y volver al módulo.