estado de inicio de sesión de uip

Sintaxis y opciones para el `estado de inicio de sesión de UIP`, que informa del estado de autenticación actual sin actualizar los tokens.

uip login status del estado de autenticación actual: si has iniciado sesión, qué organización y tenant están seleccionados y cuándo caduca el token de acceso. Es una inspección de solo lectura de la sesión almacenada: este comando no actualiza tokens.

Úsalo en scripts para realizar trabajos de seguimiento, o de forma interactiva para confirmar a qué tenant se dirigirá una llamada uip posterior.

Sinopsis

uip login status

Este comando respeta las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

Argumentos

Nada.

Opciones

Nada.

Nota:

login status no acepta -f, --file <folder> : siempre lee la ubicación de credenciales predeterminada. Si utilizas una carpeta de credenciales no predeterminada, vuelve a ejecutar el comando uip login ... correspondiente en esa carpeta antes de comprobar el estado.

Ejemplos

# Human-readable (default table output)
uip login status

# JSON for scripts
uip login status --output json

Forma de datos (--json de salida)

{
  "Code": "LoginStatus",
  "Data": {
    "Status": "Logged in",
    "Identity": "[e-mail]",
    "IdentityType": "User",
    "AuthFlow": "Interactive",
    "CredentialSource": "SavedLogin",
    "Organization": "my-org",
    "OrganizationId": "00000000-0000-0000-0000-000000000001",
    "Tenant": "DefaultTenant",
    "TenantId": "00000000-0000-0000-0000-000000000002",
    "Expiration Date": "2026-04-18T10:30:00Z"
  }
}

• Status: uno de Logged in o Not logged in. Cuando no se ha iniciado sesión, la mayoría de los campos siguientes se omiten y Organization/Tenant vuelven a N/A.
• Identity — quién actúa: el correo electrónico de un usuario para sesiones interactivas, o "External application <clientId>" para una sesión de credenciales de cliente/federada. Se omite cuando no se puede determinar.
• IdentityType — "User" o el tipo de la aplicación externa. Presente siempre que Identity lo esté.
• AuthFlow: cómo se probó la identidad: "Interactive", "ClientCredentials" o "FederatedCredentials". Presente cuando se conoce.
• CredentialSource: de dónde provino la sesión: "Robot", "EnvironmentVariables", "SavedLogin" o "N/A".
• UserId / UserEmail / UserName / ClientId: detalles de identidad adicionales, cada uno presente solo cuando la sesión subyacente realmente lleva ese campo.
• Profile: el perfil con nombre activo, cuando se establece uno y la sesión está basada en archivos.
• Organization : nombre de la organización cuando esté disponible; de lo contrario, el ID de la organización.
• OrganizationId: presente junto a Organization cuando el ID se conoce por separado del nombre.
• Tenant : nombre del tenant cuando esté disponible; de lo contrario, el ID del tenant. N/A si no se selecciona ningún tenant.
• TenantId: presente junto a Tenant cuando el ID se conoce por separado del nombre.
• BaseUrl: la URL base de identidad/API resuelta, cuando se conoce.
• Expiration Date — Marca de tiempo ISO-8601 de la caducidad del token de acceso. Esto no se actualiza aquí; una invocación posterior de la herramienta actualizará el token si es necesario.
• Hint opcional) : texto de aviso cuando la capa de autenticación tiene algo que mostrar, por ejemplo, una sesión de PAT opaca informa "Token is opaque (not a JWT) - expiration and identity cannot be determined locally. Commands will fail with 401 once it is revoked or expired." en lugar de una fecha de vencimiento.
• Provider (obsoleto) : una versión heredada de menor fidelidad de CredentialSource ("Robot"/"Environment"/"File"/"N/A"), que se mantiene durante una versión para los scripts existentes. Lee CredentialSource en su lugar; Provider se eliminará.

Exactamente qué campos aparecen depende del flujo de autenticación: una sesión de PAT/variable de entorno, por ejemplo, no tiene Identity/AuthFlow (el token no lleva reclamaciones de las que derivarlos) pero lleva CredentialSource y BaseUrl.

Comportamiento de error

Cuando la sesión almacenada es ilegible o la alternativa de la variable de entorno (UIPATH_CLI_*) está incompleta, la CLI emite un ConfigError. El campo Instructions te dirige a la causa raíz correcta:

• Si se utilizan variables de entorno pero están mal configuradas, las instrucciones dicen "Check the UIPATH_CLI_* environment variables and re-run."
• De lo contrario, las instrucciones apuntan a la carpeta de credenciales en el disco.

Relacionado

• uip login : autentica y elige un tenant.
• uip logout : borra la sesión almacenada.
• Autenticación : qué refleja Status y cómo se actualizan los tokens.
• Sesiones y credenciales : ubicación de carpetas y reglas de anulación.