Professional Documents
Culture Documents
Table of Contents
Introduction ..................................................................................................................................... 2
ASP.NET Website .................................................................................................................................... 2
SQL Server Database ............................................................................................................................... 2
Administrative Access ............................................................................................................................. 2
Prerequisites .................................................................................................................................... 2
System Requirements Overview ............................................................................................................. 2
Additional Recommendations ................................................................................................................ 3
Beginning the Installation Process .......................................................................................................... 3
Installing IIS ............................................................................................................................................. 3
.NET Framework 4.5.1............................................................................................................................. 3
Microsoft SQL Server .............................................................................................................................. 3
Secret Server Installer ....................................................................................................................... 8
Download the latest version of Secret Server ........................................................................................ 8
Running the Installer ............................................................................................................................... 8
Completing Secret Server installation from website .......................................................................... 9
Manual Installation (no setup.exe) ................................................................................................. 11
Installing as a Virtual Directory ............................................................................................................. 11
Installing as a Website .......................................................................................................................... 12
Configuring the Application Pool .......................................................................................................... 13
Appendix ........................................................................................................................................ 15
Virtual Accounts .................................................................................................................................... 15
SSL Certificate ....................................................................................................................................... 15
WCF Services ......................................................................................................................................... 15
Installing the .NET Framework 4.5.1 Manually ..................................................................................... 16
Installing IIS Manually ........................................................................................................................... 16
Page | 1
ASP.NET WEBSITE
Secret Server is installed as an ASP.NET website. The Secret Server installer will set up the website with
the correct permissions and create the settings in IIS. Once the website is set up, the installation will be
completed by a 5-step process within the application itself.
ADMINISTRATIVE ACCESS
Throughout the installation, you will be required to be an administrator to perform most of these
actions. Please ensure that you are logged on to your system with a Windows account that has
administrative rights.
Prerequisites
Important: If this is the first time you are installing Secret Server, please take the time to review the
full list of system requirements and recommendations, located HERE.
Windows 8 and 8.1 are only supported for testing environments. Microsoft does not support either of these operating
systems being used as a production server environment. Both 32- and 64-bit editions of Windows Server are supported.
Page | 2
INSTALLING IIS
IIS is an internal part of the Windows operating system. If IIS is not found, the Secret Server installer will
install it automatically. If you would prefer to install IIS manually, please refer to the instructions in the
Appendix.
Page | 3
4. After you accept the license terms, you can click Next to install product updates.
5. In the Feature Selection window, ensure that the Database Engine Services and
Management Tools Basic check boxes are selected. Click Next.
6. In the Instance Configuration window, the default setting is to use a named instance called
SQLEXPRESS. If you prefer to use the default instance or specify a custom name for the
named instance, make those changes here. Otherwise, click Next to continue with the
default settings.
Page | 4
Page | 5
4. Enter a name for your database in the Database name field, and then click OK.
Page | 6
Open SQL Server Management Studio by searching for it from the Windows Start screen.
Connect to your SQL Server Database.
Expand the Security folder.
Right-click the Logins folder and select New Login
Page | 7
6.
7.
8.
9.
Prerequisites
The installer will first check the system to determine whether there are any missing prerequisites and
will install the needed features if necessary. These prerequisites include .NET 3.5, .NET 4.5.1, and IIS.
Alternatively, you can choose to enable these features manually before running the installer.
Installation Type
Your first option during the setup will be to choose a Standard or Advanced installation:
Page | 8
File Destination
This is the location where the application files will exist. The folder is typically C:\SecretServer or
C:\inetpub\wwwroot\SecretServer (legacy), but can be customized to follow your convention.
Application Name
The application name will be used when creating the application pool and either the website or virtual
directory in IIS, depending on the option selected above.
Page | 9
Page | 10
As a virtual directory
As a website
4. Select an alias for your Secret Server. The alias is what will be appended to the website. For
instance, http://myserver/SecretServer.
5. Select the physical directory for where you unzipped Secret Server.
6. In the tree, right-click the new virtual directory and select Convert to Application.
Page | 11
10. Ensure that the Secret Server folder has the proper permissions by checking that the
account running the application pool in IIS has Modify permissions on the folder where
Secret Server is installed.
Secret Server is now ready to be installed. Go to Completing Secret Server installation from website.
INSTALLING AS A WEBSITE
1. Extract the contents of the .zip file where you would like Secret Server to be located on your
system (a common location is C:\inetpub\wwwroot).
Page | 12
Page | 13
Page | 14
Appendix
VIRTUAL ACCOUNTS
Virtual Accounts, or Managed Service Accounts, is a feature included in Windows 8 and Windows Server
2012. Windows will create a virtual account for the name of the application pool. Thus, if your application
pools name is DefaultAppPool and its identity is set to ApplicationPoolIdentity, you would assign folder
permissions to the account IIS AppPool\DefaultAppPool. This account can then optionally be used to
connect Secret Server to the SQL database by adding db_owner access to the database as a Windows
account. See Adding a SQL Server User. For more information on virtual accounts as application pool
identities, see this article by Microsoft.
SSL CERTIFICATE
What is an SSL Certificate?
An SSL (Secure Sockets Layer) Certificate greatly enhances the security between the users browser and
the server Secret Server is installed on. It encrypts all data between the server and the clients browser
so if an attacker were to look at the data being transmitted between the two, they would not be able to
decipher it.
WCF SERVICES
Starting in Secret Server version 8.9.000000, the use of Secret Server's Distributed Engine requires that
one of following two server features be installed when the Secret Server website is running on a
Windows Server 2012:
.NET Framework 4.5 Features -> WCF Services -> HTTP Activation
.NET Framework 4.5 Features -> WCF Services -> TCP Activation
Page | 15
The choice of which to install depends on which Protocol is selected in the Engine Callback Settings. If
HTTPS is selected, then the HTTP Activation feature is required. If TCP is selected, then TCP Activation is
required.
If the feature is not installed, there will be the following error message in the Engine logs: (405) Method
Not Allowed. ---> System.Net.WebException: The remote server returned an error: (405) Method Not
Allowed.
Windows 8 / 8.1
In Windows 8 and 8.1, IIS is added as a Windows feature:
Page | 16
Page | 17
7. Under Common Http Features, select the Default Document and Static Content check
boxes.
Page | 18
5. A dialog may appear asking to confirm required features. Click Add Features, and then click
Next.
Page | 19
8. Scroll down and expand Application Development, and then select the ASP.NET 4.5 check
box. A window will appear confirming the addition of required features. Click Add Features,
and then click Next.
Page | 20
9. Confirm your installation details, and then click Install. Wait for the installation to complete.
Page | 21