|
|
The User Registrar Subscriber Web UI has common user interface tools that appear on every page.
The User Registrar Toolbar (Figure 2-1) appears in the upper right corner on each of the User Registrar pages. The toolbar consists of the following buttons:

Subscribers should not use their Web browser's Back button to retrace their steps. The subscriber registration is based on a wizard-like application in which one screen builds on another. If subscribers use the Back button, User Registrar displays the invalid_nav page (Figure 2-2).

You can configure User Registrar Subscriber so that no matter what URL unprovisioned subscribers type, they will always reach your Login page.
Usually when a user types a Web address, such as www.abc.com the Web browser looks for the file index.html. As a post User Registrar installation step, you might want to setup the index.html page as a welcome message whereas other customers might want to direct subscribers immediately to activation. For the latter, simply create a link or copy of the ur-redirect.html page to index.html in your web server's doc area.
For example, the user starts up a web browser on an unprovisioned system and the browser defaults to a URL on the netscape system.
http://home.netscape.com/news/online.html
The DNS server will return the IP address of home.netscape.com as the IP of ur.abc.com; however the Web browser will not know that it isn't getting a page from netscape.com.
To the server the request to ur.abc.com will look like:
http://ur.abc.com/news/online.html
One of the steps of configuring the Web server is to set up the error code for unknown page requests (404 Not Found) to return the ur-redirect page. So, when subscribers request the initial page, they are really getting:
http://ur.abc.com/csrc/ur-redirect.html
However the Web browser still thinks it is getting:
http://home.netscape.com/news/online.html
If the ur-redirect page included only a relative redirect, the web browser would request:
http://home.netscape.com/cgi-bin/gx.cgi/GXGUID-guid
If subscribers bookmarked this page, after they were subscribed, they would no longer be able to use their bookmark. To fix this, specify an absolute URL in ur-redirect.html so that, when the ur-redirect.html page is returned, the Web browser will properly display the current URL:
http://ur.abc.com/cgi-bin/gx.cgi/GXGUID-guid
User Registrar allows you to customize the main /index.html file, while the ur-redirect.html page serves as a way of automatically directing unsubscribed users to User Registrar Subscriber.
To enable redirection, do the following:
Step 1 Edit the redirection page, <csrc-root>/html/ur-redirect.html, to specify the URL of your login page.
Step 2 Configure your Web server to send all 404 (missing page) errors to /csrc/ur-redirect.html.
Step 3 On the Web server dedicated to CSRC, create a symbolic link (or copy) of the /csrc/ur-redirect.html to /index.html.
In UNIX: <on one line>
ln -s /opt/csrc/html/ur-redirect.html /usr/apache/htdocs/index.html
In NT: <on one line>
copy c:\program files\csrc\html\ur-redirect.html
c:\program files\apache\htdocs\index.html
When a subscriber starts a User Registrar session, the first page accessed is the init page. User Registrar does not display this page during normal operation.
When a subscriber starts the session, User Registrar displays one of two login pages depending on whether it recognizes the subscriber.
Figure 2-3 displays the Web page hierarchy of the login pages.

Figure 2-4 displays the page subscribers see when they access User Registrar for the first time, or if they have changed their computer or modem.

Table 2-1 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Specify account number | Requests that the subscriber enter an account number. |
Specify PIN | Requests that the subscriber enter a PIN. |
Login | Executes the login process. |
Allows you to use your user name instead of your account number to log in if you are already subscribed. |
If the subscriber neglects to enter all the information or if the information is incorrect, User Registrar displays the errors described in Table 2-2:
| Error | Action |
|---|---|
Invalid account number or PIN | Specify a valid account number. |
An account number must be specified. | Specify an account number. |
A PIN must be specified. | Specify a PIN. |
Figure 2-5 displays the page subscribers see after they have registered.

