Integrate generic RADIUS applications

1.      Click > Security > Applications. The Add Applications page appears.

2.      Click Add. The Select an Application Template page appears.

3.      Do one of the following:

●       Select RADIUS and VPN Integrations from the search drop-down list and scroll to find the application you want to add to IDaaS.

- or -

●       In the Search bar, enter a search option to filter for the application you want to add to IDaaS.

4.      Click Generic Radius Client. The Add Generic RADIUS Client General Settings page appears.

5.      Configure the App Settings.

a.      Enter an Application Name for your generic RADIUS client.

b.      Enter a Description for your application.

6.      Under RADIUS Settings, do the following:

a.      Click Add to next to Hosts to add the host name of the VPN server. The RADIUS agent receives the request on this host. The RADIUS Agent on the Gateway determines the RADIUS application the request is for based on the host name and port.

b.      Enter the host name in the Host dialog box and then click OK. Repeat this step to add more host names.

c.      In the Port field, enter the port on which the RADIUS agent accepts messages.

Tip: Do not enter 8443 as the port number for this application. Port 8443 is used by the Entrust Identity Enterprise agent in your Gateway.

Attention: The RADIUS agent uses the host name that sent a request and the port number that it received the request from to determine which RADIUS application made the request. Because of that:
–Two RADIUS applications with the same port value cannot share any host names.
–Two RADIUS applications that have one or more matching host names must have different port values.

d.      From the Select RADIUS Agent drop-down list, do one of  the following:

–  Select the name of the Gateway containing the RADIUS agent to which this application will be assigned.

-OR-

–  Click Create and enter the Gateway Name in the Create Gateway dialog box and click Create.

e.      Optional: Select Log RADIUS messages to enable RADIUS message logging. When enabled, messages for the RADIUS agent are logged to the same log file as the gateway logs.  

7.      Configure the Authentication Settings.

a.      Select Enable Push Authentication Fallback if you want to authentication to fallback to another authenticator in the event of a failure. If required, set the Push Authentication Fallback Timeout to the number of minutes before the push authentication times out.

b.      Select When authenticating the user will be asked to select their second-factor authenticator. When selected, after the user responds to the first-factor challenge, they are prompted to select their second-factor authenticator. The list of available second-factor authenticators is set by the resource rule.

The following is a list of supported strings matched to the authentication types:

–  Grid: grid

–  Knowledge-based Authentication: kba

–  One-time password: email, sms, voice

–  Smart Credential Push: scpush

–  Temporary Access Code: tac

–  Token: token

–  Token push: push

c.      Select Indicate if requests must include the message-authenticator attribute for incoming messages to include the message-authenticator attribute for incoming messages.

d.      Select Indicate if requests must include the message-authenticator attribute for outgoing messages to include the message-authenticator attribute for outgoing messages.

e.      Select Remove domain from user ID for incoming requests to remove the domain value from the user ID during authentication when the user ID provided by the RADIUS client is in the format domain\username and the user ID in IDaaS is in the format username.

f.        Select Indicate if Active Directory password authentication requests are handled by the same Gateway Instance that initiated the request to require that Active Directory password authentication and change requests that are initiated as part of the RADIUS authentication are handled by any Gateway Instance in the same Gateway cluster that initiated it. If disabled, the request is handled by any Gateway Instance.

g.      Select Enable one-step multi-factor authentication. When enabled, the user enters their user ID and then their password and token response in the password field. If you select this option, second factor authenticators available in the resource rule are limited to token and temporary access code.

h.      Enter the One-step multi-factor authentication security token length. This is the length of the token or temporary access code response if you enable one-step multi-factor authentication.

8.      Configure the Response Attributes. Response attributes are returned to the RADIUS application after successful authentication. Use this setting to configure RADIUS attributes to return information such as the user's group information to the VPN server.

When adding response attributes, you optionally add group filters. For example:

Example:

Users in IDaaS may belong to one of the following groups CANADA, US, UK, FRANCE.

The VPN server wants the FilterID attribute returned from the IDaaS RADIUS agent to be the value NA or EUROPE, depending on whether the user is in NA (Canada, US) or Europe (UK, France).

To do this, use a RADIUS attribute filter for the FilterID attribute with a Groups value with the following filters:
- match CANADA, replace NA
- match US, replace NA
- match UK, replace EUROPE
- match FRANCE, replace EUROPE

