Autenticación y ámbitos

Todos los comandos de la solución requieren autenticación a través de una aplicación externa configurada en Orchestrator. A diferencia de las tareas de proyecto independientes, las soluciones no admiten métodos de autenticación automáticos o interactivos.

Requisitos de autenticación

Los comandos de soluciones se autentican exclusivamente a través de OAuth2 con aplicaciones externas.

Debes configurar una aplicación externa en el administrador de Orchestrator con los ámbitos adecuados antes de ejecutar cualquier comando CLI de la solución.

Ámbitos OAuth necesarios

Las soluciones utilizan un conjunto dedicado de ámbitos de aplicación que difieren de los ámbitos estándar de Orchestrator. Configura tu aplicación externa con los siguientes ámbitos para todas las operaciones de la solución:

Formato de copiar y pegar para secretos de CI/CD:

AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write

Este formato de una sola línea, separado por espacios, puede utilizarse directamente en:

• Grupos de variables de Azure DevOps
• Secretos del repositorio de GitHub
• Almacén de credenciales de Jenkins

Nota: Las siguientes operaciones no requieren autenticación, ya que se ejecutan localmente:

• restore : restaura las dependencias localmente
• analyze : valida los proyectos localmente
• pack : crea paquetes localmente

Parámetros de autenticación comunes

Todos los comandos de la solución que interactúan con Orchestrator requieren estos parámetros:

Parámetro	Descripción	Ejemplo
-U	URL de Orchestrator	https://cloud.uipath.com/
-T	Nombre del tenant de Orchestrator	DefaultTenant
-A	Nombre de la organización	myorg
-I	ID de aplicación externa	12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-S	Secreto de aplicación externa	**** (mantener seguro)
--applicationScope	Lista de ámbitos separados por espacios	Ver ámbitos anteriores
--traceLevel	Nivel de registro	Information, Verbose, Warning

Nota:

When using external application authentication without specifying the --applicationScope parameter, the CLI automatically applies these default AutomationSolution scopes:

Solutions.Packages Solutions.Deployments OR.Execution

Configurar una aplicación externa

Para crear una aplicación externa para soluciones:

1. Inicia sesión en Orchestrator como administrador.
2. Dirígete a Admin → Aplicaciones externas.
3. Haz clic en Añadir aplicación.
4. Proporciona un nombre (por ejemplo, CI-CD-Solutions).
5. Selecciona Aplicación confidencial como Tipo de aplicación.
6. Añade los ámbitos necesarios enumerados anteriormente.
7. Copia el ID de la aplicación y el Secreto y guárdalos de forma segura en tu gestor de secretos de CI/CD.

Para obtener instrucciones detalladas sobre la configuración de aplicaciones externas, consulta Gestionar aplicaciones OAuth externas.

Utilizar fuentes personalizadas de Orchestrator

Al utilizar fuentes de actividad personalizadas desde Orchestrator durante las operaciones de restauración, utiliza estos parámetros alternativos:

Parámetro estándar	Parámetro de fuente personalizado
--applicationScope	--libraryOrchestratorApplicationScope
-T (tenant)	--libraryOrchestratorTenant
-U (URL)	--libraryOrchestratorUrl
(carpeta)	--libraryOrchestratorFolder

Ejemplo:

uipcli solution restore <solution-path> \  -A myorg \  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \  -S **** \  --libraryOrchestratorApplicationScope "OR.Folders OR.Settings.Read" \  --libraryOrchestratorTenant DefaultTenant \  --libraryOrchestratorUrl https://cloud.uipath.com/ \  --libraryOrchestratorFolder MyFolder

Mejores prácticas de seguridad

• Nunca codifiques secretos en procesos YAML o scripts.
• Utiliza la gestión de secretos de tu plataforma CI/CD:
  • Azure DevOps: grupos de variables con variables secretas.
  • Acciones de GitHub: Repositorio u Secretos de organización.
  • Jenkins: almacén de credenciales.
• Rote los secretos de la aplicación externa con regularidad.
• Utilice aplicaciones externas independientes para diferentes entornos (Desarrollo, Prueba, Producción).
• Aplicar ámbitos de privilegios mínimos: otorga solo lo que se necesita para cada proceso.