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. Typically, it is also possible to authenticate using existing Kerberos tickets 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 shuold last until you quit your browser program. Be sure you have secured your identity by quitting your browser before you leave your computer unprotected; 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 three mechanims"
- 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 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 (as opposed 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 Web Login, 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 Web Login system requires that your web browser accept "cookies", small files that web servers send to your computer. Cookies have many purposes, some of them of questionable value to you. However, MIT Web Login uses them for security and verification. Having a cookie for an MIT Web Login 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 2 minutes of the MIT Web Login screen appearing. If you don't, you will get this error message. You must re-initiate the request for the web page or service you want - that may mean re-entering the URL or returning to the page with the link to this service. Backing up to the MIT Web Login page and trying again will not work.