Autenticación de Box

Conecta UiPath a Box en Automation Suite utilizando OAuth 2.0 u otros tipos de autenticación compatibles, configurando el URI de redireccionamiento requerido en tu aplicació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
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

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://{yourDomain}/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 BYO OAuth
   • 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://{yourDomain}/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.

Añadir la conexión de Box

1. Selecciona Integration Service en la barra izquierda.
2. En la lista Conectores , selecciona Box. También puedes utilizar la barra de búsqueda para acotar el conector.
3. Selecciona Conectar a Box.
4. Ahora se te dirige a la página de conexión.
5. Introduce las credenciales necesarias.
6. Select Connect.

Permisos

Las cuentas deben estar habilitadas para acceder o conectarse a Box. Si no es así, ponte en contacto con tu administrador y solicita el acceso necesario.

Con acceso a tu cuenta de Box, UiPath para Box puede hacer lo siguiente:

• Leer todos los archivos y carpetas almacenados en Box
• Leer y escribir todos los archivos y carpetas almacenados en Box
• Gestionar grupos
• Administrar propiedades empresariales
• Gestionar las políticas de retención
• Habilitar integraciones
• Gestionar solicitudes de firma
• Administrar usuarios de la aplicación
• Administrar usuarios
• Generar solicitudes facturables de Box Sign.

Para obtener más información, consulta la documentación de autenticación de Box.