Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Announcement: Try the Ask AI chatbot for answers to your technical questions about Juniper products and solutions.

close
header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Broadband Subscriber Sessions User Guide
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

AAA Testing and Troubleshooting

date_range 06-Dec-23

AAA Configuration Testing and Troubleshooting

Subscriber management supports a test feature that enables you to check the AAA configuration of a subscriber. You might use the test feature to verify the subscriber’s AAA settings and to help troubleshoot or isolate subscriber login problems. The AAA test process creates a pseudo session that authenticates the subscriber, allocates an address for the subscriber, and issues an accounting start packet. The process then issues an accounting stop request, releases the address, and terminates the pseudo session.

The AAA test results provide details about the attributes that subscriber management assigns to the subscriber during login. The attributes might be assigned by RADIUS, a dynamic profile, static interface configuration, or might be statically assigned. You can test the AAA configuration for DHCP, PPP, and authd-lite subscribers. For L2TP clients, the AAA test process displays all tunnel parameters but does not create an actual tunnel session.

Note:

The test aaa commands support all RADIUS-sourced attributes, both IETF standard attributes and Juniper Networks VSAs. Received attributes are displayed in the output. For information about standard RADIUS attributes, see RADIUS IETF Attributes Supported by the AAA Service Framework. For information about Juniper Networks VSAs, see Juniper Networks VSAs Supported by the AAA Service Framework.

Note:

The test aaa commands do not support volume-time accounting (Juniper Networks VSA 26-69 with a value of 2). If volume-time accounting is configured for the test subscriber, the test command replaces the statistics with time-only accounting statistics.

Testing a Subscriber AAA Configuration

Purpose

Display the AAA attributes that subscriber management assigns to the subscriber during login.

The following example tests the AAA configuration for a PPP subscriber. You can use the test aaa dhcp user command to perform a similar test for DHCP subscribers and the test aaa authd-lite user command to test authd-lite subscribers.

Action

content_copy zoom_out_map
user@host>test aaa ppp user user45@test.net password $ABC123
Authentication Grant
    ************User Attributes***********
         User Name -                              user45@test.net      
         Client IP Address -                      192.168.1.1       
         Client IP Netmask -                      255.255.0.0  
         Virtual Router Name -                    default          
         Agent Remote Id -                        NULL             
         Reply Message -                          NULL
         Primary DNS IP Address -                 0.0.0.0   
         Secondary DNS IP Address -               0.0.0.0   
         Primary WINS IP Address -                0.0.0.0          
         Secondary WINS IP Address -              0.0.0.0          
         Primary DNS IPv6 Address  -              ::
         Secondary DNS IPv6 Address  -            ::
         Framed Pool -                            not set          
         Class Attribute -                        TEST            
         Service Type -                           0                
         Client IPv6 Address -                    ::               
         Client IPv6 Mask -                       null             
         Framed IPv6 Prefix -                     ::/0
         Framed IPv6 Pool -                       not-set          
         NDRA IPv6 Prefix -                       not-set          
         Login IPv6 Host -                        ::               
         Framed Interface Id -                    0:0:0:0      
         Delegated IPv6 Prefix -                  ::/0  
         Delegated IPv6 Pool -                    not-set          
         User Password -                          $ABC123           
         CHAP Password -                          NULL             
         Mac Address -                            00:00:5E:00:53:ab
         Idle Timeout -                           600             
         Session Timeout -                        6000            
         Service Name (1) -                       cos-service(video_sch, nc_sch)
         Service Statistics (1) -                 1                
         Service Acct Interim (1) -               600              
         Service Activation Type (1) -            1                
         Service Name (2) -                       filter-service(in_filter, out_filter)
         Service Statistics (2) -                 2                
         Service Acct Interim (2) -               900              
         Service Activation Type (2) -            1                
         Cos shaping rate -                       100m             
         Filter Id -                              not set          
         Framed MTU -                             (null)           
         Framed Route -                           not set          
         Ingress Policy Name -                    not set          
         Egress Policy Name -                     not set          
         IGMP -                                   disabled         
         Redirect VR Name -                       default          
         Service Bundle -                         Null             
         Framed Ip Route Tag -                    not set          
         Ignore DF Bit -                          disabled         
         IGMP Access Group Name -                 not set          
         IGMP Access Source Group Name -          not set          
         MLD Access Group Name -                  not set          
         MLD Access Source Group Name -           not set          
         IGMP Version -                           not set          
         MLD Version -                            not set          
         IGMP Immediate Leave -                   disabled         
         MLD Immediate Leave -                    disabled         
         IPv6 Ingress Policy Name -               not set          
         IPv6 Egress Policy Name -                not set          
         Acct Session ID -                        1                
         Acct Interim Interval -                  750              
         Acct Type -                              1                
         Ingress Statistics -                     disabled         
         Egress Statistics -                      disabled         
         Chargeable user identity -               0                
         NAS Port Id -                            -0/0/0.0         
         NAS Port -                               4095             
         NAS Port Type -                          15               
         Framed Protocol -                        1                
         IPv4 ADF Rule -                          010100
         IPv4 ADF Rule -                          010101
         IPv6 ADF Rule -                          030100
         IPv6 ADF Rule -                          030101
    ****Pausing 10 seconds before disconnecting the test user*********
    Logging out subscriber
         Terminate Id -                           not set          
    Test complete. Exiting

