Guidance

IMS connectivity guide (accessible version)

Updated 5 April 2024

Applies to England

1. Overview

This document details the necessary steps and procedures required for organisations to access the Investment Management System (IMS). Organisations accessing IMS will fall into one of the following categories:

• Registered providers: organisations who are registered with the Homes England regulator. Provider codes follow the format A# # # #, C# # ##, L# # # #, LH# # # #, ##AA
• Unregistered providers: organisations who are not registered. Organisation codes follow the format NP# # # #
• Local authorities: some local authorities have read only access to view schemes within their local authority area Bids for funding are not allowed using this log-in. A three-digit numerical code is provided for each local authority.

2. Client requirements

The following is required for connection to the IMS system:

• internet connectivity 바카라 사이트� specifically on port 443
• a supported browser 바카라 사이트� for example: IE11, Edge, Chrome or Firefox
• Citrix client

3. Citrix client

New users of IMS will need to install a Citrix client. If your organisation already uses other Citrix applications, then you may already have a Citrix client installed on your computer.

Whilst you don바카라 사이트檛 have to install the latest version of the Citrix client before accessing IMS it바카라 사이트檚 recommended to install the latest version for improvements and security updates.

3.1 Install the Citrix client from the homepage

If you are accessing IMS from a tablet or mobile device, you can install the Citrix Workspace App from the relevant App Store 바카라 사이트� for example, Google Play Store or Apple Store 바카라 사이트撀� by searching for 바카라 사이트淐itrix Workspace바카라 사이트�.

1. Open and click on Citrix.com
2. Click on Citrix Workspace app 20xx for Windows (note: this number will change periodically when Citrix release new versions). Further down the page there is a link for a 바카라 사이트淲orkspace app for Mac바카라 사이트� for any Apple Mac users to download and install the latest version.
3. Click on 바카라 사이트楧ownload Citrix Workspace app바카라 사이트� for Windows which will download a file named CitrixWorkspaceApp.exe
4. Once CitrixWorkspaceApp.exe has downloaded double click to install it.

Follow the wizard steps:

1. You바카라 사이트檒l see a 바카라 사이트榃elcome to Citrix Workspace바카라 사이트� box. Click the start button.
2. This will take you to the Licence Agreement page. You바카라 사이트檒l need to read the agreement and tick the 바카라 사이트淚 accept the license agreement바카라 사이트� then click Next.
3. Click Install 바카라 사이트� App protection is not required so you don바카라 사이트檛 need to enable it. This will then go through to the installation process.
4. After the installation is complete, click 바카라 사이트楩inish바카라 사이트�. If you click on 바카라 사이트楢dd Account바카라 사이트�, you바카라 사이트檒l be taken to another screen 바카라 사이트� click close as we don바카라 사이트檛 use this feature.

Alternatively save the installation file if you wish to deploy the Citrix client using your own software management system.

4. Connecting to IMS using the Citrix Gateway

IMS uses Citrix Gateway which simplifies the connectivity requirements. The website is accessed on port 443 which is the default SSL port for secure connections (HTTPS).

The IMS applications are then 바카라 사이트渢unneled바카라 사이트� through to the same address on port 443 using a secure connection from the Citrix client (ICA/SSL), with the Citrix client configured to automatically use your web browser바카라 사이트檚 connection settings.

In most cases the only requirement is that access to the above address is allowed on port 443. Because this is the default HTTPS port, it is envisaged that most organisations will already have this open.

4.1 ICA and SSL

HTTPS is HTTP wrapped in SSL (the encryption protocol) and is typically delivered over port 443. As port 443 is the official registered port for HTTPS any traffic over port 443 is assumed to be HTTPS by firewalls and proxy servers.

ICA/SSL is a Citrix-proprietary protocol used for secure communications between Citrix clients and servers, on port 443. Because SSL is the encryption protocol, firewalls, routers, proxies and so on between the client and the server cannot 바카라 사이트渟ee바카라 사이트� what is inside the protocol. Therefore, firewalls and proxies do not really differentiate between ICA/SSL and HTTPS, and typically try to treat ICA/SSL as HTTPS.

4.2 The connection process

Follow these steps:

