[Top][Contents][Prev][Next][Last]Search


Reference to RADIUS Attributes


This chapter discusses RADIUS attributes found in user and pseudo-user profiles. Each listing provides information in the following format:

Attribute Name

Description: The Description text explains the attribute.

Usage: The Usage text explains the values you can specify for the attribute.

Example: The Example text presents an example of how to use the attribute.

Dependencies: The Dependencies text tells you what other information you need in order to specify the proper value for the attribute.

See Also: The See Also text points you to related information.


Note: All RADIUS attributes and settings are case sensitive.

Acct-Authentic (45)

Description: Indicates the method the MAX TNT used to authenticate a call, or reports that the MAX TNT accepted the call without authentication.

Usage: Acct-Authentic does not appear in a user profile It can have either of the following values:

Dependencies: The MAX TNT sends Acct-Authentic in an Accounting-Request packet under the following conditions:

Acct-Delay-Time (41)

Description: Indicates how many seconds the MAX TNT has been trying to send the Accounting packet.

Usage: Acct-Delay-Time does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT sends Acct-Delay-Time in an Accounting-Request packet under the following conditions:

Acct-Input-Octets (42)

Description: Indicates how many octets the MAX TNT received during the session. The value reflects only the data delivered by PPP or other encapsulation. It does not include the header or other protocol-dependent components of the packet.

Usage: Acct-Input-Octets does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT sends Acct-Input-Octets in an Accounting-Request packet, at the end of a session (Acct-Status-Type=Stop), when both of the following conditions are true:

Acct-Input-Packets (47)

Description: Indicates how many packets the MAX TNT received during the session. The packets are counted before the encapsulation is removed. The attribute's value does not include maintenance packets, such as keepalive or management packets.

Usage: Acct-Input-Packets does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT sends Acct-Input-Packets in an Accounting-Request packet, at the end of a session (Acct-Status-Type=Stop), when both of the following conditions are true:

Acct-Output-Octets (43)

Description: Indicates how many octets the MAX TNT has sent during the session. The value reflects only the data delivered by PPP or other encapsulation. It does not include the header or other protocol-dependent components of the packet.

Usage: Acct-Output-Octets does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT sends Acct-Output-Octets in an Accounting-Request packet, at the end of a session (Acct-Status-Type=Stop), when both of the following conditions are true:

Acct-Output-Packets (48)

Description: Indicates how many packets the MAX TNT has sent during the session. The packets are counted before the encapsulation is removed. The attribute's value does not include maintenance packets, such as keepalive or management packets.

Usage: Acct-Output-Packets does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT sends Acct-Output-Packets in an Accounting-Request packet, at the end of a session (Acct-Status-Type=Stop), when both of the following conditions are true:

Acct-Session-Id (44)

Description: Identifies the routing or terminal-server session reported in the Accounting-Request packet. RADIUS correlates the Accounting Start packet and Accounting Stop packet by means of Acct-Session-Id.

Usage: Acct-Session-Id does not appear in a user profile. Its value is a random number with a range from 1 to 2,137,383,647. For every session, RADIUS generates a unique session ID.

Dependencies: The MAX TNT sends Acct-Session-Id in an Accounting-Request packet under the following conditions:

In addition, consider the following:

Acct-Session-Time (46)

Description: Indicates how many seconds the session has been logged in.

Usage: Acct-Session-Time does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT sends Acct-Session-Time in an Accounting-Request packet, at the end of a session (Acct-Status-Type=Stop), when the session has been authenticated.

Acct-Status-Type (40)

Description: Indicates whether the Accounting packet the MAX TNT sends to the RADIUS server reports the beginning (Start) or end (Stop) of a routing or terminal-server session.

Usage: Acct-Status-Type does not appear in a user profile.

Dependencies: The MAX TNT includes Acct-Status-Type in an Accounting-Request packet under the following conditions:

Ascend-Add-Seconds (240)

Description: Specifies the number of seconds that average line utilization (ALU) for transmitted data must exceed the threshold indicated by the Ascend-Target-Util attribute before the MAX TNT begins adding bandwidth to a session. The MAX TNT determines the ALU for a session by applying the algorithm specified by the Ascend-History-Weigh-Type attribute.

When utilization exceeds the threshold for a period greater than the value of the Ascend-Add-Seconds attribute, the MAX TNT attempts to add the number of channels specified by the Ascend-Inc-Channel-Count attribute. Using the Ascend-Add-Seconds attribute prevents the system from continually adding bandwidth, and can slow down the process of allocating bandwidth.

Usage: Specify an integer from 1 to 300. The default value is 5.

Dependencies: Consider the following:

See Also: Configuring DBA in RADIUS,
Ascend-Base-Channel-Count (172),
Ascend-DBA-Monitor (171),
Ascend-Dec-Channel-Count (237),
Ascend-History-Weigh-Type (239),
Ascend-Inc-Channel-Count (236),
Ascend-Maximum-Channels (235),
Ascend-Minimum-Channels (173),
Ascend-Remove-Seconds (241),
Ascend-Seconds-Of-History (238), and
Ascend-Target-Util (234).

Ascend-ARA-PW (181)

Description: Specifies the password of the incoming caller over an AppleTalk Remote Access (ARA) connection. The ARA software in the MAX TNT uses DES to encrypt and decrypt the password.

Usage: Specify an alphanumeric text string containing up to 20 characters. The default value is null. The password you enter for this attribute must be identical to the password you enter in the first line of the user profile. The MAX TNT requires both entries.

Example: This example shows how to set up a TCP connection through ARA with a dynamic IP address assignment:

Emma Password="pwd"
Framed-Protocol=ARA,
Ascend-ARA-PW="pwd",
Ascend-Route-IP=Route-IP-Yes,
Ascend-Assign-IP-Pool=1
See Also: Password (2)

Ascend-Assign-IP-Pool (218)

Description: Specifies the address pool from which RADIUS assigns the user an IP address.

A dynamic address comes from the pool of addresses you set up by assigning values to the Pool-Base-Address and Assign-Count parameters in an IP-Global profile on the MAX TNT, the Ascend-IP-Pool-Definition attribute in a RADIUS profile, or both. An IP address pool you set up in RADIUS overrides an IP address pool you set up in the MAX TNT configuration interface, but only if you designate the two pools by the same number.

Usage: Specify an integer corresponding to an address pool. The default value is 1. If you set Ascend-Assign-IP-Pool=0, RADIUS chooses an address from any pool that has one available.

Example: In the following user profile, the host requests an address from pool #2:

Emma Password="m2dan", User-Service=Framed-User
Framed-Protocol=PPP,
Ascend-Route-IP=Route-IP-Yes,
Ascend-Metric=2,
Framed-Routing=None,
Ascend-Assign-IP-Pool=2
See Also: Configuring IP address pools and
Ascend-IP-Pool-Definition (217).

Ascend-Authen-Alias (203)

Description: Sets the MAX TNT unit's login name during PPP authentication.

When the MAX TNT places an outgoing call, it identifies itself by a login name and password. The login name is either its system name (as specified by the Name parameter in the System profile) or the value you specify for the Ascend-Authen-Alias attribute.

Usage: Specify a text string of up to 16 characters. The default is the value of the Name parameter in the System profile on the MAX TNT.

Example: The following example shows how to use the Ascend-Authen-Alias attribute in an outgoing profile:

Homer-Out Password="ascend", User-Service=Dialout-Framed-User
User-Name="Homer",
Ascend-Authen-Alias="myMAXTNTcallingU",
Ascend-Send-Auth=Send-Auth-PAP,
Ascend-Send-Secret="passwrd1",
Ascend-Dial-Number="31",
Framed-Protocol=PPP,
Framed-Address=10.0.100.1,
Framed-Netmask=255.255.255.0,
Ascend-Metric=2,
Framed-Routing=None,
Framed-Route="10.5.0.0/24 10.0.100.1 1",
Ascend-Idle-Limit=30

Ascend-Backup (176)

Description: Specifies the name of a backup profile for a nailed-up link. When the physical connection fails due to loss of a T1 line or serial WAN port, the MAX TNT automatically diverts traffic to the backup connection. When the primary connection is back online, traffic again uses the primary connection.

Usage: Specify the name of the profile that you want to act as the backup. The backup connection can be switched or nailed up. The default value is null.

Dependencies: Consider the following:

Ascend-BACP-Enable (133)

Description: Specifies whether Bandwidth Allocation Control Protocol (BACP) is enabled for the link.

BACP is the Internet standard protocol equivalent to the Ascend MP+ bandwidth allocation protocol. BACP functions similarly to MP+ and uses the same attributes as MP+.

Usage: Specify one of the following settings:

See Also: Setting up a Nailed/MPP connection.

Ascend-Base-Channel-Count (172)

Description: Specifies the initial number of channels the MAX TNT sets up when originating calls for a PPP, MP, or MP+ link.

Usage: The maximum number of channels you can specify depends upon the nature of the link:

The default value is 1.

Dependencies: The Ascend-Base-Channel-Count attribute does not apply when all channels of the link are nailed up (Ascend-Call-Type=Nailed). For optimum MP+ performance, both sides of a connection must set the following values to the same number:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-DBA-Monitor (171),
Ascend-Dec-Channel-Count (237),
Ascend-History-Weigh-Type (239),
Ascend-Inc-Channel-Count (236),
Ascend-Maximum-Channels (235),
Ascend-Minimum-Channels (173),
Ascend-Remove-Seconds (241),
Ascend-Seconds-Of-History (238), and
Ascend-Target-Util (234).

Ascend-Billing-Number (249)

Description: Specifies a billing number for charges incurred on the line. If you do not enter a billing number, the telephone company assigns charges to the telephone number associated with the line. Your carrier determines the billing number, and uses it to sort your bill. If you have several departments, and each department has its own Ascend-Billing-Number, your carrier can separate and tally each department's usage.

Usage: Specify a telephone number of up to ten characters, limited to the following:

1234567890()[]!z-*# |
Dependencies: The MAX TNT uses the Ascend-Billing-Number attribute differently for different types of lines:

If you specify a value for the Ascend-Billing-Number attribute, there is no guarantee that the phone company will send it to the answering device.

See Also: Setting up CLID authentication and
Caller-Id (31).

Ascend-Callback (246)

Description: Enables or disables callback.

Callback occurs when the MAX TNT answers a call and verifies a name and password against a user profile. If Ascend-Callback=Yes, the MAX TNT hangs up and dials back to the caller by using the following values:

If you set up a RADIUS user profile for callback and CLID-only authentication, the MAX TNT never answers the call. The caller therefore avoids billing charges.

Usage: Specify one of the following values:

Dependencies: The Ascend-Callback attribute applies only to incoming calls and should not appear in dial-out user profiles (when User-Service=Dialout-Framed-User).

See Also: Setting up the MAX TNT for callback.

Ascend-Call-By-Call (250)

Description: Specifies the T1 PRI service that the MAX TNT uses when placing a PPP, MP, or MP+ call.

Usage: Specify a number corresponding to the type of service the MAX TNT uses. The default value is 6. Table 14-1 lists the services available for each service provider.

Table 14-1. Ascend-Call-By-Call settings

Number

AT&T

Sprint

MCI

0

Disable call-by-call service.

Reserved

N/A

1

SDN (including GSDN)

Private

VNET/Vision

2

Megacom 800

Inwatts

800

3

Megacom

Outwatts

PRISM1, PRISM II, WATS

4

N/A

FX

900

5

N/A

Tie Trunk

DAL

6

ACCUNET Switched Digital Services

N/A

N/A

7

Long Distance Service (including AT&T World Connect)

N/A

N/A

8

International 800 (I800)

N/A

N/A

16

AT&T MultiQuest

N/A

N/A

Ascend-Call-Filter (243)

Description: Specifies the characteristics of a call filter in a RADIUS user profile. The MAX TNT uses the filter only when it places a call or receives a call associated with the profile that includes the filter definition.

Usage: Filter entries apply on a first-match basis. Therefore, the order in which you enter them is significant. If you make changes to a filter in a RADIUS user profile, the changes do not take effect until a call uses that profile.

You can specify an IP filter or a generic filter. The following subsections describe how to configure each of the filter types.

IP call filter entries
Use the following format for an IP call filter entry:

