Skip to main content

IP Blacklisting Value-Added Module Deployment Guide

This Value-Added Module adds the IP Blacklisting provider feature to the SecureAuth Identity Platform versions 9.2 and 9.3.

It consists of a customization that allows the administrator to add a Risk User Provider for Adaptive Authentication and specifies to send the IP in the service call. With this, a client service with the IP could send back a risk score which will be used to specify desired scenarios.

The IP Blacklisting Provider customization will give you the opportunity to set the course of the authentication process depending on the user’s IP.

Architecture

IP_Blacklisting_VAM_001.jpg

Installation guidelines

  1. Download the files from the email you received from SecureAuth

  2. Drag the files and drop them into the following folders:

    1. Realm bin folder: SecureAuth.AnalyzeEngine.dll.

    2. AnalyzeApi bin folder (located in the SecureAuth master folder):

      SecureAuth.AnalyzeEngine.BLL.dll, SecureAuth.AnalyzeEngine.Model.dll.

System development parameters

This VAM was developed and tested using the following systems.

  • IP Blacklisting VAM package.

  • Tested using SecureAuth Identity Platform v9.2

Configuration guidance

  1. Access the Admin panel and go to the Adaptive Authentication tab.

  2. Slide the User Risk toggle switch to Enabled.

  3. Click the Add User Risk Score Provider button, as shown in the figure below.

    IP_Blacklisting_VAM_002.jpg
  4. Complete the form information (as seen in the following image). Set the desired Risk Ranges, Risk Score Provider Name, Base URL, endpoint URL, Authentication Method, Username, and Password.

    1. In your endpoint, specify {ip} in the Get Profile Relative URL text field wherever you want to send the user’s IP address.

      For example, /api/RiskService/{ip}.

      An example call should be similar to: baseurl/api/RiskService/xxx.xxx.xxx.xxx.

    2. In the Risk Score JSON Path, you must specify the path to get the score from your service response.

      For example, if your service response is {“score”:55}, then the path to get the value would be {score}.

      IP_Blacklisting_VAM_003.jpg

      Note

      If there’s an authentication method other than “Basic”, user must provide valid credentials in the username/password fields.

  5. Finally, specify every action for the score received, as demonstrated in the image below.

    IP_Blacklisting_VAM_004.jpg

Installation overview

  1. Copy the SecureAuth.AnalyzeEngine.dll into the bin folder of the desired realm and into the shared folder within realms called AnalyzeApi.

  2. In that same shared folder, copy the rest of the dlls, SecureAuth.AnalyzeEngine.BLL.dll, and SecureAuth.AnalyzeEngine.Model.dll.

  3. In the Admin Panel under the Adaptive Authentication tab, add a new Risk Provider, following the steps inside this guide to set up the service that will test the user IP and generate a score to be used to direct the desired flow of authentication.

  4. Remember to enable User Risk and also the Provider, as shown in the previous images.

Upgrade information

Before upgrading SecureAuth software, open a Support ticket. The process of upgrading to a newer SecureAuth software version might cause the SecureAuth VAM to become invalid and stop working. When your site is ready to upgrade SecureAuth software, get started by creating a support ticket selecting I have a question or issue regarding SecureAuth Value-Added Modules (VAMs) from the "Submit a request" list. A SecureAuth Tailoring engineer will contact you to evaluate and ensure that the VAM will work with updated SecureAuth software.