Table 2-3 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Specify user name | Requests that the subscriber enter a User Registrar log-in name. |
Specify password | Requests that the subscriber enter a password. |
Login | Executes the login process. |
Allows subscribers to log in by account number and PIN. |
If the subscriber neglects to enter all the information or if the information is incorrect, User Registrar displays the errors described in Table 2-4:
| Error | Action |
|---|---|
Invalid user name or password. | Specify a valid user name or password. |
A password must be specified. | Specify a password. |
A user name must be specified. | Specify a user name. |
When new subscribers log in, they must chose a username, password, service, and register their computer.
The following is the registration process with the associated Web page.
1. Choose user name (choose_username).
2. Confirm user name (confirm_username).
3. Choose service (choose_service).
4. Confirm service (confirm_service).
5. Register computer (activate_device).
6. Activate equipment (activate_wait or activate_reboot).
7. Congratulations (congratulations). Only displayed if you used activate_wait.
When the subscriber clicks Login on the New Subscriber Login to User Registrar page, User Registrar displays the choose_username page (Figure 2-6). This page allows subscribers to choose a username and password.
User Registrar displays the billing information for an authenticated account, which includes the account number, username, and address. This information is the Account object in the LDAP server. For more information about the Account Class, see "Account Class" section.

Table 2-5 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Specify a user name | Requests that subscribers enter the name they want to use to log in to User Registrar. |
Choose your password | Requests that subscribers enter their password. |
Confirm your password | Requests that subscribers enter their password again. |
Confirms the subscriber's user name and password. | |
Cancel | Cancels the subscriber's user name and password selection. |
If the subscriber neglects to enter all the information or if the information is incorrect, User Registrar displays the errors described in Table 2-6:
| Error | Action |
|---|---|
User name already in use. | Enter another name. |
Passwords must be at least 3 characters. | Enter a longer password. |
User names must be at least 3 characters. | Enter a longer user name. |
Passwords do not match. | Enter your password confirmation again |
You must re-enter the password. | Confirm your password. |
You must select a user name. | Enter a user name. |
You must select a password. | Enter a password. |
When the subscriber clicks Choose on the Choose User Name page, User Registrar displays the confirm_username page (Figure 2-7). This page displays the name the subscriber has chosen and gives the subscriber the choice of accepting the name or choosing another name.

Table 2-7 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Selected user name | Displays the name the subscriber entered. |
Confirms the subscriber's selection. | |
Cancels the selection and then returns the subscriber to the Choose User name page. |
When the subscriber clicks Accept on the Confirm User Name page, User Registrar displays the choose_service page (Figure 2-8). This page displays the available services and allows users to choose a service.
The information on this page is the Service object in the LDAP server. For more information about the Service class, see "Service Class" section.

Table 2-8 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Name | Displays the name of the service. |
Description | Displays the description of the service. |
Price | Displays the price of the service. |
Confirms the service change. | |
Cancel | Cancels the service change. |
If the subscriber neglects to enter all the information or if the information is incorrect, User Registrar displays the errors described in Table 2-9:
| Error | Action |
|---|---|
The service selected is not valid. | Choose another service. In a properly configured system, subscribers should never get this error. |
You must select a service. | Select a service. |
When the subscriber clicks Choose on the Choose Service Subscription page, User Registrar displays the confirm_service page (Figure 2-9). This page allows subscribers to confirm their service selection.

Table 2-10 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Service selected | Displays the service the subscriber selected. |
Confirms the subscriber's selection. | |
Allows subscribers to change their service selection. |
When the subscriber clicks Accept on the Confirm Service Subscription page, User Registrar displays the activate_device page (Figure 2-10). This page allows subscribers to register their computers.
User Registrar displays this page the first time the subscriber accesses User Registrar. For subsequent computer activations, User Registrar displays the add_computer and update_computer pages. For more information about these pages see the "Registering Computers" section.
The subscriber can choose a new hostname and description.