Set the Response Attributes as follows:

a.      Click Add. The Add a Response Attribute dialog box appears.

b.      Select the RADIUS Attribute ID from the drop-down list. The option you select depends on your VPN vendor.

c.      Select the Value Type.

–  To return a static value specific in the RADIUS attribute definition, select Static and enter a Value in the field and then click Add.

–  To return the user’s group membership, select Group and then optionally do the following:

i)        Click Add to add filters.

ii)      Enter the Match and the Replace attribute filters.

iii)     Click Add to add more attribute filters.

iv)     If you add multiple filters, you can drag and drop them in order of preference.

v)       Select Stop after matching filter if you only want one the filter to return one value. Using the example above, if you want NA to have preference over Europe, make sure to list Canada and US in the list of filters.

vi)      Multiple Values Per Attribute, enter the Value Separator

d.      Click Add.

Note: If a user belongs to more than one group, you can either add a separate attribute to your RADIUS response for each group or you can combine all of the groups into a single attribute. For example, if the user belongs to G1,G2,G3 then you would
- return a RADIUS response with three attributes
 OR
- return a RADIUS response with one attribute and a value like “G1,G2,G3” where the , is defined in the Value Separator setting or a value like “G1 G2 G3” where the Value Separator is defined as a space.

Attention: The default group separator is a space. If you have group names that are separated by a space, use another separator, such as a comma.

e.      Repeat these steps to add more response attributes.

9.      Optional: Configure the EAP Settings to set up the application to use the EAP RADIUS authentication protocol.

a.      Select EAP Enabled to allow the RADIUS application to accept EAP messages.

–  When enabled, authentication messages with EAP content are treated as EAP requests. The application can accept only EAP authentication requests.

–  When disabled, incoming authentication requests are processed by the RADIUS application as a standard RADIUS authentication request (even if the request includes EAP content). In this case, the application can accept only standard RADIUS authentication requests.

b.      Select the EAP Protocol from the drop-down list. The options are PEAPv0 with MS-CHAPv2 and PEAPv1 with GTC.

This setting defines the type of EAP authentication protocol that is performed on EAP requests received by the RADIUS application. Consult the configuration requirements of your VPN server to determine which EAP protocol to select.

c.      Select Return MPPE Keys to include the MPPE (Microsoft Point-to-Point Encryption) recv and mppe send keys in the Access-Accept message returned during a successful EAP authentication. The setting is enabled by default.

d.      Select Use PEAPv1 label when calculating MPPE Keys to use the PEAPv1 label when calculating the mmpe recv and mppe send keys.

Note: Leave the Minimum TLS Version,  Maximum TLS Version and Allow Weak Ciphers at the default settings unless you have an older VPN and need to configure these settings to allow older versions of TLS or weaker ciphers to interoperate with older VPN servers that do not support the latest versions.

10.  Click Show Advanced Settings to configure the advanced settings.

a.      Optional: From the Select RADIUS Attribute for IP Address drop-down list, select the RADIUS attribute that corresponds to your IP location.

b.      In the Challenge Response Queue Max Time field, set the number of seconds that the RADIUS agent waits for a response to first-factor authentication. The default value is 180 seconds.

c.      In the Challenge Response Queue Max Size field, set the maximum number of second-factor challenge requests allowed in the queue of your RADIUS application. The default value is 1000 requests. The maximum value is 10,000.

d.      In the Request Cache Timeout field, set the number of seconds to cache requests. The default value is 10 seconds.

e.      From the Character Set drop-down list, select the character set used to decode and encode string values (including the user ID and password values) in RADIUS messages. The options are UTF-8 and ISO-8859-1.

11.  Click Save.

12.  Proceed to Step 2: Configure Customizations.

1.      Click the Customization tab. The Customization page appears.

2.      Optional. Add a custom application logo, as follows:

a.      Click next to Application Logo. The Upload Logo dialog box appears.

b.      Click to select an image file to upload.

c.      Browse to select your file and click Open. The Upload Logo dialog box displays your selected image.

d.      If required, resize your image.

e.      Click OK.

3.      Select the Authentication Flow that appears to users during login. You must select at least one. For more information on Passkey log in, see Manage Passkey/FIDO2 authenticators.

4.      Click Save.

5.      Proceed to Step 3: Configure a resource rule.