1. The user connects to the website and logs in. This should be accessible in most cases as it바카라 사이트檚 the default HTTPS port and the Fully Qualified Domain Name is resolvable by any external DNS, like any other external website.
2. The user launches an application and a Citrix ICA file is automatically generated and passed to the Citrix client. The ICA file contains entries instructing the client to connect to https://secure.homesengland.org.uk on port 443 using the client바카라 사이트檚 default web browser settings.
3. The client computer will try to resolve 바카라 사이트渟ecure.homesengland.org.uk바카라 사이트� to an IP address before attempting to connect using the client computer바카라 사이트檚 default web browser connection settings.
4. If the default web browser connection settings allow direct internet access, you should not experience any problems connecting to the IMS applications.
5. If the default web browser connection settings route internet traffic through a proxy server or firewall, most proxy servers and firewalls should allow the connection as they will try to treat ICA/SSL the same as HTTPS traffic. However, in some cases there may be issues caused by proxy servers/firewalls preventing or interrupting ICA/SSL traffic due to the way they are configured to handle HTTPS traffic.

If you are having connection problems, please see troubleshooting.

5. IMS application access

1. On your computer open
2. Enter your Citrix username and password supplied by Homes England, which will then display the following page.
3. Click on the icon to launch IMS Live. The following page will be displayed as it connects to the application using the Citrix Workspace app 바카라 사이트� and may also display a prompt for Add Account.
4. When the application has been launched, enter your IMS User ID and Password.
5. If the Add Account prompt is displayed 바카라 사이트� tick the box Do not show this window automatically at sign-in to prevent this popping up on every login, then click Close.

5.1 聽Firewall and browsers

Depending which browser you are using it might download the launch.ica file but not automatically open the application 바카라 사이트� the image below is from Chrome where it has downloaded the file but needs you to click on Open or Always open files of this type to run IMS.

If using Internet Explorer, you might see an additional prompt as per the examples below 바카라 사이트� you바카라 사이트檒l need to click on 바카라 사이트淩un control바카라 사이트� or 바카라 사이트淎llow바카라 사이트� for IMS to launch.

Depending on your computer configuration you might have personal firewall software that could also prompt you to allow access when launching the IMS application.

5.2 Accessing from a tablet or mobile device (Apple or Android)

1. Install 바카라 사이트淐itrix Workspace바카라 사이트� from the App Store on the device.바카라 사이트�2. Open the Citrix Workspace app. There should be a 바카라 사이트�+바카라 사이트� button to add an account 바카라 사이트� click on this.
2. At the prompt to enter email address or Store URL type in https://secure.homesengland.org.uk then there should be an option underneath 바카라 사이트楢dd account type as Web Interface바카라 사이트� 바카라 사이트� this needs enabling as it바카라 사이트檚 a web interface only site.
3. Click Continue which will display the IMS login screen in the app (this will also save the connection for future use).
4. Enter your Citrix ID and password which will take you to the screen with the Connectivity Test and IMS Live icons.
5. Click on IMS Live - this will launch IMS in the Citrix Workspace app itself.
6. With it being on a tablet/mobile device it will show you the touchscreen Gestures at launch for using within the app (change to keyboard/pointer/zoom etc.) 바카라 사이트� if you click anywhere on the blank screen it will remove the Gestures box and you바카라 사이트檒l be able to see the IMS Login box.
7. Login to IMS with your IMS User ID and password. There should be a drop down arrow at the top of the screen where you can also change to keyboard, pointer, zoom and access the Gestures menu.

6. High DPI settings

Depending on your individual display configuration you may need to change the Citrix Workspace App바카라 사이트檚 default High DPI settings 바카라 사이트� single displays with high resolution and multiple displays with mixed screen resolutions and scaling will require a change to the setting for the application to display optimally.

In some cases, you바카라 사이트檒l see a blank box instead of the IMS application or are not able to click onto menus and enter text, or the application will display very small text 바카라 사이트� these can be resolved by following the steps below to allow Citrix to handle the scaling.

7. If you need to change the High DPI setting

1. With the聽IMS聽application open, click on the Taskbar as below and right click on the first Citrix icon (blue and white circle).
2. From the menu click on Advanced Preferences. Note: where there are two Citrix icons 바카라 사이트� if you right click on the second one, you바카라 사이트檒l only see menu options for 바카라 사이트淥pen바카라 사이트� and 바카라 사이트淓xit바카라 사이트�.
3. From the Advanced Preferences window that is displayed click on High DPI.
4. The default setting is 바카라 사이트淟et the operating system scale the resolution바카라 사이트� 바카라 사이트� click on Yes to change this to allow the Citrix client to handle the scaling then click on Save (you can then close the Advanced Preferences window). The new setting will apply next time you launch an application.

