This is a draft of the text which will appear on the page that will be opened when the user selects the "Help" tab on the Touchstone login page. The initial version is based on the text which appears on https://foonalagoona-mit-edu.ezproxy.canberra.edu.au/help.html which has been used during the prototype stage.
What is MIT Touchstone?
The MIT Web application you are using requires you to identify yourself via the MIT Touchstone system. You can do this by providing your Kerberos username and password. It is also possible to authenticate using existing Kerberos tickets under some circumstances. or an MIT user certificate. Once you have authenticated successfully, you will be able to proceed and enter the requested web site. If you don't have an MIT Kerberos account, see What if I don't have a username below.
Under MIT Touchstone, your single web login gives you access to many other web sites in addition to the one you initially accessed. In other words, this provides a single sign on solution amonst the Touchstone enabled applications.
Your access to Touchstone enabled applications should last only until you quit your browser program. Be sure to secure your identity by quitting your browser before you leave your computer. Otherwise, someone else using your computer after you can impersonate you on the Touchstone systems - both to the sites that you are using as well as to any of the other web sites that accept MIT Touchstone as an authentication authority.
What am I supposed to do?
On the MIT Touchstone Login page you can identify yourself by one of two three methods:
- By presenting an MIT X.509 certificate. If you have a certificate accessible to your browser, simply click on the "Use Certificate - Go" button.
- By entering your MIT Kerberos username and password in the username and password fileds and click on the Login button. Use the Tab key or your mouse to put the cursor into the entry fields.
- By using your existing Kerberos tickets, if your browser is properly configured. This last choice typically only applies to users of the Athena and WIN.MIT.EDU computer systems, and who have also taken additional steps to configure their environment to support this feature.
How do I know if I have an MIT X.509 Certificate, or how do I obtain one?
Certificates are your key to most of the secure web applications at MIT which do not yet use MIT Touchstone. Such systems currently include Benefits, Request Tracker, SAPweb, and WebSIS. Certificates are the preferred way to access MIT web servers and applications. The link at the star of this paragraph will take you to the IS&T page that provides lots of information about certificates, including how to obtain one.
How do I know if I have an MIT Kerberos username and password?
Many MIT computer-based systems and services share the same username/password authentication service, Kerberos. This means a user has to keep track of only one username and password -- the user's MIT Kerberos username and password -- for many systems. If you have an email account at MIT that has an address that has the form <username>@mit.edu, then you have an MIT Kerberos username, and most likely know its password. Creating and Using Your MIT Kerberos Identity has much more information establishing your Kerberos identity at MIT and the system where you may use it.
How do I know if have Kerberos tickets or can use them?
Although we just mentioned Kerberos as it relates to your username and password at MIT, Kerberos is also a computer network protocol. Online services that are protected by Kerberos will ask to see your Kerberos "ticket" before they will let you in. At MIT there are many native applications (in contrast to web applications) which use the Kerberos protocol for authentication. Some of these include the native clients for SAP, TechTime, COEUS, and Jabber. In particular you obtain Kerberos tickets when you log into an Athena workstation or a machine in the WIN.MIT.EDU Domain.
Users of Athena and WIN.MIT.EDU may find the use of Kerberos tickets in conjunction with MIT Touchstone enabled applications particularly attractive. By using this feature you will have already performed the necessary authentication when you logged into the workstation. If your browser is configured correctly, and you have set a preference to use this feature, each time you attempt to access a Touchstone enabled application you will quickly be granted access without being prompted for any additional information.
- browser configuration information
- test the use of Kerberos within Touchstone
What if I don't have a Kerberos username?
The Touchstone@MIT login is to be used by MIT users that do have a Kerberos username. If you are an MIT user but do not have an MIT Kerberos username then you need to register for an Athena user account. Creating and Using Your MIT Kerberos Identity has much more information establishing your Kerberos identity at MIT and the system where you may use it.
Many of the MIT Touchstone applications in use today also have a local account management system so that they may be used by people that do not have an MIT Kerberos username. Those users should not use the Touchstone@MIT login page. Instead the Touchstone enabled application that you are attempting to use should have an alternative login page for your use. Please go back to that application and read the login choices presented to you more carefully.
MIT Touchstone enabled applications also support federated authentication with a limited number of partners using Shibboleth. Today we share metadata with ProtectNetwork, so the Touchstone enabled application that you are attempting to use may also support authenticating via ProtectNetwork's login server.
Help! What did I do wrong?
Error messages and descriptions:
Missing or Incorrect username and/or Password: To authenticate to MIT Touchstone, you must provide both your username and its password. If you have forgotten your username or password or need other assistance with them, please contact Athena User Accounts.
You must enable cookies on your web browser: The MIT Touchstone system requires that your web browser accept "cookies", small files that web servers send to your computer. MIT Touchstone uses them for security and verification. Having a cookie for an MIT Touchstone web site identifies you to the site and allows you to continue from one page of the site to another without having to login each time. You can usually enable cookies in the Settings or Preferences panels of your browser program.
You took too long to login: You must enter your username and password within 5 minutes of the MIT Touchstone login screen appearing in your browser window. After that time has elapsed, you must re-initiate the request for the web page or service you want to access by re-entering the URL in the address bar or by returning to the original site which first asked you to authenticate. Reloading or returning to the MIT Touchstone login page and trying again will not work.