uip login status

「uip login status」の構文とオプション - トークンを更新せずに現在の認証状態を報告します。

uip login status は、現在の認証ステート (ログインしているかどうか、選択されている組織とテナント、アクセス トークンの有効期限) を報告します。これは保存されたセッションの読み取り専用検査であり、このコマンドによってトークンは更新されません。

スクリプトで使用して後続の作業をゲートしたり、対話形式で後続の uip 呼び出しでターゲットとするテナントを確認したりします。

概要

uip login status

このコマンドは、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) を優先します。終了コードは 標準コントラクトに従います。

引数

設定はありません。

オプション

設定はありません。

注:

login status は -f, --file <folder> を受け入れず、常に既定の資格情報の場所を読み取ります。既定以外の資格情報フォルダーを使用している場合は、ステータスを確認する前に、そのフォルダーで対応する uip login ... コマンドを再実行します。

例

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

# JSON for scripts
uip login status --output json

データシェイプ(--output 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 — Logged in または Not logged inのいずれかです。ログインしていないときは、以下のほとんどのフィールドが省略され、 Organization/Tenant にフォールバック N/A。
• Identity — 実行しているユーザーです。対話型セッションの場合はユーザーのメール アドレス、クライアント資格情報/フェデレーション セッションの場合はユーザーの "External application <clientId>" メール アドレスです。判別できない場合は省略します。
• IdentityType — "User" または外部アプリの種類です。Identityいるときはいつでも存在します。
• AuthFlow — 身元が証明された方法 ( "Interactive"、 "ClientCredentials"、または "FederatedCredentials")。既知の場合は存在します。
• CredentialSource — セッションの取得元です。 "Robot"、 "EnvironmentVariables"、 "SavedLogin"、または "N/A"です。
• UserId / UserEmail / UserName / ClientId — ID に関する追加の詳細です。それぞれが、基になるセッションが実際にそのフィールドを持っている場合にのみ表示されます。
• Profile — アクティブの名前付きプロファイルです (プロファイルが設定されており、セッションがファイルベースの場合)。
• Organization — 組織名 (利用可能な場合)。その他の場合は組織 ID。
• OrganizationId — ID が名前とは別にわかっている場合に Organization とともに表示されます。
• Tenant — テナント名 (利用可能な場合)。それ以外の場合はテナント ID。テナントが選択されていない場合は N/A 。
• TenantId — ID が名前とは別にわかっている場合に Tenant とともに表示されます。
• BaseUrl — 解決された ID/API のベース URL です (既知の場合)。
• Expiration Date — アクセス トークンの有効期限の ISO-8601 タイムスタンプ。これはここでは更新されません。後でツールを呼び出すと、必要に応じてトークンが更新されます。
• Hint (任意) — 認証レイヤーに何かが表面化している場合の勧告テキストです (たとえば、不透明な PAT セッションでは有効期限ではなく "Token is opaque (not a JWT) - expiration and identity cannot be determined locally. Commands will fail with 401 once it is revoked or expired." が報告されます)。
• Provider (非推奨) — CredentialSource のレガシの低忠実度バージョン ("Robot"/"Environment"/"File"/"N/A") であり、既存のスクリプト用に 1 つのリリースだけ保持されます。代わりに CredentialSource を読んでください。 Provider は削除されます。

具体的に表示されるフィールドは認証フローによって異なります。たとえば、PAT/環境変数セッションには Identity/AuthFlow はありません (トークンにはそれらの取得元のクレームがありません)が、 CredentialSource と BaseUrlが伝送されます。

エラー動作

保存済みセッションが読み取り不能であるか、環境変数のフォールバック(UIPATH_CLI_*)が不完全な場合、CLI は ConfigErrorを出力します。[ Instructions ] フィールドをクリックすると、正しい根本原因にたどり着くことができます。

• 環境変数が使用されているが、設定に誤りがある場合は、手順をお読みください "Check the UIPATH_CLI_* environment variables and re-run."
• それ以外の場合、手順はディスク上の credentials フォルダーをポイントします。

関連

• uip login — テナントを認証して選択します。
• uip logout — 保存済みセッションをクリアします。
• 認証 — Status 反映する内容とトークンの更新方法。
• セッションと資格情報 — フォルダーの場所とオーバーライド ルール。