Note: the 바카라 사이트淣o, use the native resolution바카라 사이트� option is generally not recommended as this won바카라 사이트檛 scale and can make the text very small.

8. Changing your Citrix password

You will be prompted to change your Citrix password 7 days before it expires. You can also change it anytime.

Your Citrix password requires changing every 60 days, it must be a minimum of 8 characters in length and contain at least three of the following: upper case, lower case, number, special character. You cannot reuse the last 5 passwords.

To change your password, follow these steps:바카라 사이트�

1. In the top right-hand corner of the website click on the settings link.
2. Click on Account Settings.
3. Click on the Change Password.
4. Click Continue to the warning that you바카라 사이트檒l need to logoff the website and login again after you have changed your password.
5. The Change Password box will now be displayed. Enter your old and new passwords as prompted then click OK.
6. Click OK to the confirmation that your password has been changed.
7. You바카라 사이트檒l be automatically logged off the website after 30 seconds or you can click the Complete Logoff button 바카라 사이트� you바카라 사이트檒l then need to close the browser and login again with your new password.

9. Printing from IMS

When you login to the IMS application, only your default printer will be mapped. If you need to print to a different printer, you will need to change your default printer before logging into the application.

The following workaround will help with some of the known issues such as printing dots where the text should be, reversed text, hashes instead of numbers etc.

9.1 Print to a PDF writer

If you have a PDF writer already installed on your computer, you will need to set it as your default printer when you print reports from IMS.

When prompted, select the location and filename of where you want to save the PDF file. Once it has saved it may automatically open the report, if not, open the file from where you saved it. If the report looks OK, you can then print this as a normal printout.

However, some IMS reports may still have the text mirrored. If this occurs, you will need to make a change to the PDF writer properties as below.

To do this, you may have to ask your IT department to help as it may require administration privileges.

10. Troubleshooting

If the following solutions don바카라 사이트檛 resolve the issue, or you would like any help, contact the Homes England Service Desk.

10.1 Proxy or firewall configurations

You may see error messages such as 바카라 사이트淭here is no Citrix SSL server configured on the specified address바카라 사이트� or 바카라 사이트淭he Citrix SSL server you have selected is not accepting connections바카라 사이트�.

If the Citrix client connection fails, verify that SSL tunneling is allowed for this address. ICA/SSL traffic requires a single continuous SSL connection between the client and server. For example: proxy servers allowing the CONNECT method (SSL tunneling) and firewalls in forwarding mode ensure that connections are opened directly between the client and the Citrix Gateway.

Some proxy servers allow SSL tunneling by default, but some require it enabling. Similarly, verify that no restrictions are placed on ICA/SSL traffic such as time-outs on sessions, including idle, absolute, and data traffic time-outs.

Alternatively, allow to bypass the proxy/firewall and give direct internet access to this address.

10.2 Citrix client cannot resolve the name 바카라 사이트渟ecure.homesengland.org.uk바카라 사이트�

If you can access the website but the application fails to launch, verify that the client computer can directly resolve the address 바카라 사이트渟ecure.homesengland.org.uk바카라 사이트�. This issue can occur when the client computer is not able to resolve external addresses itself, such as when a proxy server is used for internet access, and the proxy server performs all external DNS resolution.

10.3 If you receive a prompt to save an .ICA file

The default action might be to download the .ICA file then you can click on the downloaded file to run it 바카라 사이트� they normally give an option to 바카라 사이트淎lways open files of this type바카라 사이트� which will allow the聽IMS聽application to load automatically when you click on the聽IMS聽Live link in the future.

10.4 Nothing happens when you launch IMS

Make sure the 바카라 사이트�.ICA바카라 사이트� file type is associated with 바카라 사이트淐itrix Connection Manager바카라 사이트�.

10.5 聽If your version of the Citrix client contains a bug or is incompatible

For example, some early versions of the client contain several bugs with regards to proxy/SSL connections and can cause errors preventing connection.

If possible, upgrade the Citrix client to the latest version.

10.6 If your firewall software stops the connection to the Citrix client

Check any personal firewall software and allow the Citrix client access on port 443. 바카라 사이트�

11. Help and support

For IMS support, contact the Homes England Service Desk.

Phone: 01908 353604 Email: servicedesk@homesengland.gov.uk

바카라 사이트