tests: Check for vlserver startup
[openafs.git] / src / WINNT / netidmgr_plugin / help / html / tokens_per_id.htm
1 <html>
2 <head>
3   <title>Configuring Network Identities to obtain tokens for AFS cells</title>
4   <meta name="description" content="Specifying tokens per identification">
5   <meta name="keywords" content="tokns, identification, specify">
6   <link rel="stylesheet" type="text/css" href="afsplhlp.css">
7 </head>
8 <body>
9
10 <h1>Configuring Network Identities to obtain tokens for AFS cells</h1>
11
12 <p>
13 The OpenAFS Provider maintains a list of AFS cells for each network identity.
14 A list is created the first time AFS tokens are obtained for an
15 identity or when the list of cells is
16 specified in the identity configuration panels.  Each AFS cell that
17 is listed has associated with it a token acquisition method and the name of the Kerberos realm
18 from which the AFS service ticket can be obtained.&nbsp; More details are provided in the <a
19 href="token_methods.htm">Token Aquisition Methods</a> topic.</p>
20
21 <p>The following sections detail the process by which AFS cells can be
22 specified when obtaining new credentials or configuring identities.
23 </p>
24
25 <a name="new_tokens" />
26 <h3>Specifying AFS cells when obtaining new credentials</h3>
27
28 <p>
29 When the OpenAFS Provider is installed, it enhances the Network Identity Manager
30 &quot;New Credentials&quot;
31 dialog with an AFS tokens options panel.  A typical new
32 credentials dialog is shown below demonstrating AFS cells listed in the
33 credentials summary window (Network Identity Manager version 1.2).
34 </p>
35
36 <p><img src="images/window_nc_main.bmp" alt="New credentials window showing AFS cells in the credentials summary window" /></p>
37
38 <p>Clicking on the <span class="pre">AFS</span> link in the
39 credentials summary window will take you to the AFS options page.
40 Alternatively, you can select the <span class="pre">Options
41 &gt;&gt;</span> button which expands the dialog to show the
42 credentials type buttons, and then click the <span
43 class="pre">AFS</span> button at the bottom of the expanded dialog.
44 </p>
45
46 <p>The AFS identification options page is shown below</p>
47
48 <p><img src="images/window_nc_afs_0.bmp" alt="AFS identification options page" /></p>
49
50 <p>This page allows you to specify if AFS tokens are obtained for this identity and if so, for which tokens and by which method will they be
51 obtained.  By unchecking the <span class="pre">Obtain AFS
52 tokens</span> checkbox, you prevent AFS tokens from being obtained
53 for this identity.
54 </p>
55
56 <p>Once the new credentials dialog successfully completes, the list of
57 cells will be saved with the identity.  The next
58 time you obtain new credentials for the identity, the list of cells
59 will be loaded automatically.  This list can be edited either by using
60 the new credentials dialog or the identity configuration
61 panels. (See <a href="#persistent_tokens">Changing persistent token lists</a>).
62 </p>
63
64 <h4>To add a cell:</h4>
65 <p>
66 <ul>
67
68 <li>Specify the name of the cell in the <span class="pre">Cell</span>
69 text box.</li>
70
71 <li>Specify the Kerberos realm for the service ticket in the <span
72 class="pre">Realm</span> text box.  Note that you can select <span
73 class="pre">(Automatic)</span> as the realm to allow the OpenAFS provider to select the realm.  For most cases, you don't need to specify
74 the realm manually and can simply leave the <span
75 class="pre">Realm</span> as <span class="pre">(Automatic)</span></li>
76
77 <li>Specify the token acquisition method in the <span
78 class="pre">Method</span>.  You can select <span
79 class="pre">(Automatic)</span> as the method to allow the OpenAFS provider to select the method automatically.  Similar to the automatic
80 realm selection, for most cases the provider will be able to correctly
81 select the token acquisition method.  More details about credentials
82 acquisition methods are provided in the <a
83 href="token_methods.htm">Token Acquisition Methods</a> topic.</li>
84
85 <li>Select the <span class="pre">Add/Update</span> button to add the
86 cell.</li>
87
88 </ul>
89 </p>
90
91 <p>Note that only one token can exist per cell per login session.
92 If a token exists for cell <em>X</em> while
93 logged in as user <em>A</em>, then any attempt to obtain credentials for cell X
94 as user B will result in the loss of the previous token.&nbsp; Only one identity can
95 posses a token for a given cell at a time.</p>
96
97 <p>Therefore, if you try to add a cell to an identity which is already listed in
98 the persistent cell list for another identity or
99 which currently exists under a different identity, you will receive a
100 warning such as the following:
101 </p>
102
103 <p>
104 <img src="images/window_nc_prob.bmp" alt="Message displaying warning about a duplicate cell" />
105 </p>
106
107 <p>From here, you can decide to keep the cell listed for both identity (although
108 only one of them can be active at any given time), or remove the cell from all
109 the other identity and add it to
110 the current one.  Also, you can cancel the add cell request.
111 </p>
112
113 <h4>To modify a cell</h4>
114 <p>
115 <ul>
116
117 <li>Select the cell from the list of cells.  The cell name, realm and
118 method in the text boxes will be updated to display the information
119 from the cell just selected.</li>
120
121 <li>Make changes to the realm and method fields as appropriate</li>
122
123 <li>Select <span class="pre">Add / Update</span> to update the
124 information in the cell list</li>
125
126 </ul>
127 </p>
128
129 <p>Note that if you don't click the <span class="pre">Add /
130 Update</span>, the cell entry will not be updated.
131 </p>
132
133 <h4>To delete cells</h4>
134
135 <p>
136 <ul>
137
138 <li>Select the cells you want to delete from the cell list.  You can
139 select multiple cells by clicking while holding the <span
140 class="pre">Ctrl</span> key.</li>
141
142 <li>Select the <span class="pre">Delete</span> button.</span></li>
143
144 </ul>
145 </p>
146
147 <h4>Cell states</h4>
148
149 <p>When you add cells or when you view the cell list, you will see
150 an icon next to each cell name.  This icon represents the current state of
151 the cell's token.  You can double-click on the cell to get details about the
152 state.
153 </p>
154
155 <p><img src="images/window_nc_afs_2.bmp" /></p>
156
157 <p>
158 <div class="inline"><img src="images/window_nc_afs_1.bmp" /></div>
159 Token for cell <span class="pre">foo.bar</span> is a new token while
160 the token for <span class="pre">net.mit.edu</span> is in a problem
161 state.  Double clicking the problem token will display a balloon
162 prompt indicating what the problem is.
163 </p>
164
165 <a name="persistent_tokens" />
166 <h3>Changing persistent cell lists for existing identities</h3>
167
168 <p>
169 The configuration panel for a persistent identity contains a panel for
170 specifying the AFS cells.  This panel is identical to the panel used
171 by the new credentials dialog.  You can easily modify the cell lists
172 as described above and click <span class="pre">Apply</span> and you
173 are done.
174 </p>
175
176 <p>The AFS configuration panel for an identity is shown below.</p>
177
178 <p><img src="images/window_cfg_afs_0.bmp" /></p>
179
180 <p>You can reach this configuration panel by opening the configuration
181 dialog (<span class="pre">Options</span> menu), and then clicking the persistent
182 identity you wish to modify options for.</p>
183
184 </body>
185 </html>