Globus Connect Server Administration Guides
  • Quickstart Guide
  • Installation Guide
  • Data Access Admin Guide
  • Domain Guide
  • HTTPS Access to Collections
  • Identity Mapping Admin Guide
  • Globus OIDC Installation Guide
  • Troubleshooting Guide
  • Command-Line Reference
    • Command summary
    • Audit
      • Load
      • Query
      • Dump
    • Endpoint
      • Setup
      • Show
      • Update
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription ID
      • Cleanup
      • Key Convert
      • Domain
      • Role
      • Upgrade
    • OIDC
      • Create
      • Delete
      • Register
      • Show
      • Update
    • Node
      • Create
      • Disable
      • Enable
      • New Secret
      • Setup
      • List
      • Show
      • Update
      • Cleanup
      • Delete
    • Login
    • Session
      • Consent
      • Show
      • Update
    • Whoami
    • Logout
    • Storage Gateway
      • Create
      • List
      • Show
      • Update
      • Delete
    • Collection
      • Create
      • List
      • Show
      • Batch Delete
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription Admin Verified Collection Property
      • Update
      • Delete
      • Domain
      • Check
      • Role
    • Auth Policy
      • Create
      • List
      • Show
      • Update
      • Delete
    • Sharing Policy
      • Create
      • List
      • Show
      • Delete
    • User Credentials
      • Activescale Create
      • OAuth Create
      • Delete
      • List
      • S3 Create
      • S3 Keys Add
      • S3 Keys Delete
      • S3 Keys Update
    • Self Diagnostic
  • Globus Connect Server Manager API
    • Authorization
    • Versioning
    • Endpoint
    • Roles
    • Nodes
    • Storage Gateways
    • Collections
    • User Credentials
    • Domains
    • Sharing Policies
  • API Access for Portals
  • Automated Endpoint Deployment
  • Data Access Application Guide
  • Application Migration Guide
  • Change Log
Skip to main content
Globus Docs
  • APIs
    Auth Flows Groups Search Timers Transfer Globus Connect Server Compute Helper Pages
  • Applications
    Globus Connect Personal Globus Connect Server Premium Storage Connectors Compute Command Line Interface Python SDK JavaScript SDK
  • Guides
  • Support
    FAQs Mailing Lists Contact Us Check Support Tickets
  1. Home
  2. Globus Connect Server
  3. v5.4
  4. Command-Line Reference
  5. Login

Globus Connect Server Login

Name

globus-connect-server login - Obtain credentials to access a Globus Connect Server Endpoint

Synopsis

globus-connect-server login {ENDPOINT_ID | "localhost"} [OPTIONS]…​

Description

The globus-connect-server login command creates an authentication token on the local machine. Most globus-connect-server command commands require a token in order to manage or view the state of an Endpoint.

Before running this command, the endpoint must have been created with globus-connect-server endpoint setup and deployed on one or more Data Transfer Nodes with globus-connect-server node setup.

When you invoke this command, you must supply an argument that may be either the endpoint ID (which is also the client id used to create the endpoint), or the string localhost. The localhost string will only work if you are invoking this command on a Data Transfer Node. The client id form of this command will work on any machine with internet access.

When you run this command, it will print out a long URL that is a link to the Globus Auth service. Follow that link, authenticate with your identity provider, and then copy the code value in the resulting web page into the terminal where you are running this command. If successful, this command will print out a message that you are successfully logged in.

You can now use the other globus-connect-server commands for which your Globus identity has been granted permissions. If your are the endpoint owner, you can create and manage storage gateways and mapped collections. If your endpoint is managed, you can also create other management roles.

Normally, the globus-connect-server login command obtains an OAuth refresh token, so that once you’ve logged in, you can perform many globus-connect-server commands without having to log in again. If you are done managing the endpoint and don’t require this behavior, you can use globus-connect-server logout to revoke the token.

Note

Some commands require a specific identity to be “in session”. This means that you must have recently authentication with a particular identity provider with this application on the node you are running the command on. If you receive a session-related error message, use the globus-connect-server session update command to reauthenticate with the required identity provider and then retry the command.

Options

-h, --help

Show help message and exit.

--version

Show the version and exit.

--force

Do a fresh authentication flow, ignoring any existing credentials.

Example

This example attempts to log into the endpoint whose id is stored in the CLIENT_ID environment variable.

globus-connect-server login $CLIENT_ID

This example attempts to log into the endpoint running on the node the command is being run on.

globus-connect-server login localhost
  • Quickstart Guide
  • Installation Guide
  • Data Access Admin Guide
  • Domain Guide
  • HTTPS Access to Collections
  • Identity Mapping Admin Guide
  • Globus OIDC Installation Guide
  • Troubleshooting Guide
  • Command-Line Reference
    • Command summary
    • Audit
      • Load
      • Query
      • Dump
    • Endpoint
      • Setup
      • Show
      • Update
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription ID
      • Cleanup
      • Key Convert
      • Domain
      • Role
      • Upgrade
    • OIDC
      • Create
      • Delete
      • Register
      • Show
      • Update
    • Node
      • Create
      • Disable
      • Enable
      • New Secret
      • Setup
      • List
      • Show
      • Update
      • Cleanup
      • Delete
    • Login
    • Session
      • Consent
      • Show
      • Update
    • Whoami
    • Logout
    • Storage Gateway
      • Create
      • List
      • Show
      • Update
      • Delete
    • Collection
      • Create
      • List
      • Show
      • Batch Delete
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription Admin Verified Collection Property
      • Update
      • Delete
      • Domain
      • Check
      • Role
    • Auth Policy
      • Create
      • List
      • Show
      • Update
      • Delete
    • Sharing Policy
      • Create
      • List
      • Show
      • Delete
    • User Credentials
      • Activescale Create
      • OAuth Create
      • Delete
      • List
      • S3 Create
      • S3 Keys Add
      • S3 Keys Delete
      • S3 Keys Update
    • Self Diagnostic
  • Globus Connect Server Manager API
    • Authorization
    • Versioning
    • Endpoint
    • Roles
    • Nodes
    • Storage Gateways
    • Collections
    • User Credentials
    • Domains
    • Sharing Policies
  • API Access for Portals
  • Automated Endpoint Deployment
  • Data Access Application Guide
  • Application Migration Guide
  • Change Log
© 2010- The University of Chicago Legal Privacy Accessibility