You can use the agent-remote-id ari option with the test aaa dhcp user and test aaa ppp user commands to verify DHCP and PPP subscriber authentication in those networks that support the DSL Forum Agent-Remote-Id (VSA 26-2).

If you specify the DSL Forum Agent-Remote-Id, the output includes the specified value. If you do not specify the VSA, then the Agent-Remote-Id value is shown as NULL.

content_copy zoom_out_map
user@host>test aaa ppp user thomastank agent-remote-id “(202)555–1212”

    Authentication Grant
    ************User Attributes***********
         User Name -                              thomastank
         Client IP Address -                      192.168.1.1
         Client IP Netmask -                      255.255.0.0
         ...
         NAS Ip Address -                         0.0.0.0
         Agent Remote Id -                        (202)555–1212
         ...

The following example shows output when the authentication grant fails due to an invalid password:

content_copy zoom_out_map
user@host>test aaa ppp user user45@test.net password 55N33%%56
Authentication Deny
    Reason : Access Denied
    Received Attributes :
         User Name -                              user45@test.net    
         Client IP Address -                      0.0.0.0          
         Client IP Netmask -                      0.0.0.0          
         Virtual Router Name -                    default          
         Agent Remote Id -                        NULL             
         Reply Message -                          NULL             
         Primary DNS IP Address -                 0.0.0.0          
         Secondary DNS IP Address -               0.0.0.0          
         Primary WINS IP Address -                0.0.0.0          
         Secondary WINS IP Address -              0.0.0.0          
         Primary DNS IPv6 Address  -              ::               
         Secondary DNS IPv6 Address  -            ::               
         Framed Pool -                            not set          
         Class Attribute -                        not set          
         Service Type -                           0                
         Client IPv6 Address -                    ::               
         Client IPv6 Mask -                       null             
         Framed IPv6 Prefix -                     ::/0             
         Framed IPv6 Pool -                       not-set          
         NDRA IPv6 Prefix -                       not-set          
         Login IPv6 Host -                        ::               
         Framed Interface Id -                    0:0:0:0          
         Delegated IPv6 Prefix -                  ::/0             
         Delegated IPv6 Pool -                    not-set          
         User Password -                          55N33%%56        
         CHAP Password -                          NULL             
         Mac Address -                            00:00:5E:00:53:ab
         Filter Id -                              not set          
         Framed MTU -                             (null)           
         Framed Route -                           not set          
         Ingress Policy Name -                    not set          
         Egress Policy Name -                     not set          
         IGMP -                                   disabled         
         Redirect VR Name -                       default          
         Service Bundle -                         Null             
         Framed Ip Route Tag -                    not set          
         Ignore DF Bit -                          disabled         
         IGMP Access Group Name -                 not set          
         IGMP Access Source Group Name -          not set          
         MLD Access Group Name -                  not set          
         MLD Access Source Group Name -           not set          
         IGMP Version -                           not set          
         MLD Version -                            not set          
         IGMP Immediate Leave -                   disabled         
         MLD Immediate Leave -                    disabled         
         IPv6 Ingress Policy Name -               not set          
         IPv6 Egress Policy Name -                not set          
         Acct Session ID -                        12               
         Acct Interim Interval -                  0                
         Acct Type -                              0                
         Ingress Statistics -                     disabled         
         Egress Statistics -                      disabled         
         Chargeable user identity -               0                
         NAS Port Id -                            -0/0/0.0         
         NAS Port -                               4095             
         NAS Port Type -                          15               
         Framed Protocol -                        0                
    Test complete. Exiting

