src/windows/identity/help/html/act_new_creds.htm

   1 <html>\r
   2 <head>\r
   3   <title>Network Identity Manager - New Credentials</title>\r
   4   <meta name="description" content="obtain new credentials">\r
   5   <meta name="keywords" content="new creds">\r
   6   <link rel="stylesheet" type="text/css" href="nidmgr.css">\r
   7   \r
   8   <Object type="application/x-oleobject" classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">\r
   9 <param name="Keyword" value="Obtaining New Credentials">\r
  10 <param name="Keyword" value="Ctrl + N">\r
  11 <param name="Keyword" value="New Credentials Dialog">\r
  12 <param name="Keyword" value="Kerberos v5 ticket flags">\r
  13 <param name="Keyword" value="Changing Passwords">\r
  14 <param name="Keyword" value="Obtain New Credentials at Startup">\r
  15 </OBJECT>\r
  16 </head>\r
  17 <body>\r
  18 \r
  19 <h1>Network Identity Manager - New Credentials</h1>\r
  20 \r
  21 <p>The new credentials dialog can be invoked from the <a\r
  22 href="menu_credential.htm">Credentials</a> menu, by typing <span\r
  23 class="pre">Ctrl + N</span>, using the context menu in the credentials\r
  24 window or using the context menu in the NetIDMgr icon in the system\r
  25 notification area.\r
  26 </p>\r
  27 \r
  28 <p>Once invoked, you will be presented with a dialog similar to the\r
  29 following:\r
  30 </p>\r
  31 \r
  32 <p>\r
  33 <img src="images/screen_new_creds.png" alt="New credentials dialog"/>\r
  34 <p class="caption">New credentials dialog with a valid identity\r
  35 selected.</p> \r
  36 \r
  37 <p>If the Kerberos v5 identity provider is used, the dialog will ask\r
  38 for a username and a realm to determine the identity for which new\r
  39 credentials will be obtained for.  Depending on the selected identity,\r
  40 you may be required to provide a password or other form of\r
  41 authentication for new credentials to be obtained.\r
  42 </p>\r
  43 \r
  44 <p>Below the prompts is the credentials summary window.  This window\r
  45 provides an overview of the credentials that will be obtained when the\r
  46 dialog is completed.\r
  47 </p>\r
  48 \r
  49 <h3>Expanded view</h3>\r
  50 \r
  51 <p>If you click any of the credentials type hyperlinks in the\r
  52 credentials summary window or select the <span class="pre">&gt;&gt;</span> button, the dialog will switch to the expanded view.\r
  53 An example of this is shown below:\r
  54 </p>\r
  55 \r
  56 <p>\r
  57 <img src="images/screen_new_creds_exp.png"\r
  58 alt="Expanded new credentials window" />\r
  59 \r
  60 <p class="caption">Expanded view of the new credentials dialogg</p>\r
  61 \r
  62 <p>\r
  63 The expanded view provides access to additional options available for\r
  64 each credential provider.  For example, the Kerberos v5 credentials\r
  65 provider allows you to set the lifetime of the obtained Kerberos\r
  66 ticket as well as ticket flags such as <i>renewable</i> or\r
  67 <i>forwardable</i>.\r
  68 </p>\r
  69 <p>\r
  70 <i>Note that the above screenshot is\r
  71 from an instance of NetIDMgr with Kerberos v5, Kerberos v4, OpenAFS and \r
  72 Kerberized Certificate Authority providers with a Kerberos v5 identity provider.  Actual display may be\r
  73 different depending on the providers that are active.</i></p>\r
  74 \r
  75 <h3>Credentials summary window</h3>\r
  76 \r
  77 <p>The credentials summary window provides an overview of the\r
  78 credentials that will be obtained after the successful completion of\r
  79 the new credentials dialog.  The window contains hyperlinks that will\r
  80 take you to the corresponding credentials option panels where you will\r
  81 be able to set additional options for each type.\r
  82 </p>\r
  83 \r
  84 <p>If there is a problem with the selected identity, the credentials\r
  85 window will display a message describing the problem.  For example:\r
  86 </p>\r
  87 \r
  88 <p>\r
  89 <img src="images/screen_new_creds_err01.png" alt="Credentials summary window showing an invalid identity" />\r
  90 </p>\r
  91 \r
  92 <p>\r
  93 The above is an example of what you would see if the provided identity\r
  94 is invalid.  Once the identity provider (in this case, Kerberos v5)\r
  95 indicates that the identity is invalid, it will be displayed as above\r
  96 along with a brief description of why the identity was found to be\r
  97 invalid.  Here, the Kerberos v5 identity provider is reporting that the\r
  98 specified principal does not exist in the Kerberos database.\r
  99 </p>\r
 100 \r
 101 <h3>Additional notes</h3>\r
 102 \r
 103 <p>The new credentials dialog can be invoked from the command line using\r
 104 the <span class="pre"> -i </span> or <span class="pre"> --kinit\r
 105 </span> command line option.  Additionally, if you specify the <span\r
 106 class="pre"> -a </span> or <span class="pre"> --autoinit </span>\r
 107 command line option, the new credentials dialog will be displayed if\r
 108 there are no credentials available.\r
 109 </p>\r
 110 \r
 111 <p>\r
 112 Setting the <span class="pre">Obtain new credentials at startup (if none are present)</span> option in the <span\r
 113 class="pre">General</span> configuration panel causes NetIDMgr to behave as if \r
 114 the <span class="pre">--autoinit</span> option is specified at each execution.\r
 115 </p>\r
 116 \r
 117 </body>\r
 118 </html>