From 095ae2aa5072282f4b1842e78baeb4c82bd31098 Mon Sep 17 00:00:00 2001 From: Kevin Wasserman Date: Sat, 5 May 2012 10:53:44 -0400 Subject: Help updates for kfw 4.0 Signed-off-by: Kevin Wasserman [kaduk@mit.edu: Squash commits, a couple of grammar fixes, and also turn a few instances of "Leash" into "MIT Kerberos". Trim trailing whitespace and other whitespace tweaks to pass the commit hooks.] ticket: 7300 (new) queue: kfw target_version: 1.10.4 tags: pullup Signed-off-by: Kevin Wasserman --- src/windows/leash/htmlhelp/html/Principals.htm | 69 ++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 src/windows/leash/htmlhelp/html/Principals.htm (limited to 'src/windows/leash/htmlhelp/html/Principals.htm') diff --git a/src/windows/leash/htmlhelp/html/Principals.htm b/src/windows/leash/htmlhelp/html/Principals.htm new file mode 100644 index 000000000..a8df3b4b8 --- /dev/null +++ b/src/windows/leash/htmlhelp/html/Principals.htm @@ -0,0 +1,69 @@ + + + + + +Principals + + +

About Principals

+

+Your principal is your Kerberos identity. It is your user name plus the Kerberos realm (or Windows domain) you are part of. For example, if your user name is jdoe and you are part of the SALES.WIDGET.COM realm, your principal is jdoe@SALES.WIDGET.COM. +

+ + + + + +
Learn about... +
+

Using a Single Principal

+

+If like many users you just have one Kerberos identity, you will have just one principal. +

+In most installations, MIT Kerberos knows your realm, so when you start to enter your principal in the Get Ticket window it will auto-complete for you. If you select the "Remember this principal" checkbox you won't have to enter your principal again.

+

+The main window shows your principal, along with information about tickets issued to it.
+ How to: View Tickets +

+

+Back to top

+ +

Multiple principals

+

+Some users have multiple principals. For example, administrators often have one principal with standard access and an administrative principal with administrative access. Also, some Kerberos installations require multiple principals to access multiple realms. +
+ How to: Manage Multiple Principals
How to: Make Default Principal. +

+

+Back to top

+ +

Default Principal

+

+Your default principal appears in bold font in the main window. If you have a single principal, that principal is always the default. But if you have multiple principals you will need to change the default principal depending on what service or host you need to access.

+

+When you try to use a Kerberized application, the application attempts to authenticate you by requesting your credentials from Kerberos. Some applications do this by asking for a specific principal's credentials, but others ask generically. +

+When applications make a generic request, Kerberos does not know which of your principals is being authenticated and checks the default principal for tickets. If the default principal is not the correct one, the application will usually simply fail to work with no warning or notice. +

+

+To set your default principal, select a principal in the main window and then click the Make Default button.
+ How to: Make Default Principal +

+

+Back to top

+ + + + + + -- cgit