Borrower Portal

The Borrower Portal requires the Nortridge Services Platform (NSP) to function. Please refer to the deployment guide accompanying the NSP installation files for installing NSP. For hosted clients, please contact Nortridge Support to have our infrastructure team set up NSP for you.

See the System Requirements page for Borrower Portal requirements.

Step 1

Borrower Portal 6

Download and install the latest .NET 6 ASP.NET Core Runtime & Hosting Bundle for Windows. Restart the computer after installation.

Borrower Portal 5

Download and install the latest .NET 5 ASP.NET Core Runtime & Hosting Bundle for Windows. Restart the computer after installation.

Borrower Portal 2 – 4

Download and install the latest .NET Core 2.1 Runtime & Hosting Bundle for Windows. Restart the computer after installation.

Step 2

Copy the borrower-portal-web-app folder to the IIS root folder (typically C:\inetpub\wwwroot\).

Step 3

Edit the appsettings.json file with a text editor with the following information. These are the minimum parameters needed to be defined to get Borrower Portal up and running. See the section on Appsettings.json File for details on additional parameters.

Note

The text editor may need to be run as administrator to allow it to save the file.
Authentication  
BaseAddress Base Address of the NSP Auth service used for authentication (e.g. http://nspauth.domain.com).
ClientId The unique name for the Auth Client.
ClientSecret The secret (i.e. password) for the NSP Auth service. The value entered will be hashed and stored in the database.
ServerScopeBP 2.0+ Used in conjunction with DatabaseScope to connect to an NSP Auth instance hosted on auth.nortridgehosting.com.
DatabaseScopeBP 2.0+ Used in conjunction with ServerScope to connect to an NSP Auth instance hosted on auth.nortridgehosting.com.
ImportXml
Username The Username of the NLS User used to perform Import XML requests to NSP API.
Password The Password of the NLS User used to perform Import XML requests to NSP API.
NlsApi  
BaseAddress The Base Address of the NSP API service (e.g. http://nspapi.domain.com)

Step 4

Open the Internet Information Service (IIS) Manager application. Right click on the Connections pane and select Add Website….

Enter the site name and specify the physical path to the borrower portal folder.

Click Connect as… and specify credentials to use if needed.

Step 5

Go to Application Pools and select borrowerportal. Click Advanced Settings… and set .NET CLR Version to No Managed Code and Start Mode to AlwaysRunning.

Step 6

Open https://localhost:port in your web browser to verify that the borrower portal is running.

Note

If you encounter a 502.5 error when accessing the borrower portal, restart the computer and re-load the borrower portal.

Apsettings.json File

Authentication 
BaseAddressBase Address of the NSP Auth service used for authentication (e.g. http://nspauth.domain.com).
ClientIdThe unique name for the Auth Client.
ClientSecretThe secret (i.e. password) for the NSP Auth service. The value entered will be hashed and stored in the database.
SessionSpanThe amount of time of inactivity before session expires. Format: Hours:Minutes:Seconds (e.g. “0:30:00” is 30 minutes).
Removed from Apsettings.json file as of version 3.0. This values is read from the Web Inactivity Timeout setting in the NLS System Defaults.BP 3.0+
BeforeRefreshSpanThe amount of time before an Access Token expires when a new Access Token is requested. Format: Hours:Minutes:Seconds (e.g. “0:01:00” is 1 minute).
No longer needed as of version 3.0.BP 3.0+
ServerScopeBP 2.0+Used in conjunction with DatabaseScope to connect to an NSP Auth instance hosted on auth.nortridgehosting.com.
DatabaseScopeBP 2.0+Used in conjunction with ServerScope to connect to an NSP Auth instance hosted on auth.nortridgehosting.com.
ImportXml
UsernameThe Username of the NLS User used to perform Import XML requests to NSP API.
PasswordThe Password of the NLS User used to perform Import XML requests to NSP API.
NlsApi 
BaseAddressThe Base Address of the NSP API service (e.g. http://nspapi.domain.com)
CookiePolicyOptions 
MinimumSameSitePolicyBP 6.0+
Valid values are None, Lax, or Strict.
Logging 
LogLevel
DefaultThe minimum Default Log Level. Supported Values: Trace, Debug, Information, Warning, Error, Critical, None.
Log4NetCore 
WatchIf set to true, the site will respond to changes made in the log4net.config file without restarting the site.
  
AllowedHostsA value of “*” allows all hosts to access the site.
AutomatedPayment 
DefaultAchCompanyIDIf an ACH Company is not set by default for a Loan Group, this ID is used.
DefaultAftCompanyIDIf an AFT Company is not set by default for a Loan Group, this ID is used.
DisableCardPaymentsBP 6.0+
Default is false. If true, Card Payments are disabled.
UserAuthentication 
SecurityQuestionExpriationThe number of days before the security questions need to be answered on a computer with the Trust My Computer cookie.
ForgotPasswordTokenSpanThe amount of time before the Forgot Password Token Expires. Format: Hours:Minutes:Seconds (e.g. “1:00:00” is 1 hour).
ImportXMLTokenSpanThe amount of time before the Access Token used to perform the Import XML requests to NSP API expires (e.g. “0:20:00” is 20 minutes).
SmtpServer 
HostThe name or IP address of the host used for SMTP transactions (e.g. smtp.office365.com).
PortThe Port used for SMTP transactions (e.g. 587).
UsernameThe Username used to authenticate the sender.
PasswordThe Password used to authenticate the sender.
UseSSLIf true, the SMTP Client will use Secure Sockets Layer (SSL) to encrypt the connection.
EmailFromThe sender of the email message.
Payix 
UsernameUsername used to authenticate Payix Payment Gateway requests.
As of version 3.0, this value is read from NLS Setup > Loan Setup > Automated Payments > Card > Gateway.BP 3.0+
PasswordPassword used to authenticate Payix Payment Gateway requests.
As of version 3.0, this value is read from NLS Setup > Loan Setup > Automated Payments > Card > Gateway.BP 3.0+
AddPaymentMethodsUrlThe all-payment-methods Payix API URL.
As of version 3.0, this value is read from NLS Setup > Loan Setup > Automated Payments > Card > Gateway.BP 3.0+
CreatePaymentTokenUrlThe create-payment-token Payix API URL.
No longer needed as of version 3.0.BP 3.0+
MakePaymentUrlThe make-payment Payix API URL.
As of version 3.0, this value is read from NLS Setup > Loan Setup > Automated Payments > Card > Gateway.BP 3.0+