Table 2-11 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Choose computer name | Requests that subscribers enter the hostname of their computer. |
Choose description | Requests that subscribers enter a description for their computer. |
Verifies the hostname the subscriber chose. | |
Cancel | Exits User Registrar. |
If the subscriber neglects to enter all the information or if the information is incorrect, User Registrar displays the errors described in Table 2-12:
| Error | Action |
|---|---|
Computer already in use. | Choose another name. |
You must select a description | Enter a computer description |
When the subscriber clicks Activate on the Register Computer page, User Registrar displays the activate_wait or activate_reboot page (Figure 2-11). This page tells subscribers that User Registrar is activating their computer and modem.
You can decide whether you want subscribers to wait while User Registrar reconfigures their computer or you can ask subscribers to reboot their computers.

During the activation phase, User Registrar does the following:
When subscribers come back online, they have access to the Internet.
When registered subscribers log in to User Registrar, they can change their password service, their computer's name or description, or delete their computer.
If they have changed their computer or modem since they last logged in, User Registrar displays computer and modem registration pages so that subscribers can update that information.
Figure 2-12 displays the Web-page hierarchy for known subscribers.

When registered subscribers log in from the known_login page and their equipment has not changed since the registration, User Registrar displays the subscriber_info page (Figure 2-14). This page allows subscribers to view their current information, and make changes or deletions.
Figure 2-13 displays the Web-page hierarchy for the subscriber pages.


Table 2-13 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Account number | Displays the subscriber's account number. |
Name | Displays the subscriber's name. |
Address | Displays the subscriber's address. |
User name | Displays the subscriber's username. |
Password | Displays the subscriber's password. |
Service | Displays the service the subscriber chose. |
Name | Displays the name of the subscriber's computer. |
Description | Displays the description of the subscriber's computer. |
Sends subscribers to the Change Password page. | |
Sends subscribers to the Change Service page. | |
Sends subscribers to the Update Computer Information page. | |
Sends subscribers to the Confirm Delete Computer page. |
When the subscriber clicks Change Password on the Subscriber Information page, User Registrar displays the change_password page (Figure 2-15). This page allows subscribers to change their passwords. Subscribers must first enter their current password and then enter their new password. If User Registrar cannot authenticate the current password, the subscriber cannot create a new password.

Table 2-14 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Enter current password | Requests that subscribers enter their current password. |
Specify new password | Requests that subscribers enter a new password. |
Confirm new password | Requests that subscribers enter their password again. |
Confirms the password change. | |
Cancel | Cancels the password change. |
If the subscriber neglects to enter all of the information or if the information is incorrect, User Registrar displays the errors described in Table 2-15:
| Error | Action |
|---|---|
Passwords must be at least 3 characters | Enter a longer password. |
You current password is not correct | Enter a valid password. |
New passwords do not match. | Enter the confirmation password again. |
A new password must be specified. | Enter a password. |
Your current password must be specified. | Enter the current password. |
When the subscriber clicks Change Service on the Subscriber Information page, User Registrar displays the change_service page (Figure 2-16). This page allows subscribers to change their service type.

Table 2-16 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Name | Displays the name of the service. |
Description | Displays the description of the service. |
Price | Displays the price of the service. |
Sends the subscriber to the Confirm Service Subscription page. | |
Cancel | Cancels the service change. |
If the subscriber neglects to enter all the information or if the information is incorrect, User Registrar displays the errors described in Table 2-17:
| Error | Action |
|---|---|
The service selected is not valid. | Choose another service. In a properly configured system, subscribers should never get this error. |
You must select a service. | Select a service. |
When the subscriber clicks Choose on the Change Service page, User Registrar displays the confirm_change_service page (Figure 2-17). This page allows subscribers to confirm the change of service. The page displays the service chosen and allows subscribers to accept or change their selection.

Table 2-18 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Service selected | Displays the service the subscriber chose. |
Confirms the subscriber's selection. | |
Allows subscribers to change their service selection. |
When the subscriber clicks Accept on the Confirm Service Subscription page, User Registrar displays the update_wait or update_reboot (Figure 2-18) page. These pages tell subscribers that User Registrar is reconfiguring their equipment. For the changes to take effect, subscribers must reboot their computer.

