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. Puedes utilizar la forma corta o la forma larga (alternativa) para cada uno:

Forma corta	Forma larga (alternativa)	Descripción	Ejemplo
-U	N/D	URL de Orchestrator	Consulte la URL de Orchestrator a continuación
-T	N/D	Nombre del tenant de Orchestrator	DefaultTenant
-A	--accountForApp	Nombre de la organización (cuenta)	myorg
-I	--applicationId	ID de aplicación externa	12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-S	--applicationSecret	Secreto de aplicación externa	**** (mantener seguro)
--applicationScope	N/D	Lista de ámbito (ver arriba)	Arriba
--traceLevel	N/D	Nivel de registro	Information, Verbose, Warning

Ejemplo con parámetros de formato largo:

uipcli solution upload-package ./packages/MySolution.1.0.0.zip \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  --accountForApp myorg \
  --applicationId 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  --applicationSecret **** \
  --applicationScope "AutomationSolutions Solutions.Packages Solutions.Packages.Write"

URL de Orchestrator

Utiliza la URL base solo para la instancia de Orchestrator. No incluyas segmentos de organización, tenant o ruta (por ejemplo, no utilices https://cloud.uipath.com/myorg/DefaultTenant/orchestrator_). La organización y el tenant se transmiten por separado con -A y -T.

• UiPath Automation Cloud: utiliza la URL base de la nube (por ejemplo, https://cloud.uipath.com/ o https://staging.uipath.com/).
• Automation Suite (on-premises o en la nube privada): utiliza la URL base de tu instancia de Automation Suite (por ejemplo https://uipath.yourcompany.com/). La URL es la misma que para los comandos del paquete. Solo la dirección base de tu Orchestrator (o Automation Suite) difiere de la de la nube pública.

Nota:

Al utilizar la autenticación de aplicaciones externas sin especificar el parámetro --applicationScope , la CLI aplica automáticamente los ámbitos necesarios para los comandos de la solución.

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.