Autenticación de Box

UiPath admite los siguientes tipos de autenticación para Box. Para obtener más información, consulta la documentación de autenticación de Box.

Tipo de Autenticación	Descripción	Ideal para
Código de autorización OAuth 2.0	El usuario inicia sesión a través de Box y otorga acceso a la API.	Acceso de usuario individual (automatización atendida o personal).
Credenciales de cliente OAuth 2.0	Autenticación no interactiva de servicio a servicio.	Acceso de servicio a servicio dentro del espacio de trabajo del usuario.
Traiga su propia aplicación OAuth 2.0	Utiliza tu propia aplicación OAuth con la URL de devolución de llamada de UiPath.	Clientes que gestionan su propia aplicación y claves de Box.
Token de acceso personal (PAT)	Utiliza una clave privada de Box JWT y un ID de empresa/usuario.	Integraciones de nivel empresarial de servidor a servidor que requieren acceso solo a la aplicación o a toda la empresa sin interacción del usuario.

Detalles de los tipos de autenticación

Código de autorización OAuth 2.0

Campo	Descripción
Clave API OAuth	ID de cliente de Box .
Secreto de la API OAuth	Secreto de cliente de Box .
Ámbito	Selecciona los ámbitos configurados en tu aplicación de Box.

Credenciales de cliente OAuth 2.0

Campo	Descripción
Clave API OAuth	ID de cliente de Box.
Secreto de la API OAuth	Secreto de cliente de Box.
Tipo de asunto	"Enterprise" o "User"
ID de empresa/ID de usuario	ID de empresa de Box o ID de usuario de Box.
Ámbito	Debe coincidir con los ámbitos configurados en Box.

Traiga su propia aplicación OAuth 2.0

Campo	Descripción
Clave API OAuth	ID de cliente de Box.
Secreto de la API OAuth	Secreto de cliente de Box.
Ámbito	Ámbitos de Box predefinidos o personalizados.

Importante:

Configura este URI de redirección en tu aplicación de Box: https://{baseURL}/provisioning_/callback (por ejemplo, https://cloud.uipath.com/provisioning_/callback).

Token de acceso personal (PAT)

Campo	Descripción
Clave API OAuth	ID de cliente de Box de la Consola de desarrollador de Box.
Secreto de la API OAuth	Secreto de cliente de Box desde la Consola de desarrollador de Box.
Ámbito	Ámbitos seleccionados en Box y necesarios para la automatización.
Audiencia de JWT	Ejemplo: https://api.box.com/oauth2/token
Clave codificada JWT en formato Base64	La clave privada codificada en Base64 de la aplicación de Box de la configuración de la aplicación JWT.
Emisor JWT	El ID de cliente de la aplicación Box, utilizado como reclamación JWT iss .
Subtipo JWT	Debe ser empresa o usuario según el destino de suplantación deseado.
Asunto JWT	El ID de empresa (si el subtipo = empresa) o el ID de usuario (si el subtipo = usuario).

Crear una aplicación de Box

Antes de conectar UiPath a Box, debes crear una aplicación en la Consola de desarrollador de Box. Para obtener más información, consulta la Documentación de Box Developer.

1. Abrir consola de desarrollador
2. Selecciona Crear nueva aplicación
3. Elige uno de los siguientes dependiendo de tu tipo de autenticación previsto:
   • OAuth 2.0 (autenticación de usuario) → utilizado para el código de autorización y BYO OAuth
   • OAuth 2.0 con credenciales de cliente → utilizado para flujos de credenciales de cliente
   • OAuth 2.0 con JWT → utilizado para PAT en UiPath IS

Después de crear la aplicación Box, recopila:

• ID de cliente
• Secreto de cliente
• Ámbitos de la aplicación
• Clave privada (solo aplicaciones JWT)
• ID de empresa/usuario

Importante:

Para la aplicación Trae tu propia aplicación OAuth 2.0, añade la URL de devolución de llamada de UiPath a tu aplicación de Box: https://{baseURL}/provisioning_/callback (por ejemplo, https://cloud.uipath.com/provisioning_/callback).

Comprender los ámbitos de Box

Box requiere una selección de permisos explícitos conocida como "ámbitos". La siguiente tabla enumera los ámbitos predefinidos comunes para las aplicaciones de Box.

Ámbito	Descripción
sololectura_raíz	Acceso de solo lectura a todo el contenido al que puede acceder el usuario o la cuenta.
lectura_raíz	Acceso completo de lectura/escritura a archivos y carpetas.
Gestionar_grupos	Administrar grupos de Box.
gestionar_propiedades_empresariales	Gestionar metadatos y propiedades empresariales.
gestionar_retención_de_datos	Configura políticas de retención y retenciones legales.
sign_requests.readwrite	Crear y gestionar solicitudes de Box Sign.
gestionar_usuarios_aplicación	Gestionar usuarios de la aplicación.
gestionar_usuarios_gestionados	Administrar usuarios administrados por la empresa.

Tu Box Developer Console debe reflejar los mismos ámbitos que seleccionaste al crear la conexión. Para obtener más información sobre los ámbitos, consulta la documentación de Ámbitos en Box.

Cómo preparar la clave privada de Box

Paso 1: Descarga la clave privada

Descarga el archivo JSON de la aplicación Box que contiene la clave_privada_cifrada y la frase de contraseña.

Paso 2: Descifrar utilizando la frase de contraseña

Si la clave está cifrada, descifrarla:

openssl pkcs8 -inform PEM -in private_key.pem -out decrypted_key.pem -passin pass:YOUR_PASSPHRASE

Esto produce lo siguiente:

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----

Paso 3: Eliminar encabezados/pies de página de PEM

Elimina estas dos líneas por completo:

-----BEGIN PRIVATE KEY-----
-----END PRIVATE KEY-----

Paso 4: Eliminar todas las nuevas líneas y espacios en blanco

Convierte la clave en una sola línea continua, sin espacios ni saltos de línea.

Ejemplo de resultado: MIIG/wIBADANBgkqhkiG9w0BAQEFAASCBK...

Paso 5: Codificar en Base64 la clave limpia

Codifica la clave de una sola línea:

Linux/macOS: echo -n "CLEANED_KEY" | base64

PowerShell: [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("CLEANED_KEY"))

Pega la salida Base64 resultante en: JWT Base64 Encoded Key. Para obtener más información, consulta la documentación de autenticación de Box.