If your site is using a separate pool of IP addresses for unrecognized devices, the computer receives a new address the next time it renews its DHCP lease. Any network connections that are open during the reconfiguration (such as an HTTP request for this page) are reset when the IP stack gets a new address. While the subscriber reboots the computer, User Registrar also reboots the CM.
User Registrar does following:
When the subscriber clicks Edit on the Subscriber Information page, User Registrar displays the update_device page (Figure 2-19). This page allows subscribers to change the name and description of their computers.

Table 2-18 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
New name | Requests that the subscriber enter a new computer name. |
New description | Requests that the subscriber enter a new description. |
Confirms the subscriber's changes. | |
Cancel | Cancels the subscriber's changes. |
If you choose a name that already exists, User Registrar displays the error message, "Computer name already in use."
When the subscriber clicks Change on the Update Computer Information page, User Registrar displays the confirm_update_device page (Figure 2-20). This page allows subscribers to confirm the computer name associated with their account.

Table 2-20 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Rename computer | Displays the new computer name and description |
Confirms the changed computer information. | |
Cancel | Cancels the change and returns to the subscriber to the Subscriber Information page. |
When the subscriber clicks Delete on the Subscriber Information page, User Registrar displays the confirm_delete_device page (Figure 2-21). This page allows subscribers to confirm the deletion of their computer name and description.

Table 2-21 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Confirm computer deletion | Displays the computer's name and description. |
Deletes the computer from the User Registrar list of registered computers. | |
Cancel | Cancels the change and returns the subscriber to the Subscriber Information page. |
When subscribers with unregistered equipment (modems and computer) attempt to log in, User Registrar displays pages that force equipment registration.
When subscribers log in with unregistered modems, User Registrar displays the unknown_modem page (Figure 2-22). This page allows subscribers to update their modem information or cancel the update.

Table 2-22 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Updates the subscriber's modem information. | |
Cancels the change and exits User Registrar. |
When subscribers log in with unregistered computers, User Registrar displays the unknown_computer page (Figure 2-23). This page allows subscribers to register a new computer or update their existing computer information.

Table 2-23 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Registers a new computer. | |
Updates the existing computer information. |
When the subscriber clicks Register new computer from the Unregistered Computer page, User Registrar displays the add_computer page (Figure 2-24). This page allows subscribers to specify a computer name and description for their new computer.

Table 2-24 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Displays the update_wait or update_reboot page. | |
Cancel | Cancels the change and exits User Registrar. |
If the subscriber neglects to enter all the information or if the information is incorrect, User Registrar displays the errors described in Table 2-25:
| Error | Action |
|---|---|
Computer name already in use. | Choose another name. |
You must select a computer name | Enter the computer name. |
When the subscriber clicks Update computer on the Unregistered Computer page, User Registrar displays the update_computer page (Figure 2-25). This page allows subscribers to reconfigure their computer or to cancel the change.
![]() | Tips Subscribers should choose this option if they are updating their NIC or if they are replacing their computer. |

Table 2-26 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Displays the update_wait or update_reboot page. | |
Cancel | Cancels the change and exits User Registrar. |
If the subscriber neglects to enter all the information or if the information is incorrect, User Registrar displays the errors described in Table 2-27:
| Error | Action |
|---|---|
The computer selected in not valid. | Select a valid computer. |
You must select an existing computer. | Select a computer in the database. |
The logout page allows subscribers to log out of User Registrar (Figure 2-26).

Table 2-28 displays the fields and buttons on this page.
| Field or Button | Description |
|---|---|
Exits a User Registrar session. | |
Cancel | Returns the subscriber to the previous page. |
The User Registrar Subscriber application has a corresponding help page for every Web page. The help consists of an HTML file with the same name as the Web page.
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Wed Aug 4 09:11:16 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.