eduLogon at your school
How to make it work at your college or university
There are two ways to get eduLogon to function at your campus.
Option 1: Send me the information
I can set up the eduLogon program to work with your campus network if I know a few simple things about how the logon system at your campus works. Some of the information is a tiny bit technical, but if you can operate a web browser (and you can, you're reading this :)) you can send me what I need. I am trying to get eduLogon to work at as many campuses as possible, and would very much appreciate your help. If you are willing to help me, send the following information to my email, .
Logon details I need from your campus:
Note: You'll need to grab this information while on campus, right after connecting to wireless. Don't log on until you've got everything.
- The abbreviation for your campus
You know, MIT, or CMU :). This is just used in messages displayed onscreen, but I don't always know what the right abbreviation for a school is, and it would probably look pretty bad if I got it wrong.
- The domain name (or "DNS Suffix") assigned to your computer when you connect.
To find this out, open a command prompt by:
In Windows XP:
- going to the start menu and clicking run
- typing "cmd" in the window that appears and clicking OK
or on vista:
Once you have a command prompt open, type "ipconfig" at the prompt. Text should appear similar to that displayed below.
- searching for "command prompt"
All you need to send me is (of course) the part circled in yellow. Usually this is the same as your school's web address, but not always.
- The URL of the first page you get sent to when you open your browser.
When you are not logged in to your campus network, you will get redirected to one or more web pages so you can log in. On many campuses, the first page you get redirected to is the one with the actual form that allows you to log in, but not always. If the first page you get sent to does not have the actual logon form, send me the url (copied/pasted from your browser) of this first page.
- The URL of the page containing the form you use to log on
If different from the address in part 2.
- A copy of the webpage containing the form you use to log on
To send me this, go to file->save as (or save webpage as) when you are at the logon page in your browser. Attach the file you save to the email. (Alternatively, if you know how to view the HTML source of the page, you can copy/paste the html source into the body of the email.)
- The message displayed if you try to log on with a username that doesn't exist
Just put in a bogus username and password, and copy/paste the error message from your web browser that it gives you into your email. I do not need entire html documents/pages here, just the text of the error message itself.
(This enables the eduLogon program to display an error message to the user if a wrong username is used, and allows them to try logging in with different credentials.)
- The message displayed if you try to log on with your username but the wrong password
Same as before, but use your real username and put a typo in your password. Again, copy/paste the error message that it gives you. If it's the same as the last one, you can just note that.
- And finally, The message displayed when you enter a correct username and password.
Same idea as the last two. Copy/paste from your web browser. If you are sent directly to the web page you were originally trying to access, with no explicit confirmation of being logged in, let me know that instead.
Option 2: Edit config.xml yourself
For those more comfortable with networking and HTTP, you can download beta 2 or later of eduLogon and add an entry in the config.xml file for your school. If you succeed in (or just attempt) this, PLEASE share your results with me. Use the existing entries in the file and the above instructions as a guide. Config.xml can be found in the directory you install eduLogon to. There is also a formal document type definition for config.xml distributed in the installer, named config.dtd. If you have a dtd-aware xml editor, use it. The DTD is enforced by the eduLogon agent, and it will exit if your edits to config.xml violate the dtd.