For some networks, such as a Layer 2 network with VLAN-OOB subscribers, RADIUS is configured to provide the subscriber address in a client profile with the Client-Profile-Name VSA (26–174). In the default configuration, the test fails when it does not receive a subscriber address directly from RADIUS. To successfully test these subscribers, you must include the no-address-request option. The command output displays the client profile name in the Dynamic Profile field and the name of the routing instance conveyed by the Virtual-Router VSA (26-1) in the Routing Instance field.

content_copy zoom_out_map
user@host>test aaa ppp user thomastank no-address-request

    Authentication Grant
    ************User Attributes***********
         User Name -                              thomastank
         Client IP Address -                      0.0.0.0
         Client IP Netmask -                      0.0.0.0
         ...
         IPv6 Egress Policy Name -                not set          
         Dynamic Profile-                         filter-service
         Routing Instance -                       VR27fin
         ...

Starting in Junos OS Release 19.3R1, the XML output format has changed. Each RADIUS server attribute name has an associated attribute value. Each of these pairs is now enclosed by the <radius-server-data> tag. The new tag makes it easier to recognize the name/value pairs, both for operators and API clients.

Note:

You may have to change any scripts that use the XML output to work properly with the new format.

The following example shows an excerpt of sample XML output in the old format:

content_copy zoom_out_map
user@host>test aaa ppp user user45@test.net password $ABC123 | display xml

<rpc-reply xmlns:junos="namespace-URL">
    <aaa-test-result>
        <aaa-test-status>Authentication Grant</aaa-test-status>
        <aaa-test-status>************User Attributes***********</aaa-test-status>
        <radius-server-attribute-name>User Name -</radius-server-attribute-name>
        <radius-server-attribute-value>user45@test.net</radius-server-attribute-value>
        <radius-server-attribute-name>Virtual Router Name (LS:RI) -</radius-server-attribute-name>
        <radius-server-attribute-value>default:default</radius-server-attribute-value>
        <radius-server-attribute-name>Service Type -</radius-server-attribute-name>
        <radius-server-attribute-value>Framed</radius-server-attribute-value>
        <radius-server-attribute-name>Agent Remote Id -</radius-server-attribute-name>
        <radius-server-attribute-value>&lt;not set&gt;</radius-server-attribute-value>
...
  <aaa-test-status>Test complete. Exiting</aaa-test-status>
    </aaa-test-result>
    <cli>
        <banner></banner>
    </cli>
</rpc-reply>

The following example shows an excerpt of sample XML output in the new format:

content_copy zoom_out_map
user@host>test aaa ppp user user45@test.net password $ABC123 | display xml

<rpc-reply xmlns:junos="namespace-URL">
    <aaa-test-result>
        <aaa-test-status>Authentication Grant</aaa-test-status>
        <aaa-test-status>************User Attributes***********</aaa-test-status>
        <radius-server-data>
            <radius-server-attribute-name>User Name -</radius-server-attribute-name>
            <radius-server-attribute-value>user45@test.net</radius-server-attribute-value>
        </radius-server-data>
        <radius-server-data>
            <radius-server-attribute-name>Virtual Router Name (LS:RI) -</radius-server-attribute-name>
            <radius-server-attribute-value>default:default</radius-server-attribute-value>
        </radius-server-data>
        <radius-server-data>
            <radius-server-attribute-name>Service Type -</radius-server-attribute-name>
            <radius-server-attribute-value>Framed</radius-server-attribute-value>
        </radius-server-data>
        <radius-server-data>
            <radius-server-attribute-name>Agent Remote Id -</radius-server-attribute-name>
            <radius-server-attribute-value>&lt;not set&gt;</radius-server-attribute-value>
        </radius-server-data>
...
        <aaa-test-status>Test complete. Exiting</aaa-test-status>
    </aaa-test-result>
    <cli>
        <banner></banner>
    </cli>
</rpc-reply>

Change History Table

Feature support is determined by the platform and release you are using. Use Feature Explorer to determine if a feature is supported on your platform.

Release
Description
19.3R1
Starting in Junos OS Release 19.3R1, the XML output format has changed.
footer-navigation