Advanced Flow for Microsoft Graph Connector for ServiceNow Knowledge

Si la instancia de ServiceNow usa scripts avanzados en la base de conocimiento o en los criterios de usuario de nivel de artículo, deberá usar el flujo avanzado . Esto garantiza un control preciso de permisos al ingerir contenido en Microsoft Graph.

Paso 1: Seleccionar flujo avanzado en el programa de instalación

Al configurar el conector de Microsoft Graph para ServiceNow Knowledge, seleccione la opción Avanzadas en el campo "Seleccionar según los criterios de usuario configurados en ServiceNow". Esto es fundamental para controlar correctamente los criterios avanzados del usuario.

Paso 2: Configuración de la API REST con script en ServiceNow

Para permitir que el conector recupere criterios de usuario avanzados, debe crear una API REST con script en la instancia de ServiceNow. Siga estos pasos.

2.1: Elevar el rol de usuario

1. Eleve el rol de ServiceNow a security_admin.

2.2: Crear Access Control (ACL)

1. En ServiceNow, vaya a Todos los > Access Control de seguridad > del sistema (ACL).
2. Haga clic en Nuevo para crear una nueva ACL.
3. Establezca los siguientes valores:
   • Tipo: REST_Endpoint
   • Operación: Execute
   • Nombre: Microsoft Copilot
   • Rol: admin(o el mismo rol asignado a la cuenta de rastreo)
4. Haga clic en Enviar.

2.3: Creación de una API REST con script

1. Vaya a Todas las API REST con script de servicios > web con script de Servicios >> web del sistema.

2. Haga clic en Nuevo.

3. Especifique lo siguiente:

   • Nombre: Microsoft Copilot
   • Identificador de API: microsoft_copilot

4. Haga clic en Enviar.

5. En la página de lista API REST con script, haga clic en Microsoft Copilot : la API REST que acaba de crear.

6. Establezca las ACL predeterminadas en Microsoft Copilot (del paso 2.2).

2.4: Agregar un recurso a la API

1. En la pestaña Recursos , haga clic en Nuevo.
2. Rellene los detalles:
   • Nombre: GetAllUserCriteria
   • Ruta de acceso relativa: /user_criteria
   • Script: pegue el código siguiente:

(function execute (/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {
    var queryParams = request.queryParams;
    var user = new String(queryParams.user);
    return (new sn_uc.UserCriteriaLoader()).getAllUserCriteria(user);
})(request, response);

3. Asegúrese de que están activadas las dos opciones siguientes:

   • Requiere autenticación
   • Requiere autorización de ACL

4. Asegúrese de que las ACL están establecidas en Microsoft Copilot.

5. Haga clic en Actualizar.

2.5: Comprobar el programa de instalación

1. Confirme que la ruta de acceso del recurso es:

   /api/<API Namespace>/microsoft_copilot/user_criteria
   

2. Haga clic en Actualizar para guardar la configuración.

Paso 3: Escriba el espacio de nombres de la API en la experiencia de instalación del conector de Graph.

En la configuración del conector de Microsoft Graph, escriba el espacio de nombres de API que creó en ServiceNow.

Nota:

Puede encontrar el espacio de nombres de API en el campo Ruta de acceso de recursos que se muestra en el paso 2.5. Solo necesita la parte del espacio de nombres, no la ruta de acceso completa.

Por ejemplo: si la ruta de acceso del recurso es /api/abcdef/microsoft_copilot/user_criteria, el espacio de nombres de la API es abcdef.