CILogon Authentication
CILogon is the preferred authentication method for Globus Connect Server. For this method to work, your environment must meet two requirements:
-
All users have some form of active SUNetID. Full-service, sponsored, and base-level SUNetIDs are all allowed.
-
Users must use their SUNetID as their local username.
Here is how CILogon authentication works:
-
The end user chooses to use your Globus Connect Server endpoint.
-
Globus redirects the user to CILogon, which redirects the user to the normal Stanford login page.
-
Once the user authenticates, Stanford reports successful authentication to CILogon, who issues a time-limited certificate and private key to Globus.
CILogon is preferred because it uses the normal Stanford web login process, which means the user’s SUNetID and password do not go to any non-Stanford sites.
When Globus communicates with your endpoint, it uses the client cert issued by CILogon, which contains the end user’s SUNetID. That is how your endpoint knows who is using Globus.
Globus Configuration
To use CILogon authentication, you will be making additions to the
globus-connect-server.conf
file that you first filled in during initial
configuration.
Here is the content which needs to be added to the globus-connect-server.conf
file:
The one section will now be discussed in detail. If you do not need this explanation, you can skip ahead.
Security
The Security
section is very simple:
[Security]
FetchCredentialFromRelay = True
IdentityMethod = CILogon
CILogonIdentityProvider = Stanford University
IdentityMethod tells globus-connect-server-setup
that we will be using
CILogon, and CILogonIdentityProvider confirms that our users will be using
Stanford University credentials. The explanation for
FetchCredentialFromRelay is a little more complicated.
TLS is used to secure the communications between Globus and your endpoint.
With TLS, the server side must have a private key and certificate (if you run a
web site, you are probably aware of this already). Since Globus is initiating
connections to your endpoint, your endpoint needs a private key and
certificate. The FetchCredentialsFromRelay setting tells
globus-connect-server-setup
to fetch a key and certificate from Globus, which
will be used for all future connections from Globus.
Once globus-connect-server.conf
has been completed, it is now time to run
globus-connect-server-setup
!
Run Setup
You should now run the globus-connect-server-setup
command. When you run
this command, you will be asked for your Globus ID’s password. Once that is
provided, setup will commence.
Here is an example of the output from a successful run of
globus-connect-server-setup
:
Password:
Using MyProxy server on None
Configured GridFTP server to run on sci-nfs-1.stanford.edu
Server DN: /C=US/O=Globus Consortium/OU=Globus Connect Service/CN=cff864ae-3965-11e8-b98d-0ac6873fc732
Using Authentication Method CILogon
Configured Endpoint quake-sci-nfs-1
globus-connect-server-setup
is performing these steps:
-
Checking for newer versions of Globus Connect Server.
-
Enabling the
globus-gridftp-server
service, and performing basic configuration. -
Installing CILogon’s Certificate Authority, which GridFTP will use to verify client certs.
-
Requesting a server certificate and private key from Globus, which MyProxy and GridFTP will use when accepting connections from Globus.
If configuration was successful, the “Configured endpoint” message will be printed. At this point, services have been started and are ready for use!
Now that Globus Connect Server (or, more specifically, MyProxy and GridFTP) is (are) up and running, you should finish configuration.