statut de connexion à l'IU

Syntaxe et options de `uip pull status`, qui signale l'état d'authentification actuel sans rafraîchir les jetons.

uip login status signale l'état d'authentification actuel: si vous êtes connecté, quelle organisation et quel locataire sont sélectionnés, et quand le jeton d'accès expire. Il s'agit d'une inspection en lecture seule de la session stockée — aucun jeton n'est actualisé par cette commande.

Utilisez-le dans des scripts pour limiter le travail de suivi ou de manière interactive pour confirmer le locataire qu'un appel uip ultérieur ciblera.

Synthèse

uip login status

Cette commande respecte les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.

Arguments

Aucun

Options

Aucun

Remarque :

login status n'accepte pas -f, --file <folder> — il lit toujours l'emplacement des informations d'identification par défaut. Si vous utilisez un dossier d’informations d’identification non par défaut, réexécutez la commande uip login ... correspondante dans ce dossier avant de vérifier le statut.

Exemples

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

# JSON for scripts
uip login status --output json

Format des données (--sortie json)

{
  "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 — l'un des Logged in ou Not logged in. Lorsque vous n'êtes pas connecté, la plupart des champs ci-dessous sont omis et Organization/Tenant basculent sur N/A.
• Identity — qui agit: l'e-mail d'un utilisateur pour les sessions interactives, ou "External application <clientId>" pour une session client-redentials/ fédérée. Omis lorsqu’il ne peut pas être déterminé.
• IdentityType — "User" ou le type de l'application externe. Affiché chaque fois que Identity est.
• AuthFlow — comment l'identité a été éprouvée: "Interactive", "ClientCredentials" ou "FederatedCredentials". Présent lorsqu’il est connu.
• CredentialSource — l'origine de la session: "Robot", "EnvironmentVariables", "SavedLogin", ou "N/A".
• UserId / UserEmail / UserName / ClientId — détail d'identité supplémentaire, chacun présent uniquement lorsque la session sous-jacente comporte réellement ce champ.
• Profile — le profil nommé actif, lorsqu'il est défini et que la session est basée sur des fichiers.
• Organization — le nom de l'organisation lorsqu'il est disponible; sinon, l'ID de l'organisation.
• OrganizationId — présent avec Organization lorsque l'ID est connu séparément du nom.
• Tenant — nom du locataire lorsqu'il est disponible; sinon, l'ID du locataire. N/A si aucun locataire n'est sélectionné.
• TenantId — présent avec Tenant lorsque l'ID est connu séparément du nom.
• BaseUrl — l'URL de base de l'identité/de l'API résolue, lorsqu'elle est connue.
• Expiration Date — Horodatage ISO-8601 de l'expiration du jeton d'accès. Il n’est pas actualisé ici; une invocation ultérieure de l’outil actualisera le jeton si nécessaire.
• Hint (facultatif) — texte de conseil lorsque la couche d'authentification a quelque chose à faire apparaître — par exemple, une session PAT dense rapporte "Token is opaque (not a JWT) - expiration and identity cannot be determined locally. Commands will fail with 401 once it is revoked or expired." au lieu d'une date d'expiration.
• Provider (obsolète) : une version héritée et peu fiable de CredentialSource ("Robot"/"Environment"/"File"/"N/A"), conservée pendant une version pour les scripts existants. Lisez CredentialSource à la place; Provider sera supprimé.

Les champs qui apparaissent dépendent du flux d’authentification — une session PAT/variable d’environnement, par exemple, n’a pas de Identity/AuthFlow (le jeton ne porte aucune revendication à partir de laquelle les dériver) mais porte CredentialSource et BaseUrl.

Comportement des erreurs

Lorsque la session stockée n’est pas lisible ou que la variable de secours (UIPATH_CLI_*) est incomplète, la CLI génère une ConfigError. Le champ Instructions vous dirige vers la cause profonde correcte:

• Si les variables d’environnement sont utilisées mais sont mal configurées, les instructions lisent "Check the UIPATH_CLI_* environment variables and re-run."
• Sinon, les instructions pointent vers le dossier d'informations d'identification sur le disque.

Associé

• uip login — authentifiez-vous et choisissez un locataire.
• uip logout — effacez la session stockée.
• Authentification — ce que Status reflète et comment les jetons sont actualisés.
• Sessions et informations d’identification — Emplacement du dossier et règles de remplacement.