Configuring Digest Authentication

In the Oracle Communications Session Border Controller ACLI, you can access the Digest Authentication object at the path session-router, session-agent, auth-attribute. If enabled, the Digest Authentication process uses the attributes and values listed in this table.

Note:

If enabling Digest Authentication, all attributes listed below are required except for the in-dialog-methods attribute which is optional.

The following table lists the digest authentication object

ORACLE(auth-attribute)# show
        auth-attribute
                auth-realm                     realm01
                username                       user
                password                       ********
                in-dialog-methods              ACK INVITE SUBSCRIBE

To configure digest authentication on the Oracle Communications Session Border Controller:

In Superuser mode, type configure terminal and press Enter.
```
ORACLE# configure terminal
```
Type session-router and press Enter to access the session router-related objects.
```
ORACLE(configure)# session-router
ORACLE(session-router)#
```
Type session-agent and press Enter to access the session agent-related attributes.
```
ORACLE(session-router)# session-agent
ORACLE(session-agent)#
```
Type auth-attribute and press Enter to access the digest authentication-related attributes.
```
ORACLE(session-agent)# auth-attribute
ORACLE(auth-attribute)#
```
auth-realm — Enter the name (realm ID) of the host realm initiating the authentication challenge. This value defines the protected space in which the digest authentication is performed. Valid value is an alpha-numeric character string. Default is blank.
```
ORACLE(auth-attribute)# auth-realm realm01
```
username — Enter the username of the client. Valid value is an alpha-numeric character string. Default is blank.
```
ORACLE(auth-attribute)# username user
```
password — Enter the password associated with the username of the client. This is required for all LOGIN attempts. Password displays while typing but is saved in clear-text (i.e., *****). Valid value is an alpha-numeric character string. Default is blank.
```
ORACLE(auth-attribute)# password *******
```
in-dialog-methods — Enter the in-dialog request method(s) that digest authentication uses from the cached credentials. Specify request methods in a list form separated by a space enclosed in parentheses. Valid values are:

INVITE | BYE | ACK | CANCEL | OPTIONS | SUBSCRIBE | PRACK | NOTIFY | UPDATE | REFER
```
ORACLE(auth-attribute)# in-dialog-methods (ack invite subscribe)
```
Note:
The methods not in this list are still resubmitted if a 401/407 response is received by the Oracle Communications Session Border Controller.

If you do not specify any in-dialog-method value(s), digest authentication does not add challenge-responses to in-dialog requests within a dialog.

This attribute setting applies to in-dialog requests only.