Ascend-Call-Filter="ip dir action [dstip dest_ipaddr\subnet_mask] 
[srcip src_ipaddr\subnet_mask] [proto [dstport cmp value         
[srcport cmp value] [est]]"

Note: A filter definition cannot contain newlines. The syntax appears on multiple lines here for printing purposes only.

Table 14-2 describes each element of the syntax. None of the keywords are case sensitive.

Table 14-2. IP call filter syntax elements

Element

Description

ip

Specifies an IP filter.

dir

Specifies filter direction. You can specify in (to filter packets coming into the MAX TNT) or out (to filter packets going out of the MAX TNT).

action

Specifies the action the MAX TNT should take with a packet that matches the filter. You can specify either forward or drop.

dstip dest_ipaddr
\subnet_mask

The keyword dstip enables destination-IP-address filtering. The filter applies to packets whose destination address matches the value of dest_ipaddr. If a subnet mask portion of the address is present, the MAX TNT compares only the masked bits. If you set dest_ipaddr to 0.0.0.0, or if the keyword and its IP address specification are not present, the filter matches all IP packets.

srcip src_ipaddr
\subnet_mask

The keyword srcip enables source-IP-address filtering. The filter applies to packets whose source address matches the value of src_ipaddr. If a subnet mask portion of the address is present, the MAX TNT compares only the masked bits. If you set src_ipaddr to 0.0.0.0, or if the keyword and its specification are not present, the filter matches all IP packets.

proto

Specifies a protocol specified as a name or a number. The filter applies to packets whose protocol field matches this value.The supported names and numbers are icmp (1), tcp (6), udp (17), and ospf (89). If you set proto to 0 (zero), the filter matches any protocol.

dstport cmp value

The keyword dstport enables destination-port filtering. This argument is valid only when the protocol is tcp (6) or udp (17). If you do not specify a destination port, the filter matches any port.

The cmp argument defines how to compare the specified value to the actual destination port. It can have the value <, =, >, or !=.

value can be a number or a name. Supported names and numbers are ftp-data (20), ftp (21), telnet (23), smtp (25), nameserver (42), domain (53), tftp (69), gopher (70), finger (79), www (80), kerberos (88), hostname (101), nntp (119), ntp (123), exec (512), login (513), cmd (514), and talk (517).

srcport cmp value

The keyword srcport enables source-port filtering. It is valid only when the protocol is tcp (6) or udp (17). If you do not specify a source port, the filter matches any port.

The cmp argument defines how to compare the specified value to the actual source port. It can have the value <, =, >, or !=.

value can be a number or a name. Supported names and numbers are ftp-data (20), ftp (21), telnet (23), smtp (25), nameserver (42), domain (53), tftp (69), gopher (70), finger (79), www (80), kerberos (88), hostname (101), nntp (119), ntp (123), exec (512), login (513), cmd (514), and talk (517).

est

If you set this argument to 1, the filter matches a packet only if a TCP session is already established. It is valid only when the proto specification is tcp (6).

Generic call filter entries
Use the following format for a generic call filter entry:

Ascend-Call-Filter="generic dir action offset mask value compare 
[more]"

Note: A filter definition cannot contain newlines. The syntax appears on multiple lines here for printing purposes only.

Table 14-3 describes each element of the syntax. None of the keywords are case sensitive.

Table 14-3. Generic call filter syntax elements

Element

Description

generic

Specifies a generic filter.

dir

Defines filter direction. You can specify in (to filter packets coming into the MAX TNT) or out (to filter packets going out of the MAX TNT).

action

Defines the action the MAX TNT should take with a packet that matches the filter. You can specify either forward or drop.

offset

Specifies the number of bytes masked from the start of the packet. The byte position specified by offset is called the byte-offset.

Starting at the position specified by offset, the MAX TNT applies the value of the mask argument. A mask hides the part of a number that appears behind the binary zeroes in the mask. The unit then compares the unmasked portion of the packet with the value specified by the value argument.

mask

Specifies which bits to compare in a segment of the packet. The mask must not exceed 6 bytes (12 hexadecimal digits). A one bit in the mask indicates a bit to compare. A zero bit indicates a bit to ignore. The length of the mask specifies the length of the comparison.

value

Specifies the value to compare to the packet contents at the specified offset in the packet. The length of the value must be the same as the length of the mask. Otherwise, the MAX TNT ignores the filter.

compare

Defines how the MAX TNT compares a packet's contents to the value specified by value. You can specify == (for Equal) or != (for NotEqual). Equal is the default.

more

If present, specifies whether the MAX TNT applies the next filter definition in the profile to the current packet before deciding whether to forward or drop the packet.

The dir and action values for the next entry must be the same as the dir and action values for the current entry. Otherwise, the MAX TNT ignores the more flag.

Example: The following are examples of IP call filter entries:

Ascend-Call-Filter="ip in drop"
Ascend-Call-Filter="ip out forward tcp"
Ascend-Call-Filter="ip out forward tcp dstip 10.0.200.3/16 srcip 
10.0.200.25/16 dstport!=telnet"
Ascend-Call-Filter="ip out forward tcp dstip 10.0.200.3/16 srcip 
10.0.200.25/16 icmp"
The following are examples of generic call filter entries:

Ascend-Call-Filter="generic in drop 0 ffff 0080"
Ascend-Call-Filter="generic in drop 0 ffff != 0080 more"
Ascend-Call-Filter="generic in drop 16 ff aa"
See Also: Ascend-Data-Filter (242).

Ascend-Call-Type (177)

Description: Specifies the type of nailed-up connection in use.

Usage: Table 14-4 lists the settings you can specify for Ascend-Call-Type.

Table 14-4. Ascend-Call-Type settings

Setting

Specifies

Nailed (1)

Link that consists entirely of nailed-up channels. Nailed is the default.

Nailed/Mpp (2)

Link that consists of both nailed-up and switched channels. The MAX TNT establishes the connection whenever any of its nailed-up or switched channels are connected end-to-end. If a Nailed/Mpp link is down and the nailed-up channels are down, the link cannot re-establish itself until the MAX TNT brings up one or more of the nailed-up channels, or dials one or more switched channels.

Typically, the MAX TNT dials the switched channels when it receives a packet whose destination is the unit at the remote end of the Nailed/Mpp connection. The packet initiating the switched call must come from the caller side of the connection.

If a failed channel is in the group specified by the Ascend-Group attribute, the MAX TNT replaces that channel with a switched channel, even if the call is online with more than the minimum number of channels. The MAX TNT always replaces failed nailed-up channels with switched channels, regardless of the Ascend-Minimum-Channels setting.

Perm/Switched (3)

Permanent switched connection (an outbound call that the MAX TNT attempts to keep up at all times). If the unit or central switch resets, or if one end terminates the link, the permanent switched connection attempts to restore the link at ten-second intervals. Use this setting if your telephone company charges for each incoming and outgoing connection attempt, but does not charge for connection time on local calls. Ascend's regular bandwidth-on-demand feature conserves connection time but causes many connection attempts. A permanent switched connection performs the opposite function. It conserves connection attempts but causes a long connection time.

For the answering device at the remote end of the permanent switched connection, Ascend recommends that you configure the Connection profile to answer calls but not originate them. If the remote device initiates a call, the MAX TNT simply does not answer it. This situation could result in repeated charges for calls that have no purpose. To keep the remote device from originating calls, set Answer-Originate=Ans-Only for that device.

Dependencies: The MAX TNT adds or subtracts switched channels on a Nailed/Mpp connection as the settings on either side of the connection require. Each side makes its calculations on the basis of the traffic it receives at that side. If the two sides of the connection disagree on the number of channels needed, the side requesting the greater number prevails.

Ascend-Client-Assign-DNS (137)

Description: Specifies whether or not the MAX TNT sends the Ascend-Client-Primary-DNS and Ascend-Client-Secondary-DNS values during connection negotiation.

Usage: Specify one of the following settings:

Dependencies: To direct the MAX TNT to send the client DNS server address during connection negotiation, you must include the setting Ascend-Client-Assign-DNS=DNS-Assign-Yes, and specify a valid DNS server by means of the Ascend-Client-Primary-DNS or Ascend-Client-Secondary-DNS attribute.

See Also: Setting up access to specific DNS servers,
Ascend-Client-Primary-DNS (135), and
Ascend-Client-Secondary-DNS (136).

Ascend-Client-Gateway (132)

Description: Specifies the default route for IP packets coming from the user on a connection.

Usage: Specify the IP address of the next-hop router in dotted decimal notation. The default value is 0.0.0.0. If you accept the default, the Ascend unit routes packets as specified in the routing table, using the system-wide default route if it cannot find a more specific route.

Dependencies: The Ascend unit must have a direct route to the address you specify. The direct route can come from a profile or an Ethernet connection. If the Ascend unit does not have a direct route, it drops the packets on the connection. When you diagnose routing problems with a profile that includes a default route, an error in a per-user gateway address is not apparent from inspection of the global routing table.

Example: If you specify Ascend-Client-Gateway=10.0.0.3 in the RADIUS user profile
Berkeley, IP packets from the user with destinations through the default route go through the router at 10.0.0.3.

Ascend-Client-Primary-DNS (135)

Description: Specifies a primary DNS server address to send to any client connecting to the MAX TNT.

Usage: Specify the IP address of the primary DNS server. You must specify the address in dotted decimal notation. The default is 0.0.0.0, which specifies that no primary DNS server is available for the connection. If you do not specify Ascend-Client-Primary-DNS or Ascend-Client-Secondary-DNS in any user profile, the Ascend unit routes packets as specified in the routing table, using the system-wide default route if it cannot find a more specific route.

Dependencies: You must include the setting Ascend-Client-Assign-DNS=DNS-Assign-Yes to direct the MAX TNT to send the primary DNS server address during connection negotiation.

See Also: Setting up access to specific DNS servers,
Ascend-Client-Assign-DNS (137), and
Ascend-Client-Secondary-DNS (136).

Ascend-Client-Secondary-DNS (136)

Description: Specifies a secondary DNS server address to send to any client connecting to the MAX TNT.

Usage: Specify the IP address of the secondary DNS server. You must specify the address in dotted decimal notation. The default is 0.0.0.0, which specifies that no primary DNS server is available for the connection. If you do not specify Ascend-Client-Primary-DNS or Ascend-Client-Secondary-DNS in any user profile, the Ascend unit routes packets as specified in the routing table, using the system-wide default route if it cannot find a more specific route.

Dependencies: You must include the setting Ascend-Client-Assign-DNS=DNS-Assign-Yes to direct the MAX TNT to send the secondary DNS server address during connection negotiation.

See Also: Setting up access to specific DNS servers,
Ascend-Client-Assign-DNS (137), and
Ascend-Client-Primary-DNS (135).

Ascend-Connect-Progress (196)

Description: Indicates the state of the connection before it disconnects.

Usage: Ascend-Connect-Progress can have any one of values specified in Table 14-5.

Table 14-5. Ascend-Connect-Progress codes

Code

Explanation

0

No progress.

1

Not applicable.

2

The progress of the call is unknown.

10

The call is up.

30

The modem is up.

31

The modem is waiting for DCD.

32

The modem is waiting for result codes.

40

The terminal-server session has started up.

41

The MAX TNT is establishing the TCP connection.

42

The MAX TNT is establishing the immediate Telnet connection.

43

The MAX TNT has established a raw TCP session with the host. This code does not imply that the user has logged into the host.7

44

The MAX TNT has established an immediate Telnet connection with the host. This code does not imply that the user has logged into the host.

45

The MAX TNT is establishing an Rlogin session.

46

The MAX TNT has established an Rlogin session with the host. This code does not imply that the user has logged into the host.

60

The LAN session is up.

61

LCP negotiations are allowed.

62

CCP negotiations are allowed.

63

IPNCP negotiations are allowed.

65

LCP is in the Open state.

66

CCP is in the Open state.

67

IPNCP is in the Open state.

69

LCP is in the Initial state.

70

LCP is in the Starting state.

71

LCP is in the Closed state.

72

LCP is in the Stopped state.

73

LCP is in the Closing state.

74

LCP is in the Stopping state.

75

LCP is in the Request Sent state.

76

LCP is in the ACK Received state.

77

LCP is in the ACK Sent state.

80

IPXNCP is in the Open state.

Dependencies: The MAX TNT includes Ascend-Connect-Progress in an Accounting-Request packet when the session has ended or has failed authentication (Acct-Status-Type=Stop).

Ascend-Data-Filter (242)

Description: Specifies the characteristics of a data filter in a RADIUS user profile. The MAX TNT uses the filter only when it places or receives a call associated with the profile that includes the filter definition.

Usage: Filter entries apply on a first-match basis. Therefore, the order in which you enter them is significant. If you make changes to a filter in a RADIUS user profile, the changes do not take effect until a call uses that profile.

You can specify an IP filter or a generic filter. The following sections describe how to configure each of the filter types.

IP data filter entries
Use the following format for an IP data filter entry:

Ascend-Data-Filter="ip dir action [dstip dest_ipaddr\subnet_mask] 
[srcip src_ipaddr\subnet_mask] [proto [dstport cmp value] 
[srcport cmp value] [est]]"

Note: A filter definition cannot contain newlines. The syntax appears on multiple lines here for printing purposes only.

Table 14-6 describes each element of the syntax. None of the keywords are case sensitive.

Table 14-6. IP data filter syntax elements

Element

Description

ip

Specifies an IP filter.

dir

Specifies filter direction. You can specify in (to filter packets coming into the MAX TNT) or out (to filter packets going out of the MAX TNT).

action

Specifies the action the MAX TNT should take with a packet that matches the filter. You can specify either forward or drop.

dstip dest_ipaddr
\subnet_mask

The keyword dstip enables destination-IP-address filtering. The filter applies to packets whose destination address matches the value of dest_ipaddr. If a subnet mask portion of the address is present, the MAX TNT compares only the masked bits. If you set dest_ipaddr to 0.0.0.0, or if the keyword and its IP address specification are not present, the filter matches all IP packets.

srcip src_ipaddr
\subnet_mask

The keyword srcip enables source-IP-address filtering. The filter applies to packets whose source address matches the value of src_ipaddr. If a subnet mask portion of the address is present, the MAX TNT compares only the masked bits. If you set src_ipaddr to 0.0.0.0, or if the keyword and its specification are not present, the filter matches all IP packets.

proto

Specifies a protocol specified as a name or a number. The filter applies to packets whose protocol field matches this value.The supported names and numbers are icmp (1), tcp (6), udp (17), and ospf (89). If you set proto to 0 (zero), the filter matches any protocol.

dstport cmp value

The keyword dstport enables destination-port filtering. This argument is valid only when the protocol is tcp (6) or udp (17). If you do not specify a destination port, the filter matches any port.

The cmp argument defines how to compare the specified value to the actual destination port. It can have the value <, =, >, or !=.

value can be a number or a name. Supported names and numbers are ftp-data (20), ftp (21), telnet (23), smtp (25), nameserver (42), domain (53), tftp (69), gopher (70), finger (79), www (80), kerberos (88), hostname (101), nntp (119), ntp (123), exec (512), login (513), cmd (514), and talk (517).

srcport cmp value

The keyword srcport enables source-port filtering. It is valid only when the protocol is tcp (6) or udp (17). If you do not specify a source port, the filter matches any port.

The cmp argument defines how to compare the specified value to the actual source port. It can have the value <, =, >, or !=.

value can be a number or a name. Supported names and numbers are ftp-data (20), ftp (21), telnet (23), smtp (25), nameserver (42), domain (53), tftp (69), gopher (70), finger (79), www (80), kerberos (88), hostname (101), nntp (119), ntp (123), exec (512), login (513), cmd (514), and talk (517).

est

If you set this argument to 1, the filter matches a packet only if a TCP session is already established. It is valid only when the proto specification is tcp (6).

Generic data filter entries
Use the following format for a generic data filter entry:

Ascend-Data-Filter="generic dir action offset mask value compare 
[more]"

Note: A filter definition cannot contain newlines. The syntax appears on multiple lines here for printing purposes only.

Table 14-7 describes each element of the syntax. None of the keywords are case sensitive.

Table 14-7. Generic data filter syntax elements

Element

Description

generic

Specifies a generic filter.

dir

Defines filter direction. You can specify in (to filter packets coming into the MAX TNT) or out (to filter packets going out of the MAX TNT).

action

Defines the action the MAX TNT should take with a packet that matches the filter. You can specify either forward or drop.

offset

Specifies the number of bytes masked from the start of the packet. The byte position specified by offset is called the byte-offset.

Starting at the position specified by offset, the MAX TNT applies the value of the mask argument. A mask hides the part of a number that appears behind the binary zeroes in the mask. The unit then compares the unmasked portion of the packet with the value specified by the value argument.

mask

Specifies which bits to compare in a segment of the packet. The mask must not exceed 6 bytes (12 hexadecimal digits). A one bit in the mask indicates a bit to compare. A zero bit indicates a bit to ignore. The length of the mask specifies the length of the comparison.

value

Specifies the value to compare to the packet contents at the specified offset in the packet. The length of the value must be the same as the length of the mask. Otherwise, the MAX TNT ignores the filter.

compare

Defines how the MAX TNT compares a packet's contents to the value specified by value. You can specify == (for Equal) or != (for NotEqual). Equal is the default.

more

If present, specifies whether the MAX TNT applies the next filter definition in the profile to the current packet before deciding whether to forward or drop the packet. The dir and action values for the next entry must be the same as the dir and action values for the current entry. Otherwise, the MAX TNT ignores the more flag.

Example: The following are examples of IP data filter entries:

Ascend-Data-Filter="ip in drop"
Ascend-Data-Filter="ip out forward tcp"
Ascend-Data-Filter="ip out forward tcp dstip 10.0.200.3/16 srcip 
10.0.200.25/16 dstport!=telnet"
Ascend-Data-Filter="ip out forward tcp dstip 10.0.200.3/16 srcip 
10.0.200.25/16 icmp"
The following are examples of generic data filter entries:

Ascend-Data-Filter="generic in drop 0 ffff 0080"
Ascend-Data-Filter="generic in drop 0 ffff != 0080 more"
Ascend-Data-Filter="generic in drop 16 ff aa"
See Also: Ascend-Call-Filter (243).

Ascend-Data-Rate (197)

Description: Specifies the rate of data received on the connection in bits per second.

Usage: Ascend-Data-Rate does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT includes Ascend-Data-Rate in an Accounting-Request packet when the session has ended or has failed authentication (Acct-Status-Type=Stop).

Ascend-Data-Svc (247)

Description: Specifies the type of data service the link uses for outgoing calls.

Usage: Set the Ascend-Data-Svc attribute to one of the values listed in Table 14-8. The data service you specify must be available end-to-end.

Table 14-8. Ascend-Data-Svc settings

Setting

Description

Switched-Voice-Bearer (0)

Applies only to calls made over a T1 PRI line. The MAX TNT enables the network to place an end-to-end digital voice call for transporting data when a switched data service is not available.

Switched-56KR (1)

Contains restricted data, guaranteeing that the data the MAX TNT transmits meets the density restrictions of D4-framed T1 lines. D4 specifies the D4 format, also known as the Superframe format, for framing data at the physical layer. This format consists of 12 consecutive frames separated by framing bits.

The call connects to the Switched-56 data service. The only services available to lines that use inband signaling (T1 access lines containing one or more switched channels, and Switched-56 lines) are Switched-56K and Switched-56KR.

Switched-64K (2)

Contains any type of data and connects to the Switched-64 data service.

Switched-64KR (3)

Contains restricted data and connects to the Switched-64 data service.

Switched-56K (4)

Contains any type of data and connects to the Switched-56 data service. The only services available to lines that use inband signaling (T1 access lines containing one or more switched channels, and Switched-56 lines) are Switched-56K and Switched- 56KR. For most T1 PRI lines, select Switched-56K.

Nailed-56KR (1)

Contains restricted data and connects to the Nailed-56 data service.

Nailed-64K (2)

Contains any type of data and connects to the Nailed-64 data service.

Switched-384KR
Contains restricted data, and connects to MultiRate or GloBanD data services at 384 Kbps.

Switched-384K
Contains any type of data and connects to the Switched-384 data service. This AT&T data service does not require MultiRate or GloBanD.

Switched-1536K
Contains any type of data and connects to the Switched-1536 data service at 1536 Kbps. This setting is valid only for a MAX TNT that supports ISDN D-channel signaling, and connects to two or more T1 PRI lines that use Non-Facility Associated Signaling (NFAS).

Switched-1536KR
Contains restricted data, and connects to the Switched-1536 data service at 1536 Kbps. This setting is valid only for a MAX TNT that supports ISDN D-channel signaling, and is connected to two or more T1 PRI lines that use Non-Facility Associated Signaling (NFAS).

Switched-128K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-192K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-256K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-320K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-384K-MR
Available on a T1 PRI line with the MultiRate data service.

Switched-448K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-512K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-576K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-640K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-704K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-768K
Available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-832K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-896K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-960K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1024K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1088K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1152K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1216K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1280K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1344K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1408K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1472K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1600K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1664K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1728K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1792K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1856K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-1920K
Available on a T1 PRI line with MultiRate or GloBanD data
Switched-restricted-bearer-x30
Specifies 56-Kbps X.30 switched service from DPNSS and DASS 2 switches.

Switched-restricted-64-x30
Specifies 64-Kbps X.30 switched service from DPNSS and DASS 2 switches. For most DASS 2 and DPNSS installations, select Switched-restricted-64-x30.

Switched-modem
Places an outgoing call on any available digital modem. If no digital modems are available, the MAX TNT does not place the call. The data rate depends on the quality of the connections between modems and the types of modems used. The Switched-modem setting requires that your MAX TNT have digital modems installed. The setting applies only for PPP and MP+ calls. Currently, the MAX TNT does not support multichannel modem calls.

Dependencies: Consider the following:

Ascend-DBA-Monitor (171)

Description: Specifies how the Ascend calling unit monitors the traffic on an MP+ call. The Ascend unit can use the information to add or subtract bandwidth as necessary.

Usage: Specify one of the following values:

Dependencies: Consider the following:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-Base-Channel-Count (172),
Ascend-Dec-Channel-Count (237),
Ascend-History-Weigh-Type (239),
Ascend-Inc-Channel-Count (236),
Ascend-Maximum-Channels (235),
Ascend-Minimum-Channels (173),
Ascend-Remove-Seconds (241),
Ascend-Seconds-Of-History (238), and
Ascend-Target-Util (234).

Ascend-Dec-Channel-Count (237)

Description: Specifies the number of channels the MAX TNT removes when bandwidth changes during a call.

Usage: Specify a number from 1 to 32. The default value is 1.

Dependencies: Consider the following:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-Base-Channel-Count (172),
Ascend-DBA-Monitor (171),
Ascend-History-Weigh-Type (239),
Ascend-Inc-Channel-Count (236),
Ascend-Maximum-Channels (235),
Ascend-Minimum-Channels (173),
Ascend-Remove-Seconds (241),
Ascend-Seconds-Of-History (238), and
Ascend-Target-Util (234).

Ascend-Dialout-Allowed (131)

Description: Specifies whether the user associated with an outgoing RADIUS user profile can use one of the MAX TNT unit's digital modems to dial out.

Usage: Specify one of the following settings:

See Also: Controlling access to digital modems.

Ascend-Dial-Number (227)

Description: Specifies the phone number the MAX TNT dials to reach the router or node at the remote end of the link.

Usage: Specify a telephone number of up to 21 characters, limited to the following:

1234567890()[]!z-*#|
The MAX TNT sends only the numeric characters to place a call. The default value is null.

Dependencies: If Use-Trunk-Groups=Yes in the System profile, the first digits in the Ascend-Dial-Number attribute have the meanings listed in Table 14-9.

Table 14-9. Ascend-Dial-Number digits

First digit

Significance

4 through 9

The MAX TNT places the call over the corresponding trunk group listed in the Trunk-Group parameter.

3

The MAX TNT places the call to a destination listed in a Call-Route profile. The second and third digits specify the number of the Call-Route profile.

2

The MAX TNT places the call between host ports on the same MAX TNT.

If you enter 0 (zero) for the second digit, the call connects to any available serial port and ignores the third digit. If you enter a nonzero value for the second digit, the third digit selects the serial port.

If you enter 0 (zero) for the third digit, the call connects to any available serial port in the module selected by the second digit.

Ascend-Disconnect-Cause (195)

Description: Indicates the reason a connection went offline.

Usage: Ascend-Disconnect-Cause can return any of the values listed in Table 14-10.

Table 14-10. Ascend-Disconnect-Cause codes

Code

Description

0

No reason.

1

The event was not a disconnect.

2

The reason for the disconnect is unknown. The code can appear when the remote connection goes down.

3

The call has disconnected.

4

CLID authentication has failed.

The following codes can appear if a disconnect occurs during the initial modem connection.

10

The modem never detected DCD.

11

The modem detected DCD, but became inactive.

12

The result codes could not be parsed.

The following codes are related to immediate Telnet and raw TCP disconnects during a terminal-server session.

20

The user exited normally from the terminal server.

21

The user exited from the terminal server because the idle timer expired.

22

The user exited normally from a Telnet session.

23

The user could not switch to SLIP or PPP because the remote host had no IP address or because the dynamic pool could not assign one.

24

The user exited normally from a raw TCP session.

25

The login process ended because the user failed to enter a correct password after three attempts.

26

The raw TCP option is not enabled.

27

The login process ended because the user typed Ctrl-C.

28

The terminal-server session has ended.

29

The user closed the virtual connection.

30

The virtual connection has ended.

31

The user exited normally from an Rlogin session.

32

The user selected an invalid Rlogin option.

33

The MAX TNT has insufficient resources for the terminal-server session.

The following codes concern PPP connections.

40

PPP LCP negotiation timed out while waiting for a response from a peer.

41

There was a failure to converge on PPP LCP negotiations.

42

PPP PAP authentication failed.

43

PPP CHAP authentication failed.

44

Authentication failed from the remote server.

45

The peer sent a PPP Terminate Request.

46

LCP got a close request from the upper layer while LCP was in an open state.

47

LCP closed because no NCPs were open.

48

LCP closed because it could not determine to which MP bundle it should add the user.

49

LCP closed because the MAX TNT could not add any more channels to an MP session.

The following codes are related to immediate Telnet and raw TCP disconnects, and contain more specific information than the Telnet and TCP codes listed earlier in this table.

50

The Raw TCP or Telnet internal session tables are full.

51

Internal resources are full.

52

The IP address for the Telnet host is invalid.

53

The MAX TNT could not resolve the hostname.

54

The MAX TNT detected a bad or missing port number.

The TCP stack can return the following disconnect codes during an immediate Telnet or raw TCP session.

60

The host reset the TCP connection.

61

The host refused the TCP connection.

62

The TCP connection timed out.

63

A foreign host closed the TCP connection.

64

The TCP network was unreachable.

65

The TCP host was unreachable.

66

The TCP network was administratively unreachable.

67

The TCP host was administratively unreachable.

68

The TCP port was unreachable.

The following are additional disconnect codes.

100

The session timed out because there was no activity on a PPP link.

101

The session failed for security reasons.

120

One end refused the call because the protocol was disabled or unsupported.

150

RADIUS requested the disconnect.

170

PPP authentication has timed out.

180

The call disconnected as the result of a local hangup.

185

The call disconnected because the remote end hung up. The disconnection might have occurred because authentication failed, modem negotiation failed, the remote modem or device was turned off, or the remote device issued a Hangup command.

190

The call disconnected because the T1 line that carried it was quiesced.

195

The call disconnected because the call duration exceeded the maximum amount of time allowed by the Ascend-Maximum-Call-Duration attribute.

Dependencies: The MAX TNT includes Ascend-Disconnect-Cause in an Accounting-Request packet when the session has ended or has failed authentication (Acct-Status-Type=Stop).

Ascend-Event-Type (150)

Description: Indicates one of the following:

Usage: For a cold-start notification, Ascend-Event-Type=Ascend-Coldstart (1). For a session event, Ascend-Event-Type=Ascend-Session-Event (2).

Dependencies: In a cold-start notification, the MAX TNT sends values for NAS-Identifier, Ascend-Event-Type, and Ascend-Number-Sessions in an Ascend-Access-Event-Request packet (code 33). The RADIUS accounting server must send back an Ascend-Access-Event-Response packet (code 34) with the correct identifier to the MAX TNT.

In a session event, the MAX TNT sends values for Password, NAS-Identifier, Ascend-Access-Event-Type, and Ascend-Number-Sessions in an Ascend-Access-Event-Request packet (code 33). The authentication server must send back an Ascend-Access-Event-Response packet (code 34) with the correct identifier to the MAX TNT.

See Also: Ascend-Number-Sessions (202) and
NAS-Identifier (4).

Ascend-Expect-Callback (149)

Description: Specifies whether a user dialing out should expect the remote end to call back.

Usage: Specify one of the following values:

See Also: Ascend-Callback (246).

Ascend-First-Dest (189)

Description: Records the destination IP address of the first packet the MAX TNT receives on a link after RADIUS authenticates the connection.

Usage: Ascend-First-Dest does not appear in a user profile and has no default value.

Dependencies: Ascend-First-Dest applies only if the session routes IP. The MAX TNT includes Ascend-First-Dest in an Accounting-Request packet when both of the following conditions are true:

Ascend-Force-56 (248)

Description: Specifies whether the MAX TNT uses only the 56-Kbps portion of a channel, even when all 64 Kbps appear to be available:

Usage: Specify one of the following values:

Dependencies: Set Ascend-Force-56=Force-56-Yes when you place calls to European or Pacific Rim countries from within North America and the complete path cannot distinguish between the Switched-56 and Switched-64 data services.

Ascend-FR-Circuit-Name (156)

Description: Specifies the Permanent Virtual Connection (PVC) for which the user profile is an endpoint. A circuit specification defines two DLCI endpoints of a PVC, with one endpoint specified in each RADIUS user profile or Connection profile.

Usage: Specify a text string of up to 15 characters. The default value is null.

Dependencies: Consider the following:

See Also: Configuring a Frame Relay circuit connection.

Ascend-FR-DCE-N392 (162)

Description: Specifies the number of errors, during Ascend-FR-DCE-N393-monitored events, that causes the network side to declare the user side's procedures inactive.

Usage: Specify an integer from 1 to 10. The default value is 3.

Dependencies: Consider the following:

See Also: Ascend-FR-DCE-N393 (164) and
Ascend-FR-Type (159).

Ascend-FR-DCE-N393 (164)

Description: Specifies the DCE-monitored event count. The MAX TNT considers a link active if the event count does not reach the value of Ascend-FR-DCE-N393.

Usage: Specify a number from 1 to 10. The default value is 4.

Dependencies: The Ascend-FR-DCE-N393 attribute does not apply if Ascend-FR-Type=Ascend-FR-DTE.

See Also: Ascend-FR-Type (159).

Ascend-FR-Direct (219)

Description: Specifies whether the MAX TNT uses a direct connection for Frame Relay packets.

Usage: Specify one of the following values:

See Also: Direct connections (rarely used),
Configuring a Frame Relay direct connection,
Ascend-FR-Direct-DLCI (221), and
Ascend-FR-DLCI (179).

Ascend-FR-Direct-DLCI (221)

Description: Specifies the Data Link Connection Indicator (DLCI) for the user profile in a Frame Relay direct connection.

Usage: Specify an integer from 16 to 991. The default value is 16. Many direct connections can use the same DLCI.

Dependencies: Ascend-FR-Direct-DLCI applies only if Ascend-FR-Direct=FR-Direct-Yes.

See Also: Direct connections (rarely used),
Configuring a Frame Relay direct connection,
Ascend-FR-Direct (219), and
Ascend-FR-Direct-Profile (220).

Ascend-FR-Direct-Profile (220)

Description: Specifies the name of the Frame Relay profile that carries the direct connection.

Usage: Specify the name of a Frame Relay profile. This profile connects to the Frame Relay switch handling the Data Link Connection Indicator (DLCI) specified by Ascend-FR-Direct-DLCI. You can specify up to 15 alphanumeric characters. The default value is null.

Dependencies: Ascend-FR-Direct-Profile applies only if Ascend-FR-Direct=FR-Direct-Yes.

See Also: Direct connections (rarely used),
Configuring a Frame Relay direct connection,
Ascend-FR-Direct (219), and
Ascend-FR-Direct-DLCI (221).

Ascend-FR-DLCI (179)

Description: Specifies the Data Link Connection Indicator (DLCI) for the user profile in a Frame Relay gateway connection.

Usage: Specify an integer from 16 to 991. The default value is 16. You must assign each gateway connection its own DLCI.

Dependencies: Ascend-FR-DLCI applies only if Ascend-FR-Direct=FR-Direct-No.

See Also: Gateway connections,
Configuring a Frame Relay gateway connection,
Ascend-FR-Direct (219), and
Ascend-FR-Profile-Name (180).

Ascend-FR-DTE-N392 (163)

Description: Specifies the number of errors, during Ascend-FR-DTE-N393-monitored events, that causes the user side to declare the network side's procedures inactive.

Usage: Specify an integer from 1 to 10. The default value is 3.

Dependencies: Consider the following:

See Also: Ascend-FR-DTE-N393 (165) and
Ascend-FR-Type (159).

Ascend-FR-DTE-N393 (165)

Description: Specifies the DTE-monitored event count. The MAX TNT considers a link active if the event count does not reach the value of Ascend-FR-DTE-N393.

Usage: Specify a number from 1 to 10. The default value is 4.

Dependencies: The Ascend-FR-DTE-N393 attribute does not apply if Ascend-FR-Type=Ascend-FR-DCE.

See Also: Ascend-FR-Type (159).

Ascend-FR-Link-Mgt (160)

Description: Specifies the link management protocol the MAX TNT uses to communicate with the Frame Relay switch.

Usage: Specify one of the following values:

See Also: Setting up the logical link to a Frame Relay switch.

Ascend-FR-N391 (161)

Description: Specifies the interval, in seconds, at which the MAX TNT requests a Full Status Report. If you configure a Frame Relay connection for link management, it regularly requests updates on the status of the link. If the Frame Relay unit at the other end of the link does not respond to the requests, or if the response indicates a DLCI failure, the MAX TNT considers the link inactive.

Usage: Specify an integer from 1 to 255. The default value is 6.

Dependencies: The Ascend-FR-N391 attribute does not apply if Ascend-FR-Type=Ascend-FR-DCE.

See Also: Ascend-FR-Type (159).

Ascend-FR-Nailed-Grp (158)

Description: Associates a group of nailed-up channels with the Frame Relay profile.

Usage: Specify a number from 1 to the maximum number of nailed-up channels that your MAX TNT allows. The default value is 1.

Dependencies: Do not associate a group with more than one active Frame Relay profile.

See Also: Setting up Frame Relay user connections.

Ascend-FR-Profile-Name (180)

Description: Specifies the name of the Frame Relay profile that carries the gateway connection.

Usage: Specify the name of a Frame Relay profile. This profile connects to the Frame Relay switch handling the Data Link Connection Indicator (DLCI) specified by Ascend-FR-DLCI. You can specify up to 15 alphanumeric characters. The default value is null.

Dependencies: Ascend-FR-Profile-Name applies only if Ascend-FR-Direct=FR-Direct-No.

See Also: Gateway connections,
Configuring a Frame Relay gateway connection,
Ascend-FR-Direct (219), and
Ascend-FR-DLCI (179).

Ascend-FR-T391 (166)

Description: Specifies the Link Integrity Verification polling timer.

Usage: Specify a number of seconds from 5 to 30. The default value is 10.

Dependencies: The Ascend-FR-T391 attribute does not apply if Ascend-FR-Type=Ascend-FR-DCE.

See Also: Ascend-FR-Type (159).

Ascend-FR-T392 (167)

Description: Sets up the timer for the verification of the polling cycle (the length of time the MAX TNT should wait between Status Enquiry messages). The MAX TNT records an error if it does not receive a Status Enquiry within the number of seconds you specify.

Usage: Specify a number of seconds from 5 to 30. The default value is 10.

Dependencies: The Ascend-FR-T392 attribute does not apply if Ascend-FR-Type=Ascend-FR-DTE.

See Also: Ascend-FR-Type (159).

Ascend-FR-Type (159)

Description: Specifies the type of Frame Relay connection that the Frame Relay profile uses.

Usage: Specify one of the following values:

See Also: Types of logical links between the MAX TNT and a Frame Relay switch.

Ascend-FT1-Caller (175)

Description: Specifies whether the MAX TNT initiates an FT1-B&O call, or waits for the remote end to initiate these types of calls.

Usage: Specify one of the following values:

Dependencies: If the remote end has FT1-Caller=No (in a Connection profile) or Ascend-FT1-Caller=FT1-No (in a RADIUS user profile), set Ascend-FT1-Caller=FT1-Yes in the RADIUS user profile for the local MAX TNT. But if the remote end has FT1-Caller=Yes or Ascend-FT1-Caller=FT1-Yes, set Ascend-FT1-Caller=FT1-No in the user profile for the local MAX TNT.

Ascend-Group (178)

Description: Points to the nailed-up channels used by the profile's WAN link.

Usage: Your usage depends upon the value you specify for the Ascend-Call-Type attribute:

Dependencies: Consider the following:

Example: If you set the Ascend-Group attribute to "1,3,5,7" and Ascend-Call-Type=Nailed/Mpp, the MAX TNT assigns four nailed-up groups to the profile.

Ascend-History-Weigh-Type (239)

Description: Specifies which Dynamic Bandwidth Allocation (DBA) algorithm to use for calculating average line utilization (ALU) of transmitted data.

Usage: Specify one of the following settings:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-Base-Channel-Count (172),
Ascend-DBA-Monitor (171),
Ascend-Dec-Channel-Count (237),
Ascend-Inc-Channel-Count (236),
Ascend-Maximum-Channels (235),
Ascend-Minimum-Channels (173),
Ascend-Remove-Seconds (241),
Ascend-Seconds-Of-History (238), and
Ascend-Target-Util (234).

Ascend-Home-Agent-IP-Addr (183)

Description: Indicates the IP address of the home agent used for the mobile client.

Usage: The Ascend-Home-Agent-IP-Addr attribute appears in an accounting Stop record under the following conditions:

See Also: Understanding accounting records.

Ascend-Home-Agent-Password (184)

Description: Specifies the password that the foreign agent sends to the home agent during Ascend Tunnel Management Protocol (ATMP) operation. The password must match the value of the home agent's ATMP-Home-Agent-Password parameter in the ATMP subprofile of the IP-Interface profile. All mobile clients accessing a single home agent must specify the same password.

Usage: Specify a text string of up to 20 characters. The default value is null.

See Also: Setting up an ATMP tunnel for an IP network.

Ascend-Home-Agent-UDP-Port (186)

Description: Specifies the UDP port number to which the foreign agent directs Ascend Tunnel Management Protocol (ATMP) messages.

Usage: Specify a UDP port number from 0 to 65535. The default value is 5150.

Dependencies: If you specify a value for the udp_port argument of Ascend-
Primary-Home-Agent or Ascend-Secondary-Home-Agent, or if you accept the default of 5150 for udp_port, you need not specify the Ascend-Home-Agent-UDP-Port attribute.

See Also: Setting up an ATMP tunnel for an IP network,
Ascend-Primary-Home-Agent (129), and
Ascend-Secondary-Home-Agent (130).

Ascend-Home-Network-Name (185)

Description: Specifies the name of the Connection profile that defines the link on which the home agent sends all packets it receives from the mobile client during Ascend Tunnel Management Protocol (ATMP) operation.

Usage: Specify the name of the home agent's Connection profile. The default value is null.

Dependencies: You must specify a value for the Ascend-Home-Network-Name attribute only if the home agent is a gateway.

See Also: Setting up an ATMP tunnel for an IP network.

Ascend-Host-Info (252)

Description: Specifies a list of hosts to which a user can establish a Telnet session.

Usage: You can specify up to 10 Ascend-Host-Info entries in a user profile. Enter your attribute settings in the following format:

Ascend-Host-Info="IP_address text"
where IP_address specifies the IP address of each host, and text describes each host. You can enter up to 31 characters for text. The RADIUS server assigns each entry a number. When the user selects the number, the terminal server initiates a Telnet session with the host at the specified IP address.

Dependencies: If you specify a value for the Ascend-Host-Info attribute, you must also specify the following settings in the Menu-Mode-Options subprofile of the Terminal-Server profile:

Example: To set up a host list for a MAX TNT named Cal, you would configure a pseudo-user profile as follows:

initial-banner-Cal Password="ascend", User-Service=Dialout-Framed-User
Reply-Message="Up to 16 lines of up to 80 characters each",
Reply-Message="will be accepted. ",
Reply-Message="Additional lines will be ignored.",
Reply-Message="",
Ascend-Host-Info="1.2.3.4 Berkeley",
Ascend-Host-Info="1.2.3.5 Alameda",
Ascend-Host-Info="1.2.36 San Francisco",
...
See Also: Reply-Message (18).

Ascend-Idle-Limit (244)

Description: Specifies the number of seconds the MAX TNT waits before clearing a call when a session is inactive.

Usage: Specify a number from 0 to 65535. If you specify 0 (zero), the MAX TNT always clears a call when a session is inactive. The default value is 120 seconds. If you accept the default, and the Answer-Defaults profile specifies a value for the analogous Idle-Timer parameter, the MAX TNT ignores the Idle-Timer value and uses the Ascend-Idle-Limit default.

Dependencies: Consider the following:

See Also: Configuring a time limit and idle connection attributes,
Ascend-MPP-Idle-Percent (254), and
Ascend-Preempt-Limit (245).

Ascend-IF-Addr

Description: Specifies the IP address of the local numbered interface.

Usage: Specify an IP address in dotted decimal notation. The default value is 0.0.0.0.

See Also: Setting up an interface-based IP routing connection,
Ascend-IF-Netmask (153), and
Ascend-Remote-Addr (154).

Ascend-IF-Netmask (153)

Description: Specifies the subnet mask in use for the local numbered interface.

Usage: Specify a subnet mask consisting of four numbers from 0 to 255, separated by periods. The default value is 0.0.0.0.

See Also: Setting up an interface-based IP routing connection,
Ascend-IF-Addr, and
Ascend-Remote-Addr (154).

Ascend-Inc-Channel-Count (236)

Description: Specifies the number of channels the MAX TNT adds when bandwidth changes during a call.

Usage: Specify a number from 1 to 32. The default value is 1.

Dependencies: Consider the following:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-Base-Channel-Count (172),
Ascend-DBA-Monitor (171),
Ascend-Dec-Channel-Count (237),
Ascend-History-Weigh-Type (239),
Ascend-Maximum-Channels (235),
Ascend-Minimum-Channels (173),
Ascend-Remove-Seconds (241),
Ascend-Seconds-Of-History (238), and
Ascend-Target-Util (234).

Ascend-IP-Direct (209)

Description: Specifies the IP address to which the MAX TNT redirects packets from the user. When you include this attribute in a user profile, the MAX TNT bypasses all internal routing tables, and simply sends all packets it receives on the connection's WAN interface to the specified IP address.

Ascend-IP-Direct only affects packets from the user. It does not affect packets that go to the user. The MAX TNT uses its internal routing scheme to route packets to the user.

Usage: Specify an IP address in dotted decimal notation. The default value is 0.0.0.0. If you accept the default, the MAX TNT does not redirect IP traffic.

Dependencies: Consider the following:

Example: To specify that the MAX TNT redirects incoming packets to the host at IP address 10.2.3.11, you could configure a user profile as follows:

Emma Password="m2dan", User-Service=Framed-User
Framed-Protocol=PPP,
Framed-Address=10.8.9.10,
Framed-Netmask=255.255.252.0,
Ascend-Route-IP=Route-IP-Yes,
Ascend-IP-Direct=10.2.3.11,
Ascend-Metric=2,
Framed-Routing=None,
...
See Also: Setting up IP redirection and
Framed-Routing (10).

Ascend-IP-Pool-Definition (217)

Description: Specifies the first address in an IP address pool, as well as the number of addresses in the pool.

Usage: The Ascend-IP-Pool-Definition attribute has the following format:

Ascend-IP-Pool-Definition="num first_ipaddr max_entries"

Table 14-11 describes each Ascend-IP-Pool-Definition argument.

Table 14-11. Ascend-IP-Pool-Definition arguments

Argument

Specifies

num

Number of the pool. The default value is 1.

Specify pool numbers starting with 1, unless you have defined pools with the Pool-Base-Address and Assign-Count parameters in the MAX TNT interface, and do not wish to override those settings. In that case, for the num argument, start with one plus the highest number you used for an IP address pool on the MAX TNT.

For example, if you set up address pools 1 through 5 on the MAX TNT, specify pool numbers starting with 6 in RADIUS.

first_ipaddr

First IP address in the address pool. The address you specify should not accept a subnet mask, because it always becomes a host route. The default value is 0.0.0.0.

max_entries

Maximum number of IP addresses in the pool. The MAX TNT assigns addresses sequentially, from first_ipaddr on, up to the limit of addresses specified by max_entries. The default value is 0 (zero).

Example: In the following example, an administrator configures a pseudo-user profile to create two address pools. Address pool #1 contains a block of 7 IP addresses from 10.1.0.1 to 10.1.0.7. Address pool #2 contains a block of 48 IP addresses from 10.2.0.1 to 10.2.0.48.

pools-TNT Password="ascend", User-Service=Dialout-Framed-User
Ascend-IP-Pool-Definition="1 10.1.0.1 7",
Ascend-IP-Pool-Definition="2 10.2.0.1 48"
See Also: Configuring IP address pools and
Ascend-Assign-IP-Pool (218).

Ascend-IPX-Alias (224)

Description: Specifies an IPX network number to use when connecting to IPX routers that require numbered interfaces.

Usage: Specify an IPX network number. The default value is 0 (zero). RADIUS requires that the Ascend-IPX-Alias attribute have a decimal value (base 10), but IPX network numbers generally have hexadecimal values (base 16). In order to give the Ascend-IPX-Alias attribute a value, you must convert the hexadecimal IPX network number to a decimal value for use in the user profile.

See Also: Setting up IPX routing in a user profile,
Ascend-IPX-Peer-Mode (216),
Ascend-IPX-Route (174), and
Ascend-Route-IPX (229).

Ascend-IPX-Peer-Mode (216)

Description: Specifies whether the caller associated with the user profile is an Ethernet client with its own IPX network address, or a dial-in PPP client.

Dial-in clients do not belong to an IPX network, so you must assign them an IPX network number. When you do so, a dial-in client can establish a routing connection with the MAX TNT. You must use the IPX-Dialin-Pool parameter in the MAX TNT configuration interface to define a virtual IPX network. The MAX TNT advertises the route to the virtual network, and assigns it as the network address for dial-in clients.

Usage: Specify one of the following values:

Dependencies: If the client does not supply its own unique node number, the MAX TNT assigns a unique node number to the client as well. The MAX TNT does not send IPX RIP and SAP advertisements across the connection and ignores IPX RIP and SAP advertisements it receives from the remote end. However, it does respond to IPX RIP and SAP queries it receives from dial-in clients.

See Also: Setting up IPX routing in a user profile,
Ascend-IPX-Route (174), and
Ascend-Route-IPX (229).

Ascend-IPX-Route (174)

Description: Enables you to configure a static IPX route in a pseudo-user profile.

Usage: To configure a static IPX route, use the following format:

Ascend-IPX-Route="profile_name network# [node#] [socket#] 
[server_type] [hop_count] [tick_count] [server_name]"
Table 14-12 describes each Ascend-IPX-Route argument.

Table 14-12. Ascend-IPX-Route arguments

Argument

Specifies

profile_name

RADIUS user profile the MAX TNT uses to reach the network. The default value is null.

network#

Unique internal network number for the NetWare server. The default value is 00000000.

node#

Node number for the NetWare server. The default value is 0000000000001 (the typical node number for a NetWare file server.)

socket#

Socket number for the NetWare server. Typically, NetWare file servers use socket 0451. The default value is 0000.

The number you specify must be a well-known socket number. Services that use dynamic socket numbers might use a different socket each time they load. To bring up a connection to a remote service that uses a dynamic socket number, specify a master server that uses a well-known socket number.

server_type

SAP service type of the NetWare server. NetWare file servers have SAP service type 0004. The default value is 0000.

hop_count

Distance to the destination network, in hops. The default value is 1.

tick_count

Distance to the destination network, in IBM PC clock ticks (one-eighteenth of a second). This value is for round-trip timer calculation and for determining the nearest server of a given type. The default value is 12.

server_name

Name of an IPX server. The default value is null.

Example: To define an IPX route, you would configure a pseudo-user profile as follows:

ipxroute-CA-1 Password="ascend", User-Service=Dialout-Framed-User
Ascend-IPX-Route="def 6 7 8 9 10"
See Also: Setting up IPX routing in a user profile,
Ascend-IPX-Alias (224),
Ascend-IPX-Peer-Mode (216), and
Ascend-Route-IPX (229).

Ascend-Link-Compression (233)

Description: The Ascend-Link-Compression attribute turns data compression on or off for a PPP link.

Usage: You can specify one of the following values:

Dependencies: Both sides of the link must set the Ascend-Link-Compression attribute to turn on data compression.

See Also: Framed-Compression (13).

Ascend-Maximum-Call-Duration (125)

Description: Specifies the maximum number of minutes an incoming call can remain connected. For a multichannel call, the value you specify applies to each individual channel, not to the connection as a whole.

Usage: Specify a number from 0 to 1440. The MAX TNT checks the connection once per minute, so the actual time the call is connected is slightly longer than the time you set. The default value is 0 (zero), which specifies that the MAX TNT does not set a limit on the duration of an incoming call.

See Also: Configuring a time limit and idle connection attributes.

Ascend-Maximum-Channels (235)

Description: Specifies the maximum number of channels allowed on an MP+ call.

Usage: Specify an integer from 1 to the maximum number of channels your system supports. The default value is 1.

Dependencies: The Ascend-Maximum-Channels attribute applies only to MP+ calls. For optimum MP+ performance, both sides of a connection must set the following values to the same number:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-Base-Channel-Count (172),
Ascend-DBA-Monitor (171),
Ascend-Dec-Channel-Count (237),
Ascend-History-Weigh-Type (239),
Ascend-Inc-Channel-Count (236),
Ascend-Minimum-Channels (173),
Ascend-Remove-Seconds (241),
Ascend-Seconds-Of-History (238), and
Ascend-Target-Util (234).

Ascend-Maximum-Time (194)

Description: Specifies the maximum length of time in seconds that any session can remain online. Once a session reaches the time limit, its connection goes offline.

Usage: Specify a number from 0 to 4,294,967,295. The default value is 0 (zero), which specifies that the MAX TNT does not enforce a time limit.

See Also: Configuring a time limit and idle connection attributes.

Ascend-Menu-Item (206)

Description: Defines a single terminal-server menu item for a user profile. You can specify up to 20 Ascend-Menu-Item attributes per profile. The screen displays the menu items in the order in which they appear in the RADIUS profile.

Using the Ascend-Menu-Item attribute, you can configure a profile to give a terminal-server user a custom menu of items from which to choose. The server uses the custom menu to present the user with a subset of terminal-server commands. The user does not have access to the regular menu or to the terminal-server command line.

Usage: Enter your specifications using the following format:

Ascend-Menu Item=command;text;match
Table 14-13 lists each argument. If any entry consists of an option containing more than the maximum number of characters allowed, the RADIUS server discards the entry.

Table 14-13. Ascend-Menu-Item arguments

Argument

Description

command

Specifies the string sent to the terminal server when the user selects the menu item.

The string must be in a format that the Ascend terminal server understands. It can contain up to 80 characters.

text

Specifies the text that appears on the user's screen, up to 31 characters.

match

Specifies the pattern, of up to 10 characters, that the user must type to select the item. The MAX TNT considers blanks part of the matching pattern.

; (semi-colon)

The first semicolon (;) you enter acts as the delimiter between command and text. If you enter a second semicolon, it acts as the delimiter between text and match.

By default, the MAX TNT uses the standard terminal-server menu.

Example: Suppose you set the following attributes:

Emma Password="m2dan", User-Service=Login-User
Ascend-Menu-Item="show ip stats;Display IP Stats",
Ascend-Menu-Item="ping 1.2.3.4;Ping server",
Ascend-Menu-Item="telnet 10.2.4.5; Telnet to Ken's machine",
Ascend-Menu-Item="show arp;Display ARP Table"
Ascend-Menu-Selector=" Option:"
The terminal server displays the following text:

1. Display IP Stats     3. Telnet to Ken's machine
2. Ping server 4. Display ARP Table.
Option:
See Also: Setting up a custom menu and an input prompt and
Ascend-Menu-Selector (205).

Ascend-Menu-Selector (205)

Description: Specifies a string as a prompt for user input in the terminal-server menu interface.

By default, when you create a custom menu with the Ascend-Menu-Item attribute, the terminal server displays the following string when prompting the user to make a selection:

Enter Selection (1-num, q) 
The num argument represents the last number in the list. The terminal server automatically determines the value of num by counting the number of items in the menu. The only valid user input is in the range 1 through num, and q to quit.

However, you can specify a different string for prompting the user to make a selection. The Ascend-Menu-Selector attribute enables you to specify a string that the terminal server displays when prompting a user for a menu selection.

Usage: Specify a text string of up to 31 characters. The terminal server displays the string when prompting the user for a menu selection.

Example: Suppose you set the following attributes:

Emma Password="m2dan", User-Service=Login-User
Ascend-Menu-Item="show ip stats;Display IP Stats",
Ascend-Menu-Item="ping 1.2.3.4;Ping server",
Ascend-Menu-Item="telnet 10.2.4.5; Telnet to Ken's machine",
Ascend-Menu-Item="show arp;Display ARP Table"
Ascend-Menu-Selector=" Option:"
The terminal server displays the following text:

1. Display IP Stats     3. Telnet to Ken's machine
2. Ping server 4. Display ARP Table.
Option:
Note that the valid user input in this example is still 1 through 4, or q to quit.

See Also: Setting up a custom menu and an input prompt and
Ascend-Menu-Item (206).

Ascend-Metric (225)

Description: Specifies the virtual hop count of an IP route.

If there are two routes available to a single destination network, you can make sure that the MAX TNT uses any available nailed-up channel before it uses a switched channel. Simply set the Ascend-Metric attribute to a value higher than the metric of any nailed-up route. The higher the value you enter, the less likely that the MAX TNT will bring the link online. The MAX TNT uses the lowest metric.

Usage: Specify a number from 1 to 15. The default value is 7.

Dependencies: The hop count includes the metric of each switched link in the route.

Example: If a route to a station takes three hops over nailed-up lines, and Ascend-Metric=4 in a user profile that reaches the same station, the MAX TNT does not bring the user's link online. However, if the link is already online, the MAX TNT does not use the nailed-up line.

See Also: Ascend-Route-IP (228) and
Framed-Route (22).

Ascend-Minimum-Channels (173)

Description: Specifies the minimum number of channels an MP+ call maintains.

Usage: Specify a number from 1 to 32. The default value is 1.

Dependencies: The Ascend-Minimum-Channels attribute applies only to MP+ calls. For optimum MP+ performance, both sides of a connection must set the following values to the same number:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-Base-Channel-Count (172),
Ascend-DBA-Monitor (171),
Ascend-Dec-Channel-Count (237),
Ascend-History-Weigh-Type (239),
Ascend-Inc-Channel-Count (236),
Ascend-Maximum-Channels (235),
Ascend-Remove-Seconds (241),
Ascend-Seconds-Of-History (238), and
Ascend-Target-Util (234).

Ascend-MPP-Idle-Percent (254)

Description: Specifies a percentage of bandwidth utilization below which the MAX TNT clears a single-channel MP+ call.

Usage: Specify a number from 0 to 99. The default value is 0 (zero), which causes the MAX TNT to ignore bandwidth utilization when determining whether to clear a call.

Dependencies: Consider the following:

See Also: Configuring a time limit and idle connection attributes,
Ascend-Idle-Limit (244), and
Ascend-Preempt-Limit (245).

Ascend-Multicast-Client (155)

Description: Specifies whether the user is a multicast client of the MAX TNT.

Usage: Specify one of the following values:

See Also: Ascend-Multicast-Rate-Limit (152).

Ascend-Multicast-GRP-Leave-Delay

Description: Specifies the number of seconds the MAX TNT waits before forwarding an IGMP version 2 leave group message from a multicast client.

Usage: Specify a number of seconds from 0 to 120. The default is 0 (zero). If you specify a value other than the default, and the MAX TNT receives a leave group message, the unit sends an IGMP query to the WAN interface or client from which it received the leave group message. If the MAX TNT does not receive a response from an active multicast client from the same group, it sends a leave group message when the time you specify expires.

If you accept the default, the MAX TNT forwards a leave group message immediately. If users might establish multiple multicast sessions for identical groups, set Ascend-Multicast-GRP-Leave-Delay to a value of 10 to 20 seconds.

Dependencies: Ascend-Multicast-GRP-Leave-Delay applies only if you set Multicast-
Forwarding=Yes in the IP-Global profile, and Multicast-Allowed=Yes in the IP-Interface
profile.

See Also: Ascend-Multicast-Client (155).

Ascend-Multicast-Rate-Limit (152)

Description: Specifies how many seconds the MAX TNT waits before accepting another packet from a multicast client. To prevent multicast clients from creating response storms to multicast transmissions, you configure the user profile to limit the rate at which the MAX TNT accepts packets from clients.

Usage: Specify an integer. If you set the attribute to 0 (zero), the MAX TNT does not apply rate limiting. The default value is 100.

See Also: Ascend-Multicast-Client (155).

Ascend-Multilink-ID (187)

Description: Specifies the ID number of the Multilink bundle when the session closes. A Multilink bundle is a multichannel MP or MP+ call.

Usage: Ascend-Multilink-ID does not appear in a user profile and has no default value.

Dependencies: The MAX TNT sends Ascend-Multilink-ID in an Accounting-Request packet when both of the following conditions are true:

See Also: Ascend-Num-In-Multilink (188).

Ascend-Number-Sessions (202)

Description: Indicates the number of active user sessions of a given class (as specified by the Class attribute). In the case of multichannel calls, such as MP+ calls, each separate connection counts as a session.

Usage: The Ascend-Number-Sessions attribute has a compound value. The first part specifies a user-session class. The second part reports the number of active sessions in that class.

Dependencies: The MAX TNT sends the Ascend-Number-Sessions attribute in an Ascend-Access-Event-Request (33) packet. Only RADIUS daemons you customize to recognize this packet respond to requests from the MAX TNT. Other daemons ignore it.

When modifying the daemon, make sure that it recognizes an Ascend-Access-Event-Request packet in the following format:

Code (8-bit)=33
Identifier (8-bit)
Length (16-bit)
Authenticator (48-bit for an accounting server, 64-bit for an authentication server)
List of attributes

Example: Suppose that the MAX TNT has three classes of clients: Class-1, Class-2, and Class-3. At the time of the sessions report, there are eight active sessions: three Class-1 sessions, four Class-2 sessions, and one Class-3 session. The accounting packet the MAX TNT sends back to the RADIUS accounting server has three Ascend-Number-Session attributes, one for each of the class/session pairs.

See Also: Ascend-Event-Type (150) and
Class (25).

Ascend-Num-In-Multilink (188)

Description: Indicates the number of sessions remaining in a Multilink bundle when the session closes. A Multilink bundle is a multichannel MP or MP+ call.

Usage: Ascend-Num-In-Multilink does not appear in a user profile and has no default value.

Dependencies: The MAX TNT sends Ascend-Num-In-Multilink in an Accounting-Request packet when both of the following conditions are true:

See Also: Ascend-Multilink-ID (187).

Ascend-PPP-Address (253)

Description: Specifies the MAX TNT unit's IP address as reported to the calling unit during PPP IPCP negotiations.

Usage: Specify an IP address in dotted decimal notation. The default value is 0.0.0.0, which specifies that IPCP negotiates with the value of the IP-Address parameter in the IP-Interface profile on the MAX TNT.

If you specify a valid IP address, IPCP negotiates with that IP address. If you specify 255.255.255.255, IPCP negotiates with the address 0.0.0.0.

Dependencies: You can assign Ascend-PPP-Address a value different from the MAX TNT unit's true IP address, as long as the user requesting access is aware of the discrepancy.

Ascend-PPP-Async-Map (212)

Description: Specifies the async control character map for the PPP, MP, or MP+ session. The MAX TNT passes the control characters through the link as data. Only applications running over the link use the characters.

Usage: Specify a four-byte bitmap to one or more control characters. The async control character map is defined in RFC 1548 and specifies that each bit position represents its ASCII equivalent. The bits are ordered with the lowest bit of the lowest byte being 0. For example, bit 19 corresponds to Control-S (DC3) or ASCII 19.

Example: Your specification might look like the following:

Emma Password="m2dan", User-Service=Login-User
Ascend-PPP-Async-Map=19,
...
The number 19 translates to 13 hexadecimal or 10011 binary. Therefore, NUL (00), SOH (01), and EOT (04) are mapped.

Ascend-PPP-VJ-1172 (211)

Description: Specifies whether the MAX TNT uses the 0037h value for the VJ compression type. The MAX TNT uses the value only during IPNCP negotiation.

RFC 1172 section 5.2 contains an erroneous statement that the VJ compression type value is 0037h. It should be 002dh. However, many older implementations use the 0037h value when negotiating VJ compression. If you do not specify a value for Ascend-PPP-VJ-1172, the VJ compression type is 002dh.

Usage: Enter your specification in the following format:

Ascend-PPP-VJ-1172=PPP-VJ-1172

Ascend-PPP-VJ-Slot-Comp (210)

Description: Instructs the MAX TNT to not use slot compression when sending VJ-compressed packets.

When you turn on VJ compression, the MAX TNT removes the TCP/IP header, and associates a TCP/IP packet with a connection by giving it a slot ID. The first packet coming into a connection must have a slot ID, but succeeding packets need not have one. If the packet does not have a slot ID, the MAX TNT associates it with the last-used slot ID. This scenario uses slot ID compression, because the slot ID does not appear in any packet but the first in a stream.

There may be times when you want each VJ-compressed packet to have a slot ID. The Ascend-PPP-VJ-Slot-Comp attribute exists for this purpose.

Usage: To specify that no slot compression occurs, set the Ascend-PPP-VJ-Slot-Comp attribute to VJ-Slot-Comp-No (1). If you do not specify a value for Ascend-PPP-VJ-Slot-Comp, and Framed-Compression=Van-Jacobson-TCP-IP, slot compression occurs.

See Also: Framed-Compression (13).

Ascend-Preempt-Limit (245)

Description: Specifies the number of idle seconds the MAX TNT waits before using one of the channels of an idle link for a new call.

Usage: Specify a number from 0 to 65535. The MAX TNT never preempts a call if you enter 0 (zero). The default value is 60.

Dependencies: The Ascend-Preempt-Limit attribute does not apply to nailed-up links.

See Also: Configuring a time limit and idle connection attributes,
Ascend-Idle-Limit (244), and
Ascend-MPP-Idle-Percent (254).

Ascend-Pre-Input-Octets (190)

Description: Reports the number of octets received before authentication. The value reflects only the data delivered by PPP or other encapsulation. It does not include the header or other protocol-dependent components of the packet.

Usage: Ascend-Pre-Input-Octets does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT includes Ascend-Pre-Input-Octets in an Accounting-Request packet when all of the following conditions are true:

Ascend-Pre-Input-Packets (192)

Description: Reports the number of packets received before authentication. The packets are counted before the encapsulation is removed. The attribute's value does not include maintenance packets, such as keepalive or management packets.

Usage: Ascend-Pre-Input-Packets does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT includes Ascend-Pre-Input-Packets in an Accounting-Request packet when both of the following conditions are true:

Ascend-Pre-Output-Octets (191)

Description: Reports the number of octets transmitted before authentication. The value reflects only the data delivered by PPP or other encapsulation. It does not include the header or other protocol-dependent components of the packet.

Usage: Ascend-Pre-Output-Octets does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT includes Ascend-Pre-Output-Octets in an Accounting-Request packet when all of the following conditions are true:

Ascend-Pre-Output-Packets (193)

Description: Reports the number of packets transmitted before authentication. The packets are counted before the encapsulation is removed. The attribute's value does not include maintenance packets, such as keepalive or management packets.

Usage: Ascend-Pre-Output-Packets does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT includes Ascend-Pre-Output-Packets in an Accounting-Request packet when both of the following conditions are true:

Ascend-PreSession-Time (198)

Description: Reports the length of time in seconds from when a call connected to when it completes authentication.

Usage: Ascend-PreSession-Time does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT includes Ascend-PreSession-Time in an Accounting-Request packet when the session has ended or has failed authentication (Acct-Status-Type=Stop).

Ascend-Primary-Home-Agent (129)

Description: Specifies the first home agent the foreign agent tries to reach when setting up an Ascend Tunnel Management Protocol (ATMP) tunnel, and the UDP port the foreign agent uses for the link. The RADIUS server passes the attributes in the mobile client's RADIUS user profile to the foreign agent. The foreign agent sends the attributes when connecting with the home agent.

Usage: Specify the primary home agent in the following format:

Ascend-Primary-Home-Agent="hostname | ip_address [:udp_port]"
Table 14-14 lists each element of the syntax.

Table 14-14. Ascend-Primary-Home-Agent syntax

Syntax element

Specifies

hostname

Home agent's symbolic hostname.

ip_address

Home agent's IP address in dotted decimal notation. Specify an IP address if a DNS server is not set up for the home agent. You can specify a host name or an IP address, but not both. The home agent IP address should be the system address, not the IP address of the interface on which the home agent receives tunneled data.

udp_port

UDP port on which the foreign agent communicates with the home agent. The default value is 5150.

: (colon)

Separator between the hostname (or IP address) and the UDP port.

Dependencies: Consider the following:

Example: To specify the home agent max1.home.com at IP address 10.0.0.1, and indicate that the foreign agent should use UDP port 6001, enter one of the following lines in a RADIUS user profile:

Ascend-Primary-Home-Agent="max1.home.com:6001"
Ascend-Primary-Home-Agent="10.0.0.1:6001"
See Also: Setting up an ATMP tunnel for an IP network,
Ascend-Home-Agent-Password (184),
Ascend-Home-Agent-UDP-Port (186),
Ascend-Home-Network-Name (185), and
Ascend-Secondary-Home-Agent (130).

Ascend-PRI-Number-Type (226)

Description: Specifies the type of phone number the MAX TNT dials.

Usage: Specify one of the settings listed in Table 14-15.

Table 14-15. Ascend-PRI-Number-Type settings

Setting

Specifies

Unknown-Number (0)

Any type of number.

Intl-Number (1)

A number outside the U.S.

National-Number (2)

A number inside the U.S. The default value is National-Number.

Local-Number (4)

A number within your Centrex group.

Abbrev-Number (5)

An abbreviated phone number.

Ascend-PW-Expiration (21)

Description: Specifies an expiration date for a user's password. When the MAX TNT makes an authentication request, the RADIUS server checks the current date against the value of Ascend-PW-Expiration. If the date of the authentication request is the same or a later date than the value of Ascend-PW-Expiration, the user receives a message saying that the password has expired.

You must specify Ascend-PW-Expiration when you first create a user, and it must appear on the first line of the user profile. If it appears after the first line, RADIUS does not check the expiration date and could accept an expired password.

Usage: Specify a month, day, and year in the following format:

month day year
Separate each part of the date specification with one or more spaces, tabs, or commas. The default value is 00/00/00.

Table 14-16 lists each argument.

Table 14-16. Ascend-PW-Expiration arguments

Argument

Specifies

month

The first three letters of the month in which you want the password to expire, or the entire name of the month. Begin the specification with a capital letter.

day

One or more digits indicating a valid day of the month. The settings 2, 02, 002, and 0021 are all valid, but 32 is not.

year

A four-digit year starting with the number 19.

Dependencies: Consider the following:

Example: You might enter a specification like the following:

Emma Password="m2dan", User-Service=Login-User, Ascend-PW-Expiration="January
1, 1997"
...
See Also: Configuring password expiration and
Ascend-PW-Lifetime (208).

Ascend-PW-Lifetime (208)

Description: Specifies the number of days that a password is valid.

Usage: Specify an integer. You can set the Ascend-PW-Lifetime attribute on any line other than the first.

Dependencies: Consider the following:

Example: You might make the following specification:

Emma Password="m2dan", User-Service=Login-User, Ascend-PW-Expiration="Jan
1, 1997"
Ascend-PW-Lifetime=30
See Also: Configuring password expiration and
Ascend-PW-Expiration (21).

Ascend-Receive-Secret (215)

Description: Specifies a value that must match the password the calling unit sends to your MAX TNT.

Usage: Specify up to 20 characters. The default value is null.

Dependencies: You can set the Ascend-Receive-Secret attribute for Cache-Token or PAP-Token-CHAP authentication only.

Example: The following example shows the settings you would specify for a user called Emma to access an Enigma Logic server. Because the profile includes Ascend-Receive-Secret, the MAX TNT can authenticate additional channels through CHAP without having to use the
SAFEWORD server for authentication.

Emma    Password="SAFEWORD"
User-Service=Framed-User,
Framed-Protocol=PPP,
Framed-Address=200.0.5.1,
Framed-Netmask=255.255.255.0,
Ascend-Receive-Secret="b5XSAM"
See Also: Configuring Cache-Token authentication and
Configuring PAP-Token-CHAP authentication.

Ascend-Remote-Addr (154)

Description: Specifies the IP address of the numbered interface at the remote end of a link.

Usage: Specify the IP address of the numbered interface in dotted decimal notation. The default value is 0.0.0.0.

Dependencies: For Ascend-Remote-Addr to apply, you must enable IP for the user profile (Ascend-Route-IP=Route-IP-Yes).

See Also: Setting up an interface-based IP routing connection,
Ascend-IF-Addr,
Ascend-IF-Netmask (153), and
Ascend-Route-IP (228).

Ascend-Remove-Seconds (241)

Description: Specifies the number of seconds that average line utilization (ALU) for transmitted data must fall below the Ascend-Target-Util threshold before the MAX TNT begins removing bandwidth from a session. The MAX TNT determines the ALU for a session by means of the Ascend-History-Weigh-Type algorithm.

When utilization falls below the threshold for a period of time greater than the value of the Ascend-Remove-Seconds attribute, the MAX TNT attempts to remove the number of channels specified by the Ascend-Dec-Channel-Count attribute. Using the Ascend-Remove-Seconds attribute prevents the system from continually subtracting bandwidth, and can slow down the process of removing bandwidth.

Usage: Specify a number from 1 to 300. The default value is 10.

Dependencies: Consider the following:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-Base-Channel-Count (172),
Ascend-DBA-Monitor (171),
Ascend-Dec-Channel-Count (237),
Ascend-History-Weigh-Type (239),
Ascend-Inc-Channel-Count (236),
Ascend-Maximum-Channels (235),
Ascend-Minimum-Channels (173),
Ascend-Seconds-Of-History (238), and
Ascend-Target-Util (234).

Ascend-Require-Auth (201)

Description: Specifies whether the MAX TNT requires additional authentication after Calling-Line ID (CLID) or called-number authentication.

Usage: Specify one of the following values:

Dependencies: When you set Ascend-Require-Auth=Require-Auth, you should not include any other attributes in the user profile. You must specify the characteristics of the call in another user profile.

Example: The following example shows a two-tiered approach to using the Ascend-Require-Auth attribute. The first user profile specifies CLID authentication, and indicates that additional authentication will follow. Because Recv-Auth-Mode=CHAP-PPP-Auth in the PPP-Answer subprofile of the Answer-Defaults profile, CHAP authentication will follow CLID authentication. The second user profile sets up other attributes for the call.

5551212      Password="Ascend-CLID"
Ascend-Require-Auth=Require-Auth
Emma      Password="pwd", Caller-Id="5551212"
User-Service=Framed-User,
Framed-Protocol=PPP,
Framed-Address=200.11.12.10,
Framed-Netmask=255.255.255.248,
Ascend-Send-Secret="pwd",
...
See Also: External authentication after CLID authentication,
PAP, CHAP, or MS-CHAP after CLID authentication, and
External authentication after called-number authentication.

Ascend-Route-IP (228)

Description: Specifies whether IP routing is allowed for the user profile.

Usage: Specify one of the following values:

See Also: Enabling IP routing and
Framed-Route (22).

Ascend-Route-IPX (229)

Description: Specifies whether IPX routing is allowed for the user profile.

Usage: Specify one of the following values:

Dependencies: For PPP and MP+ calls, both ends of the connection must have matching settings to route IPX.

See Also: Setting up IPX routing in a user profile,
Ascend-IPX-Alias (224),
Ascend-IPX-Peer-Mode (216), and
Ascend-IPX-Route (174).

Ascend-Secondary-Home-Agent (130)

Description: Specifies the secondary home agent the foreign agent tries to reach when the primary home agent (Ascend-Primary-Home-Agent) is unavailable, and specifies the UDP port the foreign agent uses for the link.

Usage: Specify the secondary home agent using the following format:

Ascend-Secondary-Home-Agent="hostname | ip_address [:udp_port]"
Table 14-17 lists each element of the syntax.

Table 14-17. Ascend-Secondary-Home-Agent syntax

Syntax element

Specifies

hostname

Home agent's symbolic hostname.

ip_address

Home agent's IP address in dotted decimal notation. Specify an IP address if a DNS server is not set up for the home agent. You can specify a host name or an IP address, but not both. The home agent IP address should be the system address, not the IP address of the interface on which the home agent receives tunneled data.

udp_port

UDP port on which the foreign agent communicates with the home agent. The default value is 5150.

: (colon)

Separator between the hostname (or IP address) and the UDP port.

Dependencies: If you specify the Ascend-Home-Agent-UDP-Port attribute on the line immediately following the Ascend-Secondary-Home-Agent attribute, you need not specify a value for udp_port. By the same token, if you specify a value for the udp_port argument of Ascend-Secondary-Home-Agent, or if you accept the default of 5150, you need not specify the Ascend-Home-Agent-UDP-Port attribute.

Example: To specify max2.home.com at IP address 10.0.0.2 as the secondary home agent, and to indicate that the foreign agent should use UDP port 6002, enter one of the following lines in the RADIUS user profile:

Ascend-Secondary-Home-Agent="max2.home.com:6002"
Ascend-Secondary-Home-Agent="10.0.0.2:6002"
To specify a primary home agent and a secondary home agent, enter the following lines in the RADIUS user profile:

Ascend-Primary-Home-Agent="max1.home.com:6001"
Ascend-Secondary-Home-Agent="max2.home.com:6002"
The foreign agent first tries max1.home.com on UDP port 6001. If the name cannot be resolved, or if max1.home.com does not respond, the foreign agent then tries max2.home.com on UDP port 6002.

See Also: Setting up an ATMP tunnel for an IP network,
Ascend-Home-Agent-Password (184),
Ascend-Home-Agent-UDP-Port (186),
Ascend-Home-Network-Name (185), and
Ascend-Primary-Home-Agent (129).

Ascend-Seconds-Of-History (238)

Description: Specifies the number of seconds the MAX TNT uses as a sample for calculating average line utilization (ALU) of transmitted data. The MAX TNT arrives at this average by using the algorithm specified by the Ascend-History-Weigh-Type attribute.

Usage: Specify a number from 1 to 300. The default value is 15 seconds. The number of seconds you specify depends on your device's traffic patterns. For example, if you want to average spikes with normal traffic flow, you might want the MAX TNT to use a longer time period. If, on the other hand, traffic patterns consist of many spikes that are short in duration, you might want to specify a shorter period of time. Doing so assigns less weight to the short spikes.

Dependencies: Consider the following:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-Base-Channel-Count (172),
Ascend-DBA-Monitor (171),
Ascend-Dec-Channel-Count (237),
Ascend-History-Weigh-Type (239),
Ascend-Inc-Channel-Count (236),
Ascend-Maximum-Channels (235),
Ascend-Minimum-Channels (173),
Ascend-Remove-Seconds (241), and
Ascend-Target-Util (234).

Ascend-Send-Auth (231)

Description: Specifies the authentication protocol that the MAX TNT requests when initiating a PPP or MP+ connection. The answering side of the connection determines which authentication protocol, if any, the connection uses.

Usage: Specify one of the following values:

Dependencies: Consider the following:

See Also: Requesting an access protocol for outgoing calls,
Ascend-Send-Passwd (232), and
Ascend-Send-Secret (214).

Ascend-Send-Passwd (232)

Description: Specifies the password that the RADIUS server sends to the remote end of a connection on an outgoing call.

Usage: Specify a text string of up to 20 characters. The default value is null.

Dependencies: In a user profile, you can specify either Ascend-Send-Passwd or Ascend-Send-Secret, but not both. Use Ascend-Send-Passwd only if your version of the MAX TNT does not support Ascend-Send-Secret.

See Also: Requesting an access protocol for outgoing calls,
Ascend-Send-Auth (231), and
Ascend-Send-Secret (214).

Ascend-Send-Secret (214)

Description: Specifies the password that the RADIUS server sends to the remote end of a connection on an outgoing call. It is encrypted when passed between the RADIUS server and the MAX TNT.

Usage: Specify a text string of up to 20 characters. The default value is null.

Dependencies: In a user profile, you can specify either Ascend-Send-Passwd or Ascend-Send-Secret, but not both. Use Ascend-Send-Passwd only if your version of the MAX TNT does not support Ascend-Send-Secret.

See Also: Requesting an access protocol for outgoing calls,
Ascend-Send-Auth (231), and
Ascend-Send-Passwd (232).

Ascend-Session-Svr-Key (151)

Description: Enables the MAX TNT to match a user session with a client request to perform certain operations, such as disconnecting a session or changing a session's filters.

Usage: Specify up to 16 characters. The default value is null.

Dependencies: Consider the following:

See Also: Setting up disconnects and
Setting up filter changes.

Ascend-Shared-Profile-Enable (128)

Description: Specifies whether multiple incoming callers can share a single RADIUS user profile.

Usage: Specify one of the following settings:

Dependencies: For the Ascend-Shared-Profile-Enable attribute to apply, you must set Shared-Prof=No in the IP-Global profile to disable shared profiles for the MAX TNT.

Ascend-Target-Util (234)

Description: Specifies the percentage of bandwidth use at which the MAX TNT adds or subtracts bandwidth.

Usage: Specify a number from 0 to 100. The default value is 70. With a value of 70%, the device adds bandwidth when it exceeds a 70 percent utilization rate, and subtracts bandwidth when it falls below that number.

Dependencies: When choosing a target utilization rate, consider the following:

See Also: Configuring DBA in RADIUS,
Ascend-Add-Seconds (240),
Ascend-Base-Channel-Count (172),
Ascend-DBA-Monitor (171),
Ascend-Dec-Channel-Count (237),
Ascend-History-Weigh-Type (239),
Ascend-Inc-Channel-Count (236),
Ascend-Maximum-Channels (235),
Ascend-Minimum-Channels (173),
Ascend-Remove-Seconds (241), and
Ascend-Seconds-Of-History (238).

Ascend-Third-Prompt (213)

Description: Indicates the value entered at the prompt specified by the Third-Login-Prompt parameter.

Usage: The Ascend-Third-Prompt attribute can contain up to 80 characters. It does not appear in a user profile. If the user enters more than 80 characters at the third prompt, the MAX TNT truncates the input to 80. If the user does enter any characters, the MAX TNT sets the attribute to null.

Ascend-Token-Expiry (204)

Description: Specifies the lifetime (in minutes) of a cached token.

Usage: On the first line of the user profile, specify an integer representing the number of minutes in the lifetime of the cached token. The default value is 0 (zero). If you accept the default, the MAX TNT rejects subsequent Cache-Token requests from the same user.

Example: The following two-line example shows how to set up Cache-Token authentication with a 90-minute token cache. Notice that the Ascend-Token-Expiry attribute must appear on the first line of the profile, along with the user name and password.

Connor    Password="ACE", Ascend-Token-Expiry=90
Ascend-Receive-Secret="shared-secret",
...
See Also: Configuring Cache-Token authentication,
Ascend-Token-Idle (199), and
Ascend-Token-Immediate (200).

Ascend-Token-Idle (199)

Description: Specifies the maximum length of time in minutes a cached token can remain alive between authentications.

Usage: On the first line of the user profile, specify an integer representing the maximum length of time in minutes that a cached token can remain alive. The default value is 0 (zero). If you accept the default, the cached token remains alive until the value of the Ascend-Token-Expiry attribute causes it to expire.

Dependencies: Typically, the value of Ascend-Token-Idle is lower than the value of Ascend-Token-Expiry.

Example: The following two-line example shows how to set up Cache-Token authentication with a 90-minute token cache and an 80-minute idle limit. Notice that the Ascend-Token-Idle attribute must appear on the first line of the profile.

Jim    Password="ACE", Ascend-Token-Expiry=90, Ascend-Token-Idle=80 
Ascend-Receive-Secret="shared secret"
See Also: Configuring Cache-Token authentication,
Ascend-Token-Expiry (204), and
Ascend-Token-Immediate (200).

Ascend-Token-Immediate (200)

Description: Specifies how RADIUS treats the password it receives when the user profile specifies a token-card server. Use this attribute in an ACE or SAFEWORD user profile that contains the setting User-Service=Login-User.

Usage: Specify one of the following values:

Dependencies: The Ascend-Token-Immediate attribute does not work with CHAP authentication.

Example: To specify that the MAX TNT must send the password it receives from the login user to the ACE server, you would configure the user profile as follows:

Connor    Password="ACE", Ascend-Token-Immediate=Tok-Imm-Yes
Ascend-Receive-Secret="shared-secret",
User-Service=Login-User,
...
See Also: Configuring Cache-Token authentication,
Ascend-Token-Expiry (204), and
Ascend-Token-Idle (199).

Ascend-Transit-Number (251)

Description: Specifies the U.S Interexchange Carrier (IEC) you use for long distance calls over a T1 PRI line.

Usage: Specify the same digits you use to prefix a phone number you dial over a T1 access line or voice interface:

The default value is null. If you accept the default, the MAX TNT uses any available IEC for long-distance calls.

Ascend-TS-Idle-Limit (169)

Description: Specifies the number of seconds that a terminal-server connection must be idle before the MAX TNT disconnects the session.

Usage: Specify a value from 0 to 65535.The default value is 120. A setting of 0 (zero) specifies that the line can be idle indefinitely.

Dependencies: Ascend-TS-Idle-Limit does not apply if you are using a Frame Relay or raw TCP connection, or if Ascend-TS-Idle-Mode=TS-Idle-None.

See Also: Ascend-TS-Idle-Mode (170).

Ascend-TS-Idle-Mode (170)

Description: Specifies whether the MAX TNT uses a terminal-server idle timer and, if so, whether both the user and host must be idle before the MAX TNT disconnects the session.

Usage: Specify one of the following settings:

Example: To specify that the user must be idle for 90 seconds before the MAX TNT disconnects the session, you could configure a user profile as follows:

Default Password="UNIX"
User-Service=Login-User,
Ascend-TS-Idle-Limit=90,
Ascend-TS-Idle-Mode=TS-Idle-Input
Dependencies: Ascend-TS-Idle-Mode does not apply if you are using a Frame Relay or raw TCP connection.

See Also: Ascend-TS-Idle-Limit (169).

Ascend-User-Acct-Base (142)

Description: Specifies whether the numeric base of the RADIUS Acct-Session-ID attribute is 10 or 16.

Usage: Specify one of the following settings:

Dependencies: Changing the value of Ascend-User-Acct-Base while sessions are active results in inconsistent reporting between the Start and Stop records.

Example: When you set Ascend-User-Acct-Base=Ascend-User-Acct-Base-10, the MAX TNT presents a typical session ID to the accounting server in the following way:

"1234567890"
When you set Ascend-User-Acct-Base=Ascend-User-Acct-Base-16, the MAX TNT presents the same session ID in the following way:

"499602D2"
See Also: Ascend-User-Acct-Host (139),
Ascend-User-Acct-Key (141),
Ascend-User-Acct-Port (140),
Ascend-User-Acct-Time (143), and
Ascend-User-Acct-Type (138).

Ascend-User-Acct-Host (139)

Description: Specifies the IP address of the RADIUS accounting server for the connection.

Usage: Specify an IP address in dotted decimal notation. The default value is 0.0.0.0.

See Also: Setting up accounting on a per-user basis,
Ascend-User-Acct-Base (142),
Ascend-User-Acct-Key (141),
Ascend-User-Acct-Port (140),
Ascend-User-Acct-Time (143), and
Ascend-User-Acct-Type (138).

Ascend-User-Acct-Key (141)

Description: Specifies the RADIUS client password as it appears in the clients file.

Usage: Specify a text string. The default value is null.

See Also: Setting up accounting on a per-user basis,
Ascend-User-Acct-Base (142),
Ascend-User-Acct-Host (139),
Ascend-User-Acct-Port (140),
Ascend-User-Acct-Time (143), and
Ascend-User-Acct-Type (138).

Ascend-User-Acct-Port (140)

Description: Specifies a UDP port number for the connection between the user and the RADIUS accounting server.

Usage: Specify the UDP port number you indicated for the authentication process of the daemon in /etc/services. Or, if you used the incr keyword to the -A argument when starting the daemon, specify the number of the UDP port for authentication services plus 1. You can specify a number from 1 to 32767.

See Also: Setting up accounting on a per-user basis,
Ascend-User-Acct-Base (142),
Ascend-User-Acct-Host (139),
Ascend-User-Acct-Key (141),
Ascend-User-Acct-Time (143), and
Ascend-User-Acct-Type (138).

Ascend-User-Acct-Time (143)

Description: Specifies the number of seconds the MAX TNT waits for a response to a RADIUS accounting request for the connection.

Usage: Specify an integer from 1 to 10. The default value is 0 (zero).

See Also: Setting up accounting on a per-user basis,
Ascend-User-Acct-Base (142),
Ascend-User-Acct-Host (139),
Ascend-User-Acct-Key (141),
Ascend-User-Acct-Port (140), and
Ascend-User-Acct-Type (138).

Ascend-User-Acct-Type (138)

Description: Specifies the RADIUS accounting server(s) to use for the connection.

Usage: Specify one of the following settings:

See Also: Setting up accounting on a per-user basis,
Ascend-User-Acct-Base (142),
Ascend-User-Acct-Host (139),
Ascend-User-Acct-Key (141),
Ascend-User-Acct-Port (140), and
Ascend-User-Acct-Time (143).

Ascend-Xmit-Rate (255)

Description: Specifies the rate of data transmitted on the connection in bits per second. For ISDN calls, Ascend-Xmit-Rate indicates the transmit data rate. For analog calls, it indicates the modem baud rate at the time of the initial connection.

Usage: Ascend-Xmit-Rate does not appear in a user profile. Its default value is 0 (zero).

Dependencies: The MAX TNT includes Ascend-Xmit-Rate in an Accounting-Request packet when the session has ended or has failed authentication (Acct-Status-Type=Stop).

Caller-Id (31)

Description: Specifies the calling-party number for Calling-Line ID (CLID) authentication, indicating the phone number of the user that wants to connect to the MAX TNT.

Usage: Specify a telephone number of up to 37 characters, limited to the following:

1234567890()[]!z-*#|
The default value is null.

Dependencies: Consider the following:

Example: To set up CLID authentication with a name, password, and caller ID, you could configure a user profile as follows:

Emma  Password="test", Caller-Id="123456789"
User-Service=Framed-User,
Framed-Protocol=PPP,
Framed-Address=255.255.255.254,
Framed-Netmask=255.255.255.255,
Ascend-Assign-IP-Pool=1,
Ascend-Route-IP=Route-IP-Yes,
Ascend-Idle-Limit=30
See Also: CLID authentication using a name, password, and caller ID and
CLID authentication using a caller ID only.

Challenge-Response (3)

Description: Specifies the value that a Challenge Handshake Authentication Protocol (CHAP) user provides in response to the password challenge.

Usage: The MAX TNT sends the Challenge-Response value in an Access-Request packet. The default value is null.

Change-Password (17)

Description: Enables the MAX TNT to change an expired password.

When a user specifies an expired password, RADIUS prompts the user for a new password. When the user enters the new password, the MAX TNT sends an Access-Password-Request packet containing both the old password (as the value of the Change-Password attribute), and the new password (as the value of the Password attribute).

If the RADIUS server accepts the new password, it tries to edit the users file and replace the expired password with the new one. Note that the RADIUS server can make the change only in the flat file. It cannot make the change in the database version of the users file.

Usage: Change-Password does not appear in a user profile and has no default value.

Class (25)

Description: Enables you to classify user sessions for purposes such as billing users on the basis of the service option they choose.

Keep in mind that accounting entries specify the class on a per-user and per-session basis. The Ascend-Number-Sessions attribute reports information about all user sessions (that is, on the number of current sessions of each class).

Usage: Specify an alphanumeric text string of up to 253 characters. The default value is null.

Dependencies: If you include the Class attribute in the RADIUS user profile, the RADIUS server sends it to the MAX TNT in the Access-Accept packet when the session begins. The MAX TNT then includes Class in Accounting-Request packets it sends to the RADIUS accounting server under the following conditions:

In addition, suppose the MAX TNT starts CLID authentication by sending an Access-Request packet, and receives the Class attribute in an Access-Accept packet. If the MAX TNT requires further authentication, it includes Class in the Access-Request packet

See Also: Classifying user sessions in RADIUS and
Ascend-Number-Sessions (202).

Client-Port-DNIS (30)

Description: Specifies the called-party number, indicating the phone number the user dialed to connect to the MAX TNT. You use this attribute to set up called-number authentication or to route an incoming call to a particular device.

Usage: Specify the number the remote end dials to reach the MAX TNT, limiting your specification to the following characters:

1234567890()[]!z-*#|
You can specify up to 18 characters. The default value is null.

Typically, the phone numbers different callers can use to reach the MAX TNT share a group of digits. For example, a local caller might dial 555-1234, while a long distance caller would dial 1-415-555-1234. In such cases, you need only specify the rightmost digits the calls have in common. In this example, you would specify only 1234.

Example: To set up called-number authentication in addition to name and password authentication, you could configure the user profile as follows:

Clara-p50 Password="ascend", Client-Port-DNIS=1234
User-Service=Framed-User,
Framed-Protocol=PPP,
Framed-Address=200.10.11.12,
Framed-Netmask=255.255.255.248
See Also: Authentication using a name, password, and called-party number.

Framed-Address (8)

Description: Specifies the IP address of a caller. RADIUS can authenticate an incoming caller by matching the user's IP address to the one specified in the user profile.

Usage: Specify an IP address in dotted decimal notation. The default value is 0.0.0.0. An answering user profile with the default setting matches all IP addresses.

Dependencies: Every Connection profile and RADIUS user profile that specifies an explicit IP address is a static route.

See Also: Framed-Netmask (9).

Framed-Compression (13)

Description: Turns TCP/IP header compression on or off.

Usage: To turn on TCP/IP header compression, specify Van-Jacobson-TCP-IP. This setting applies only to packets in TCP applications, such as Telnet, and turns on header compression for both sides of the link. By default, the Framed-Compression attribute does not turn on header compression.

Dependencies: Turning on header compression is most effective in reducing overhead when the data portion of the packet is small.

Framed-MTU (12)

Description: Specifies the maximum number of bytes the MAX TNT can receive in a single packet on a PPP, MP, MP+, or Frame Relay link.

Usage: The default value is 1524. You should accept the default unless the device at the remote end of the link cannot support it. If the administrator of the remote network determines that you must change the value, specify a number from 1 to 1524 (for a PPP, MP, or MP+ link) or from 128 to 1600 (for a Frame Relay link).

Framed-Netmask (9)

Description: Specifies a subnet mask for the caller at Framed-Address.

Usage: Specify an IP address in dotted decimal notation. The default value is 0.0.0.0, which specifies that the MAX TNT assumes a default subnet mask on the basis of the class of the address (as shown in Table 14-18).

Table 14-18. IP address classes and default subnet masks

Class

Address range

Network bits

Class A

0.0.0.0 -> 127.255.255.255

8

Class B

128.0.0.0 -> 191.255.255.255

16

Class C

192.0.0.0 -> 223.255.255.255

24

Class D

224.0.0.0 -> 239.255.255.255

N/A

Class E (reserved)

240.0.0.0 -> 247.255.255.255

N/A

See Also: Framed-Address (8).

Framed-Protocol (7)

Description: Specifies the type of framed protocol the link can use. When you set this attribute, the link cannot use any other type of framed protocol.

Usage: Table 14-19 lists the values you can specify for Framed-Protocol. By default, the MAX TNT does not limit the protocols a link can access.

Table 14-19. Framed-Protocol settings

Setting

Incoming call

Outgoing call

PPP (1)

A user requesting access can dial in with Multilink Protocol Plus (MP+), Multilink Protocol (MP), or Point-to-Point Protocol (PPP) framing. A user requesting access can also dial in unframed, and then change to PPP, MP, or MP+ framing. If the user dials in with any other type of framing, the MAX TNT rejects the call.

Outgoing calls use PPP framing.

SLIP (2)

A user requesting access can dial in unframed and change to SLIP framing.

Does not apply to outgoing calls.

ARA (255)

Specifies an AppleTalk Remote Access (ARA) connection.

Does not apply to outgoing calls.

MPP (256)

Does not apply to incoming calls.

Outgoing calls request MP+ framing.

FR (261)

Does not apply to incoming calls.

Outgoing calls use Frame Relay (RFC 1490) framing.

FR-CIR (263)

Specifies a Frame Relay circuit.

Specifies a Frame Relay circuit.

Dependencies: Framed-Protocol can appear in both Access-Request and Access-Accept packets. However, it does not appear in an Access-Request packet if Auth-Send67=No in the External-Auth profile's Rad-Auth-Client subprofile.

What Framed-Protocol does depends on how you set User-Service:

Example: To specify that a dial-in user can only use PPP protocols (PPP, MP+, or MP), and cannot use the terminal server, you could configure a user profile as follows:

Ascend  Password="Pipeline"
User-Service=Framed-User,
Framed-Protocol=PPP,
Framed-Address=10.0.200.225,
Framed-Netmask=255.255.255.0,
Ascend-Metric=2,
Framed-Routing=None,
Framed-Route="10.0.220.0 10.0.200.225 1",
Ascend-Idle-Limit=30
...
See Also: User-Service (6).

Framed-Route (22)

Description: Enables you to add static IP routes to the MAX TNT unit's routing table.

Usage: The Framed-Route attribute has the following format:

Framed-Route="host_ipaddr[/subnet_mask] gateway_ipaddr metric 
[private] [profile_name]"
Table 14-20 describes each Framed-Route argument.

Table 14-20. Framed-Route arguments

Syntax element

Specifies

host_ipaddr
[/subnet_mask]

IP address of the destination host or subnet reached by the route. The default value is 0.0.0.0/0., which represents the default route (the destination to which the MAX TNT forwards packets when no route to the packet's destination exists).

If the address includes a subnet mask, the remote router specified by router_ipaddr is a router to that subnet, rather than to a whole remote network. To specify the entire remote network, do not specify a subnet mask.

router_ipaddr

IP address of the router the MAX TNT uses to reach the target destination. The default value is 0.0.0.0.

The 0.0.0.0 address is a wildcard entry the MAX TNT replaces with the caller's IP address.When RADIUS authenticates a caller and sends the MAX TNT an Access-Accept message with a value of 0.0.0.0 for router_ipaddr, the MAX TNT updates its routing tables with the Framed-Route value, but substitutes the caller's IP address for the router. This setting is especially useful when the MAX TNT assigns an IP address from an address pool and RADIUS cannot know the IP address of the caller.

metric

Metric for the route. If the MAX TNT has more than one possible route to a destination network, it chooses the one with the lower metric. The default value is 8.

private

Value y if the route is private, or n if it is not private. If you specify that the route is private, the MAX TNT does not disclose the existence of the route when queried by RIP or another routing protocol. The default value is n.

profile_name

Name of the outgoing user profile that uses the route. The default value is null.

Example: The following example shows how to set up two RADIUS pseudo-user profiles to define global static IP routes:

route-1      Password="ascend", User-Service=Dialout-Framed-User
Framed-Route="10.0.200.33/29 10.0.200.37 1 n lala-gw-out ",
Framed-Route="10.0.200.50/29 10.0.200.37 1 n lala-gw-out ",
Framed-Route="10.0.200.47/29 10.0.200.49 1 n nana-gw-out "
route-2      Password="ascend", User-Service=Dialout-Framed-User
Framed-Route="11.0.200.33/29 11.0.200.37 1 n zzz-gw-out ",
Framed-Route="12.0.200.47/29 11.0.200.49 1 n kk-gw-out "
See Also: Setting up static IP routes and
Ascend-Route-IP (228).

Framed-Routing (10)

Description: Specifies whether the MAX TNT sends Routing Information Protocol (RIP) packets, receives RIP packets, or both.

If you enable RIP to both send and receive updates on the WAN interface, the MAX TNT broadcasts its routing table to the remote network and listens for RIP updates from that network. Gradually, all routers on both networks have consistent routing tables (all of which can become quite large).

Usage: Specify one of the following values:

Dependencies: If you set Framed-Routing=None, the MAX TNT must rely on static routes you specify with Framed-Route.

See Also: Requiring that a caller accept an IP address,
Setting up static IP routes, and
Ascend-Route-IP (228).

Login-Host (14)

Description: Specifies the IP host to which the user automatically connects when you:

Access begins immediately after login.

Usage: Specify an IP address in dotted decimal notation. The default value is 0.0. 0.0, which specifies that the Login-User does not automatically connect to a particular host.

Dependencies: Consider the following:

See Also: Enabling Telnet, TCP, and Rlogin connections,
Login-Service (15), and
User-Service (6).

Login-Service (15)

Description: Specifies the type of terminal-server connection a dial-in user makes to the IP host on your local network. The user makes the connection immediately after authentication, and never sees the terminal-server interface.

Usage: Specify one of the following values:

By default, the MAX TNT does not grant immediate access to an IP host.

Dependencies: Consider the following:

Example: When you specify the following settings, a raw TCP session starts automatically for anyone who enters the Greg user name and the test1 password:

# The following profile causes an auto-TCP to 4.2.3.1 port 9 
upon login.
Greg Password="test1"
User-Service=Login-User,
Login-Service=TCP-Clear,
Login-Host=4.2.3.1,
Login-TCP-Port=9
See Also: Enabling Telnet, TCP, and Rlogin connections,
Login-Host (14), and
Login-TCP-Port (16).

Login-TCP-Port (16)

Description: Specifies the port number to which a TCP session connects when Login-Service=TCP-Clear.

Usage: Specify an integer from 1 to 65535. The default value is 23.

See Also: Enabling Telnet, TCP, and Rlogin connections and
Login-Service (15).

NAS-Identifier (4)

Description: Indicates the IP address of the MAX TNT.

Usage: NAS-Identifier does not appear in a user profile. Its default value is 0.0.0.0.

NAS-Port (5)

Description: Indicates the network port on which the MAX TNT receives a call. The MAX TNT sends NAS-Port to the RADIUS server in an Accounting-Request packet. If you specify NAS-Port on the first line of a user profile, the MAX TNT sends the value you specify to the RADIUS server in an Access-Request packet.

Usage: The format of the NAS-Port value depends on the setting of the New-NAS-Port-ID-Format parameter in the System profile.

When New-NAS-Port-ID-Format=Yes
When New-NAS-Port-ID-Format=Yes, the NAS-Port value has the following format:

shelf slot line channel
where shelf specifies the shelf number (0-3), slot specifies the slot number (0-15), line specifies the line number (0-31), and channel specifies the channel number (0-31) for an ISDN call. For an analog call, the values are the same, except that line number can be 0-63, and the channel number is always 1. The default value for the RADIUS daemon appears in the /etc/services file.

The values are all bit encoded. For an ISDN call, the bit-encoded number has the following format:

For an analog call, the bit-encoded number has the following format:

When using this attribute for accounting purposes, you must add 1 to each component to ascertain the actual shelf, slot, line, and channel number.

When New-NAS-Port-ID-Format=No
When New-NAS-Port-ID-Format=Yes, the NAS-Port value has the following format:

tllcc
where t indicates 1 for a digital call or 2 for an analog call, ll indicates the line number, and cc indicates the channel number.

Example: To restrict an ISDN user to channel 2 on line 2 for slot 2 and shelf 1, you could set up a user profile as follows:

Robin Password="password", NAS-Port=1057
User-Service=Framed-User,
Framed-Protocol=PPP,
Ascend-Assign-IP-Pool=1,
Ascend-Route-IP=1,
Ascend-Idle-Limit=300,
Framed-Routing=None
The NAS-Port value of 1057 translates to the bit-encoded number 0000010000100001. This number indicates the following NAS port:

shelf=00 (shelf 1)

slot=0001 (slot 2)

line=00001 (line 2)

channel=00001 (channel 2)

NAS-Port-Type (61)

Description: Specifies the type of service in use for the session.

Some ISPs offer different levels of service on the basis of connection type. To prevent a client from using a capability to which he or she has not subscribed, set the NAS-Port-Type attribute to an appropriate value.

Usage: Specify one of the following settings:

See Also: NAS-Port (5).

Password (2)

Description: Specifies the password of the calling device or dial-in user.

Usage: Specify an alphanumeric string of up to 252 characters. The default value is null. The Password attribute must appear on the first line of the user profile.

See Also: Specifying a password.

Reply-Message (18)

Description: Carries message text from the RADIUS server to a RADIUS client (such as the MAX TNT). In a pseudo-user profile that configures message text and a list of IP hosts, the Reply-Message attribute specifies text that appears to the terminal-server operator at the menu-driven interface. In addition, if the RADIUS server determines that the MAX TNT should terminate the session, it sends an Access-Terminate-Session packet containing the Reply-Message attribute.

Usage: Specify a text string of up to 80 characters. The default value is null. You can specify up to 16 Reply-Message attributes in a pseudo-user profile.

Dependencies: Consider the following:

Example: To set up message text for a MAX TNT named Cal, you could configure a pseudo-user profile as follows:

initial-banner-Cal Password="ascend", User-Service=Dialout-Framed-User
Reply-Message="Up to 16 lines of up to 80 characters each",
Reply-Message="will be accepted. ",
Reply-Message="Additional lines will be ignored.",
Reply-Message="",
Ascend-Host-Info="1.2.3.4 Berkeley",
Ascend-Host-Info="1.2.3.5 Alameda",
Ascend-Host-Info="1.2.36 San Francisco",
...
See Also: Ascend-Host-Info (252).

User-Name (1)

Description: Specifies one of the following:

Usage: Specify an alphanumeric string of up to 252 characters. The default value is null. The user name must be the first word in a user profile. You need not specify the name of the attribute.

Example: Suppose you enter the following first line of a user profile for a user named Emma:

Emma Password="pwd", Ascend-PW-Expiration="Jan 30 1997"
The RADIUS server tests the user's name and password against the values the user provides when making a request for access. If the RADIUS server does not find a match, it denies the request for access.

To use CLID authentication with the incoming phone number as the User-Name, you could configure a user profile as follows:

5551212    Password="Ascend-CLID"
Ascend-Require-Auth=Not-Require-Auth,
User-Service=Framed-User,
Framed-Protocol=PPP,
Framed-Address=255.255.255.254,
Framed-Netmask=255.255.255.255,
Ascend-Assign-IP-Pool=1,
Ascend-Route-IP=Route-IP-Yes,
Ascend-Idle-Limit=30
Finally, the following example shows how you would enter User-Name in a pseudo-user profile for a static route:

route-1 Password="ascend", User-Service=Dialout-Framed-User
Framed-Route="10.4.5.0/22 10.9.8.10 1 n inu-out"
See Also: Setting up name and password authentication,
Setting up CLID authentication,
Setting up called-number authentication,
Setting up an outgoing PPP, MP, or MP+ connection,
Setting up the message text and a list of hosts,
Setting up the logical link to a Frame Relay switch,
Setting up Frame Relay user connections,
Defining a pool of addresses for dynamic assignment,
Setting up static IP routes, and
Setting up static IPX routes.

User-Service (6)

Description: Specifies the type of services the link can use.

If RADIUS authenticates an incoming call by means of the User-Name and Password attributes, and the type of call matches the value of the User-Service attribute, the MAX TNT applies the attributes specified in the user profile to the call. If the type of call does not match the User-Service attribute, the MAX TNT rejects the call.

Usage: Specify one of the following values:

By default, the MAX TNT does not limit the services the link can access.

Dependencies: Consider the following:



[Top][Contents][Prev][Next][Last]Search

techpubs@eng.ascend.com

Copyright © 1998, Ascend Communications, Inc. All rights reserved.