Bitvise/Cyberduck Setup with 2FA

2FASetup in PrismWeb

  1. Upon receiving the confirmation email that your cutover is complete, login into

    1. PrismWeb Manager (https://manager.prismservices.net) in Azure using your previous credentials.

  2. Navigate to ‘Manage’ in your menu and select ‘FTP access’ from the drop down menu

3. You will then be presented with your 2FA login details, 2FA application recommendations, a QR code and recommendations for FTP clients, as well as links for set up information for each option

If for any reason you are presented with a message saying ‘You are not set up with FTP – please contact support” at this stage, please contact us, as it is likely that your user name is not synced to an FTP username and we will need to get this set up for you. 

4. Open up your preferred 2FA application and scan the QR code presented on the screen

5. Follow the instructions provided in the “FTP Client Setup” section for setting up your preferred SFTP client.  Please note: BitVise and Cyberduck are the only ones we have validated and currently support 

Additional notes:

  • Your staging address is now https://staging.prismservices.net/SITENAME.  Please note, SITENAME is unique to each customer.

  • We do not currently have the functionality to reset passwords so if you need a password to be reset, please contact us by placing a ticket in the PrismWeb ticket portal

  • You will be required to use one of the 2FA clients suggested, but you can continue to utilize the current web editor you use today.

  • If you have access to multiple sites, your FTP login will be the same for all sites 

  • FTP logins are linked to separate manager logins, so if you previously were using a shared filecloud user, this will change to unique logins

  • PC vs Mac considerations:

    • BitVise is Windows only

    • Mac users should use Cyberduck


 

 

Bitvise Set up and Usage

In order to access and edit your PrismWeb site files, you will need to use an FTP client.  One of the recommended clients is Bitvise.

Setup

Visit https://www.bitvise.com/ssh-client-download to download the Bitvise SSH Client Installer.

Locate the download and the open the installer.

 

After accepting the terms & conditions, select

Install.

After the install is complete, you can set up your website access.

 

In the Login tab of Bitvise enter the following:

Host: upload.prismservices.net
Port: 22
Username: enter the username you were using for Filecloud. 
If you do not know your username it can be found on PrismWeb Manager (https://manager.prismservices.net) under Manger > FTP Access under the Login section FTP Username.

The FTP username may not be the same as your Web Manager username. The FTP username is always your first name initial and your last name.


Initial Method: Use the dropdown to change to password.

Select Log In

Accept and Save host key.

 

Select Log In.

 

Enter your Password. To get your password, select the link provided to you in your 2FA Setup email, here is an example of the password link https://onetimesecret.com/secret/8occv6hrbzltkwlainnptu503h3hu3k. After you select the link it will take you to a website that holds your encrypted password. To show your password select “View Secret”.

 

After you select “View Secret” your 25 digit password will display in a box. This password will need to be recorded and used every time the login to the SFTP client.

If you do not see “View Secret” as an option or if you've lost your password, please contact PrismRBS Support (support@prismrbs.com).

Select OK.

The first User Authentication dialog box will display.  Select OK.

The second User Authentication dialog box will then display. Use the authenticator app you configured earlier (for example Microsoft Authenticator), and enter the six digit code you see there. Enter only the numbers, do not include any spaces.

Note: To get a totp authentication app, visit the app store for your mobile device, and download your product of choice. Install the app. After it opens, select to Add a New Account and scan the QR Code located on your PrismWeb Manager FTP Access screen. The app will give you a 6 digit code that you will enter in your User Authentication b.

Select OK.

Your site files will now display. Your website files will be on the right, with your local computer files on the left.

 

Editing

To upload a file, you can simply drag the file from your local folder on your computer displayed on the left under Local Files to the site file folder on the right under Remote Files.

A number of different programs can be used to edit your site files. If you have an editor you are already using to edit your site files, you can continue to use that program.  Some options are a simple text editor such as Notepad or Notepad++, a what you see is what you get editor such as Microsoft Expression Web, or to something more robust like VSCode. Any program which can edit HTML code can be used.

To set your default file editor, right-click and select Edit with…, then browse to locate your editor program. This example is using NotedPad++.

 

Once the default editor is configured, you can just select Edit to modify a file.

 

After making your changes in your chosen editor, save the file.  Bitvise will upload your modified file automatically to your staging website. You can then refresh your staging website (https://staging.prismservices.net/yourprojectname) and view your changes.

After verifying the changes, in PrismWeb Manager > Content Deployer you can deploy those changes to your production or live website.

 

Bitvise Training Video

 

 

Cyberduck Setup and Usage

In order to access and edit your PrismWeb site files, you will need to use an FTP client.  One of the recommended clients is Cyberduck.

Setup

Visit https://cyberduck.io/download/, then download the appropriate installer for your system.

Locate the download and open the installer.

 

Run the installer.

After the installer completes, locate the program on your computer and open it.

In the upper left corner choose Open Connection.

 

This will open the Open Connection dialog box.

 

Enter the following information:

First Drop Down: choose SFTP (SSH File Transfer Protocol)
Server: upload.prismservices.net
Port: This should default to 22 when you chose SFTP.  If it did not, enter 22.
Username: enter the username you were using for Filecloud. 
If you do not know your username it can be found on PrismWeb Manager (https://manager.prismservices.net) under Manger > FTP Access under the Login section FTP Username.

The FTP username may not be the same as your Web Manager username. The FTP username is always your first name initial and your last name.


Password:

Enter your Password. To get your password, select the link provided to you in your 2FA Setup email, here is an example of the password link https://onetimesecret.com/secret/8occv6hrbzltkwlainnptu503h3hu3k. After you select the link it will take you to a website that holds your encrypted password. To show your password select “View Secret”.

 

After you select “View Secret” your 25 digit password will display in a box. This password will need to be recorded and used every time the login to the SFTP client.

If you do not see “View Secret” as an option or if you've lost your password, please contact PrismRBS Support (support@prismrbs.com).


Leave all other settings at their default.

Select Connect

If an Unknown Fingerprint message displays, Select Allow, and go ahead and check the 'Always' box.

 

A Login failed error will display. Select login again.  You will need to reenter your password.

 

 

The TOTP authentication dialog box will display. Use the authenticator app you configured earlier (for example Microsoft Authenticator), and enter the six digit code you see there. Enter only the numbers, do not include any spaces.

Note: To get a TOTP authentication app, visit the app store for your mobile device, and download your product of choice. Install the app. After it opens, select to Add a New Account and scan the QR Code located on your PrismWeb Manager FTP Access screen. The app will give you a 6 digit code that you will enter in your User Authentication.

The Listing directory dialog box may display.  If so, check Always and select Continue.

 

Your site files will now display.

 

The default view will have the folders and root files listed together alphabetically. You can adjust this view so your folders are grouped together at the top.

Select View, then hover over Column. Filename, Size, and Modified are checked by default. Select Kind to check that option as well.

 

 

You will be back in your file list.  Now select Kind in the column header. This will sort the files by that column, and your folders will appear first.

 

There are some additional settings you can use to reduce the number of prompts to authenticate during your editing session.

Select Edit from the toolbar, then select Preferences. Select the Transfers icon at the top of the preference dialog box. In the Transfers section use the Transfer Files dropdown and select Use browser connection.

 

 

Use the X in the upper right corner to close the dialog box. Your changes will be saved.

Each time you open Cyberduck to access your site files, you will be required to log in and enter the current Authentication Code from your TOTP authenticator app.

Editing

To upload a file, you can simply drag the file from your local folder on your computer to the site file folder in Cyberduck. In the case of a non-product image, you would drag it from the folder on your computer to the image folder.

 

To edit a page or file used on your webpage, navigate to the file you need to modify. If you want to edit your slideshow, expand the outerweb folder and then locate slideshow.asp.

Select the file to highlight it. In the menu icons you will see and edit option, this will also display the icon for your default editor for that specific. Select the edit icon to open the file with that program, or you can select the small down arrow next to Edit to choose a different editor that is already installed on your computer.

 

A number of different programs can be used to edit your site files. If you have an editor you are already using to edit your site files, you can continue to use that program.  Some options are a simple text editor such as Notepad or Notepad++, a what you see is what you get editor such as Microsoft Expression Web, or to something more robust like VSCode. Any program which can edit HTML code can be used.

slideshow.asp open in Notepad

 

slideshow.asp open in VSCode

 

After making your changes in your chosen editor, save the file.  Cyberduck will upload your modified file automatically to your staging website. You can then refresh your staging website (https://staging.prismservices.net/yourprojectname) and view your changes.

After verifying the changes, in PrismWeb Manager > Content Deployer you can deploy those changes to your production or live website.

 

Cyberduck Training Video