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 — one of Logged in or Not logged in. When not logged in, most fields below are omitted and Organization/Tenant fall back to N/A.
• Identity — who is acting: a user's email for interactive sessions, or "External application <clientId>" for a client-credentials/federated session. Omitted when it can't be determined.
• IdentityType — "User" or the External App's type. Present whenever Identity is.
• AuthFlow — how the identity was proven: "Interactive", "ClientCredentials", or "FederatedCredentials". Present when known.
• CredentialSource — where the session came from: "Robot", "EnvironmentVariables", "SavedLogin", or "N/A".
• UserId / UserEmail / UserName / ClientId — additional identity detail, each present only when the underlying session actually carries that field.
• Profile — the active named profile, when one is set and the session is file-based.
• Organization : nombre de la organización cuando esté disponible; de lo contrario, el ID de la organización.
• OrganizationId — present alongside Organization when the ID is known separately from the name.
• Tenant : nombre del tenant cuando esté disponible; de lo contrario, el ID del tenant. N/A si no se selecciona ningún tenant.
• TenantId — present alongside Tenant when the ID is known separately from the name.
• BaseUrl — the resolved identity/API base URL, when known.
• 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 (optional) — advisory text when the auth layer has something to surface — for example, an opaque PAT session reports "Token is opaque (not a JWT) - expiration and identity cannot be determined locally. Commands will fail with 401 once it is revoked or expired." instead of an expiration date.
• Provider (deprecated) — a legacy, lower-fidelity version of CredentialSource ("Robot"/"Environment"/"File"/"N/A"), kept for one release for existing scripts. Read CredentialSource instead; Provider will be removed.

Exactly which fields appear depends on the auth flow — a PAT/environment-variable session, for example, has no Identity/AuthFlow (the token carries no claims to derive them from) but does carry CredentialSource and 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.