Contexto de la función

Las identidades, las coordenadas de la plataforma y los datos de solicitud que el runtime pasa a cada controlador de funciones JavaScript.

Cada controlador recibe un objeto de contexto como segundo argumento. Incluye quién llamó a la función, la propia identidad de la plataforma de la función y dónde enviar las llamadas de plataforma salientes, por lo que nada de eso tiene que pasarse como entrada.

handler: async (input, ctx) => {
  ctx.user?.accessToken     // the caller's OAuth token
  ctx.user?.sub             // the caller's user id
  ctx.robot?.accessToken    // the function's own platform token
  ctx.robot?.key            // the serverless robot key
  ctx.platform?.baseUrl     // e.g. "https://cloud.uipath.com"
  ctx.platform?.orgId       // organization id
  ctx.platform?.tenantId    // tenant id
  ctx.platform?.folderKey   // folder of the invocation, if any
  ctx.params                // path parameters, as strings
  ctx.headers               // request headers, lowercase keys
}

Dos identidades

Una función recibe dos identidades por invocación, y la elección entre ellas es una decisión de seguridad.

	ctx.user	ctx.robot
De quién es	La persona que invocó la función	La propia identidad de la plataforma de la función
Permisos que se aplican	La propia persona que llama	La cuenta de servicio de la función
Úsalo para	Actuar en nombre del usuario que ha iniciado sesión	Leyendo recursos a los que la persona que llama no debe acceder directamente

ctx.user.accessToken se aplica cuando la persona que llama solo debe ver lo que permiten sus propios permisos. ctx.robot.accessToken se aplica cuando la función debe llegar a algo que la persona que llama no puede: una credencial en una carpeta restringida, por ejemplo. Consulta Acceder a los servicios de la plataforma.

Nota:

ctx.robot es la identidad más privilegiada. Un controlador que lee cualquier nombre de recurso que llega en la solicitud actúa como adjunto de la solicitud de la persona que llama con los privilegios propios de la función. La recuperación debe estar restringida a un conjunto fijo en el código.

Coordenadas de la plataforma

ctx.platform proporciona baseUrl, orgId y tenantId para las llamadas de plataforma salientes. Estos provienen del runtime, nunca de la persona que llama, por lo que una solicitud no puede redirigir a dónde envía la función su tráfico, y nunca deben aceptarse como campos de entrada.

Es todo o nada: ctx.platform es null a menos que los tres estén disponibles. folderKey puede ser null por sí mismo, para una invocación sin carpeta.

Qué está disponible dónde

	Desencadenador HTTP	Trabajo	Local serve
ctx.user	La identidad de la persona que llama	Sin identidad de la persona que llama	Presente cuando la solicitud lleva un token al portador
ctx.robot	Sí	Sí	null
ctx.platform	Sí	Sí	Solo con UIPATH_BASE_URL, UIPATH_ORG_ID y UIPATH_TENANT_ID establecidos
ctx.params, ctx.headers	Sí	Vacío: no hay ninguna solicitud HTTP	Sí

Como ctx.robot es null localmente, el código que necesita un token de plataforma debe recurrir a una variable de entorno para el desarrollo local:

const token = ctx.robot?.accessToken || process.env["UIPATH_ACCESS_TOKEN"] || "";

Próximos pasos

• Acceder a los servicios de la plataforma
• Pruebas y depuración
• Referencia de contexto : el tipo completo y cada campo.