Rsa Authentication Manager 8.5 Setup Config Guide
Rsa Authentication Manager 8.5 Setup Config Guide
5
Setup and Configuration Guide
Revision 11
Contact Information
RSA Link at https://community.rsa.com contains a knowledgebase that answers common questions and
provides solutions to known problems, product documentation, community discussions, and case management.
Trademarks
RSA Conference Logo, RSA, and other trademarks, are trademarks of RSA Security LLC or its affiliates ("RSA").
For a list of RSA trademarks, go to https://www.rsa.com/en-us/company/rsa-trademarks. Other trademarks
are trademarks of their respective owners.
License Agreement
This software and the associated documentation are proprietary and confidential to RSA Security LLC or its
affiliates are furnished under license, and may be used and copied only in accordance with the terms of such
license and with the inclusion of the copyright notice below. This software and the documentation, and any
copies thereof, may not be provided or otherwise made available to any other person.
No title to or ownership of the software or documentation or any intellectual property rights thereto is hereby
transferred. Any unauthorized use or reproduction of this software and the documentation may be subject to
civil and/or criminal liability.
This software is subject to change without notice and should not be construed as a commitment by RSA.
Third-Party Licenses
This product may include software developed by parties other than RSA. The text of the license agreements
applicable to third-party software in this product may be viewed on the product documentation page on RSA
Link. By using this product, a user of this product agrees to be fully bound by terms of the license agreements.
This product may contain encryption technology. Many countries prohibit or restrict the use, import, or export of
encryption technologies, and current use, import, and export regulations should be followed when using,
importing or exporting this product.
Distribution
Use, copying, and distribution of any RSA Security LLC or its affiliates ("RSA") software described in this
publication requires an applicable software license.
RSA believes the information in this publication is accurate as of its publication date. The information is subject
to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS." RSA MAKES NO REPRESENTATIONS OR
WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY
DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
©
1994-2021 RSA Security LLC or its affiliates. All rights reserved.
July 2020
Revised: May 2021
RSA Authentication Manager 8.5 Setup and Configuration Guide
Contents
Revision History 9
Preface 11
About This Guide 11
RSA SecurID Access Support and Service 11
Support for RSA Authentication Manager 11
Support for the Cloud Authentication Service and Identity Routers 11
RSA Ready Partner Program 11
Planning Decisions 14
Appliance Support 14
Amazon Web Services Virtual Appliance Requirements 16
DNS Server Configuration on the Amazon Web Services Virtual Private Cloud 16
Create a DHCP Options Set 17
Associate DHCP Options with a VPC 17
Change the VPC Properties 17
Security Groups for Amazon Web Services 18
Example of a Security Group for Outbound Rules 18
Example of a Security Group for Inbound Rules 19
Azure Virtual Appliance Requirements 19
DNS Server Configuration on the Azure Virtual Network 20
Create an Azure Network Security Group 20
Azure Feature Support 21
VMware Virtual Appliance Requirements 22
VMware Software Requirements 22
VMware Software Support 23
VMware Primary or Replica Instance Hardware Requirements 23
VMware Feature Support 23
Hyper-V Virtual Appliance Requirements 24
Hyper-V Software Requirements 24
Hyper-V Primary or Replica Instance Hardware Requirements 25
Hyper-V Feature Support 25
3
RSA Authentication Manager 8.5 Setup and Configuration Guide
Supported Data Stores 26
Internal Database 26
Supported Directory Servers 26
Supported Web Browsers 27
Supported RSA Authentication Agents 27
RSA Authentication Manager License Support 28
Accurate System Date and Time Settings 29
Secure Appliance Deployment 29
IPv4 and IPv6 Network Setting Requirements 30
Deployment Checklist for the Primary and Replica Instance 31
Amazon Machine Image Deployment 31
Azure Image File Deployment 31
VMware Virtual Appliance Deployment 32
Hyper-V Virtual Appliance Deployment 32
Hardware Appliance Deployment 32
Quick Setup Checklist for the Primary Instance 33
Quick Setup Checklist for the Replica Instance 33
Setup and Configuration Information List 34
Appliance Deployment 34
Amazon Web Services Virtual Appliance 34
Azure Virtual Appliance 34
VMware or Hyper-V Virtual Appliance 35
Hardware Appliance 35
Primary Appliance Setup 35
Replica Appliance Setup 35
Load Balancer Configuration 35
Web Tier Installation 36
Perform Deployment Tasks for the Primary Instance 38
Deploy the RSA Authentication Manager Amazon Machine Image 38
Deploy the RSA Authentication Manager Azure Image File 40
Deploy the Virtual Appliance Through VMware vCenter Server 43
Deploy the Virtual Appliance Directly to the VMware ESXi Server 44
4
RSA Authentication Manager 8.5 Setup and Configuration Guide
Deploy the Virtual Appliance Through the Hyper-V Virtual Machine Manager Console 46
Deploy the Virtual Appliance Through the Hyper-V Manager 49
Deploy the Hardware Appliance 50
Run Quick Setup on the Primary Instance 52
Certificate Management for Secure Sockets Layer 54
Log On to the Consoles 55
Perform Deployment Tasks for a Replica Instance 58
Generate and Download a Replica Package File 58
Run Quick Setup on the Replica Instance 59
Attach the Replica Instance to the Primary Instance 62
Replica Attachment Issues and Solutions 63
Virtual Host and Load Balancer Overview 68
Load Balancer Requirements 68
Configure a Load Balancer and Virtual Host 68
Load Balance Using the Web Tier with Round Robin DNS 70
Web Tier Overview 72
Self-Service, Dynamic Seed Provisioning, and RBA Traffic in a Web Tier 73
Web-Tier Hardware and Operating System Requirements 74
Setting Up the Web-Tier Environment 75
Install the Web Tier 76
Add a Web-Tier Deployment Record 77
Install a Web Tier on Windows Using the Graphical User Interface 78
Install a Web Tier on Windows Using the Command Line 79
Install a Web Tier on Linux Using the Graphical User Interface 80
Install a Web Tier on Linux Using the Command Line 82
Next Steps for Your Deployment 86
Upgrading to RSA Authentication Manager 8.5 92
Before Installing RSA Authentication Manager 8.5 92
5
RSA Authentication Manager 8.5 Setup and Configuration Guide
Backup Strongly Recommended 92
Replicated Deployments 93
Additional Requirements 94
Installing Version 8.5 94
Specify a Product Update Location 94
Scan for Updates 96
Apply the Product Update 96
Reinstall the Web Tier 98
Uninstall the Web Tier 98
Uninstall a Web Tier on Linux 99
Uninstall a Web Tier on Windows 99
Run the Web-Tier Installer for Your Platform 99
Update the Web Tier 100
Reconnecting to the Cloud Authentication Service 100
Port Traffic 102
Ports for the RSA Authentication Manager Instance 102
Restricting Access to the RSA Consoles 106
Required RSA RADIUS Server Listening Ports 106
Ports on the Web Tier with a Load Balancer Deployed 107
Ports on the Web Tier Without a Load Balancer 107
Access Through Firewalls 108
Securing Connections Between the Primary and Replica Instances 108
System Administrator Accounts 112
Authentication Manager Administrator Accounts 112
Appliance Operating System Account 113
Manage a Super Admin Account 113
Appendix D: Installing the RSA Authentication Manager Token Management Snap-In 115
Overview 116
System Requirements 116
Install the Token Management Snap-In for Local Access 116
Install the Token Management Snap-In for Remote Access 117
6
RSA Authentication Manager 8.5 Setup and Configuration Guide
Performing Post-Installation Tasks 119
Start the Active Directory User and Computer Management Console 119
Configure the Connection with Authentication Manager 119
7
RSA Authentication Manager 8.5 Setup and Configuration Guide
Revision History
Revision History 9
RSA Authentication Manager 8.5 Setup and Configuration Guide
Preface
This guide is intended for network and system administrators who are responsible for installing and securing the
®
various components of an RSA Authentication Manager deployment.
For a complete list of documentation, see "RSA SecurID Access Product Documentation" on RSA Link at
https://community.rsa.com/docs/DOC-60094.
For a description of common RSA Authentication Manager terms, see the "RSA Authentication Manager
Glossary" on RSA Link at https://community.rsa.com/docs/DOC-76682.
You can access community and support information on RSA Link at https://community.rsa.com. RSA Link
contains a knowledgebase that answers common questions and provides solutions to known problems, product
documentation, community discussions, and case management.
l Access to the RSA Authentication Manager appliance.
l Your license serial number. To find this number, do one of the following:
l Look at the order confirmation e-mail that you received when your ordered the product. This e-
mail contains the license serial number.
l Log on to the Security Console, and click License Status. Click View Installed License.
l The appliance software version. This information is located in the top, right corner of the Quick Setup, or
you can log on to the Security Console and click Software Version Information.
The RSA Ready Partner Program website at www.rsaready.com provides information about third-party hardware
and software products that have been certified to work with RSA products. The website includes Implementation
Guides with step-by-step instructions and other information on how RSA products work with third-party
products.
Preface 11
RSA Authentication Manager 8.5 Setup and Configuration Guide
Chapter 1: Preparing for Deployment
Planning Decisions 14
Appliance Support 14
Amazon Web Services Virtual Appliance Requirements 16
Azure Virtual Appliance Requirements 19
VMware Virtual Appliance Requirements 22
Hyper-V Virtual Appliance Requirements 24
Supported Data Stores 26
Supported Web Browsers 27
Supported RSA Authentication Agents 27
RSA Authentication Manager License Support 28
Accurate System Date and Time Settings 29
Secure Appliance Deployment 29
IPv4 and IPv6 Network Setting Requirements 30
Deployment Checklist for the Primary and Replica Instance 31
Setup and Configuration Information List 34
Planning Decisions
Before you set up your RSA Authentication Manager deployment, you must decide which Authentication
Manager components you want to install. A deployment can include the following components:
l Primary Instance. The instance on which all administration takes place. It can also service
authentication requests.
l Replica Instance. Provides redundancy of the primary instance and authenticates users.
l Web Tiers. Allows the secure deployment of the RSA Self-Service Console, dynamic seed provisioning,
and the risk-based authentication (RBA) service within the demilitarized zone (DMZ).
l Load Balancer. Used to distribute authentication requests and to facilitate failover between the primary
and replica web tiers.
l Authentication Agents. Installed on any resource that you want to protect.
Appliance Support
RSA Authentication Manager supports an Amazon Web Services (AWS) virtual appliance, an Azure virtual
appliance, a VMware virtual appliance, a Hyper-V virtual appliance, and a hardware appliance. Each type of
appliance provides the same Authentication Manager features. You can use one type of appliance or both virtual
and hardware appliances in your deployment.
Both a virtual appliance and a hardware appliance include a Linux operating system that is installed with
Authentication Manager and RSA RADIUS server software. To configure an appliance as an Authentication
Manager instance, you must complete Quick Setup.
The following differences apply:
l AWS virtual appliance:
l Deployed on AWS or AWS GovCloud (US) with an Amazon Machine Image (AMI) file that
RSA provides.
l Requires a Virtual Private Cloud (VPC) with a private subnet on AWS.
l Supports a mixed deployment with cloud and on-premises appliances. For example, you can
deploy your Authentication Manager primary instance on your local network and your replica
instances in AWS.
l Azure virtual appliance
l Deployed on the Azure Marketplace with an Azure Image file and an RSA Authentication Manager
deployment JSON template that RSA provides.
l Requires a Virtual Network with a private subnet on Azure.
l Supports a mixed deployment with cloud and on-premises appliances. For example, you can
deploy your Authentication Manager primary instance on your local network and your replica
instances in Azure.
l VMware virtual appliance:
l The VMware virtual appliance is deployed with VMware vCenter Server or the VMware ESXi
Server (VMware Hypervisor) on a host machine that you provide. You must use a host machine
that meets the hardware requirements.
l The VMware virtual appliance supports VMware features, such as VMware snapshots.
l Hyper-V virtual appliance:
l The Hyper-V virtual appliance is deployed with the Hyper-V System Center Virtual Machine
Manager (VMM) Console or the Hyper-V Manager on a host machine that you provide. You must
use a host machine that meets the hardware requirements.
l The Hyper-V virtual appliance supports Hyper-V features, such as Hyper-V checkpoints.
l Hardware appliance:
l Before performing Quick Setup, the RSA-supplied hardware appliance is deployed by directly
accessing the hardware, and connecting a keyboard and monitor to the machine to configure the
network and keyboard language settings.
l You can use Clonezilla to create a backup image of the hardware appliance in case you need to
restore the original settings for the hardware appliance. For instructions, “Using Clonezilla to
Back Up and Restore the RSA Authentication Manager 8.4 or Later Hardware Appliance” on RSA
Link at https://community.rsa.com/docs/DOC-97375.
l If a backup image is not available, you can download and install the original hardware appliance
system image from https://my.rsa.com.
For a list of supported hardware appliance models, see the Product Version Lifecycle page on RSA Link.
All of the appliance platforms provide the following:
l Pre-installed Authentication Manager software with all of the Authentication Manager features
l Pre-installed RSA RADIUS server software
l Appliance configuration through Quick Setup, a software wizard that creates access permission and
specifies whether the appliance is a primary instance or a replica instance
l SUSE Linux Enterprise Server (SLES) 12 Service Pack 3
The following Authentication Manager packages are available at https://my.rsa.com.
You can deploy an RSA Authentication Manager 8.5 primary or replica instance on Amazon Web Services (AWS).
To do so, you must meet the following prerequisites:
l You must have already deployed a Virtual Private Cloud (VPC) on AWS.
The VPC is a virtual network dedicated to your AWS account. It is logically isolated from other virtual
networks in the AWS cloud.
l You must set up a private subnet.
A private subnet has no direct route to the Internet gateway, uses private IP addresses, and is protected
by an AWS security group.
l You must have permission to deploy m4.large or better instance types.
l Configure your DNS server. For instructions, see DNS Server Configuration on the Amazon Web Services
Virtual Private Cloud below.
l Create security groups for the AWS virtual appliance. For instructions, see Security Groups for Amazon
Web Services on page 18.
You must create a DHCP options set, associate it with the VPC, and then change the VPC properties. In a mixed
on-premises and AWS deployment, any on-premises RSA Authentication Manager primary and replica instances
need to use the DNS server that is configured in the VPC.
The default DNS server for AWS uses the IP address 169.254.169.253. If you use the default DNS server, any
subnet within the VPC can use 169.254.169.253 as the primary DNS server for Authentication Manager.
Note: AWS also includes a default Network Time Protocol (NTP) server with the IP address 169.254.169.123
that you can specify during Quick Setup.
Each VPC requires at least one DHCP options set. You can create multiple sets of DHCP options, but you can only
associate one set of DHCP options with your VPC at a time.
Procedure
1. Open the Amazon VPC console at https://console.aws.amazon.com/vpc/.
Note: This must be the same DNS server that is used to configure RSA Authentication Manager during
Quick Setup.
The new set of DHCP options appears in your list of DHCP options.
5. Record the ID for the new set of DHCP options (dopt-xxxxxxxx). The ID is required to associate the new
set of options with your VPC.
You can change the DHCP options associated with the VPC.
Procedure
1. Open the Amazon VPC console at https://console.aws.amazon.com/vpc/.
5. Click Save.
Any existing AWS instances and all new AWS instances that you launch in that VPC will use the options.
You do not need to restart or relaunch the AWS instances. The instances automatically pick up the
changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can
explicitly renew the lease in AWS. For instructions, see the AWS documentation.
You can change the VPC properties. Any on-premise RSA Authentication Manager primary and replica instances
need to use the DNS server that is configured in the VPC.
1. Open the Amazon VPC console at https://console.aws.amazon.com/vpc/.
After you finish
You must update the on-premise primary instance and replica instance hostname and IP address to the DNS
server that was used in the above configuration. For instructions, see the Help topics "Change the Primary
Instance IPv4 Network Settings" and "Change the Replica Instance IPv4 Network Settings.
Refer to the following examples to configure the security groups for the Authentication Manager instance. For
instructions on creating security groups for your Virtual Private Cloud (VPC), see the Amazon Virtual Private
Cloud User Guide at https://docs.aws.amazon.com/vpc/.
The following example of a security group for outbound rules allows all outbound traffic from the Virtual Private
Cloud (VPC).
The following example of a security group for inbound rules allows inbound traffic to access the specified ports.
All of the ports listed in Ports for the RSA Authentication Manager Instance on page 102 are enabled, including
port 22 (TCP) for SSH, port 49 (TCP) that should remain closed unless TACACS is configured, and the legacy
RADIUS Client ports 1645 (UDP) and 1646 (UDP).
You should add any feature-specific ports to your security groups. For example, if you need to support an LDAP
connection to an Oracle Directory Server instance, you must add the port 1389 (which is required for an ODS
instance) in the security group for Authentication Manager. If you need to enable the connection to the
Authentication API, then port number 5555 must be added to the security groups.
If you are using the ping command, you must enable the ICMP port in your security groups. For security
reasons, RSA does not recommend opening the ICMP port on the cloud, but if you require ping to work, the ICMP
port must be added to your security groups.
You can deploy an RSA Authentication Manager 8.5 primary or replica instance on Azure. To do so, you must
meet the following prerequisites:
l An Azure Virtual Network (VNet) is required. Do the following:
l (Existing virtual network) Note the Resource Group of the virtual network.
l (New virtual network) Do the following:
1. Deploy an Azure virtual network. The virtual network dedicated to your Azure account is
logically isolated from other virtual networks in the Azure cloud.
2. Set up a private subnet that you can use to deploy the virtual appliance. A private subnet
uses private IP addresses and is protected by an Azure Security Group.
3. Note the Resource Group of the virtual network.
For information on Azure virtual networks, https://docs.microsoft.com/en-us/azure/virtual-network/.
l Have permission to deploy S
tandard_D8s_v3 or Standard_D4s_v3 instance types.
l Collect the required network information:
l The hostname or IP address of at least one Network Time Protocol (NTP) server. Authentication
Manager requires accurate time for authentication and replication. Authentication Manager uses
a static IPv4 address. DHCP is not supported. The IPv6 protocol is not supported for the
Authentication Manager virtual appliance on Azure, because Azure requires DHCP to support the
IPv6 protocol.
l The network information for each appliance: the fully qualified domain name (FQDN), static IP
address, subnet mask, default gateway, and DNS server IP addresses.
Note: Azure virtual machines support only one NIC and one IP address for each NIC. Features
that require more than one NIC are not available on the Azure virtual machine.
l Configure your DNS server. For instructions, see DNS Server Configuration on the Azure Virtual Network
below.
l Create an Azure security group. For instructions, see Create an Azure Network Security Group below.
Procedure
1. Log on to the Azure portal.
2. On the Services tab, select Network security groups.
3. Select Add.
4. Select the resource group of your Azure virtual network.
5. Create a security group that allows inbound traffic to the following ports, except where noted:
For more information about these ports, see Port Usage on page 101.
Add any feature-specific ports to your security group. For example, an LDAP connection to an Oracle Directory
Server instance might require you to add port 1389 in the security group. If you need to enable the connection
to the Authentication API, then port number 5555 must be added to the security groups.
If you are using the ping command, you must enable the ICMP port in your security groups. RSA does not
recommend opening the ICMP port on the cloud, but this port is required for ping to work.
For instructions on how to create security groups, see https://docs.microsoft.com/en-us/azure/virtual-
network/manage-network-security-group.
Feature Support
Azure snapshots You can create an Azure snapshot for an Authentication Manager primary or replica
Feature Support
instance, but snapshots do not replace the Operations Console backup feature.
In a complex Authentication Manager deployment, restoring a virtual machine to a
snapshot requires you to perform additional tasks.
To redeploy, click Redeploy from the virtual machine that you intend to redeploy.
For more information, see the Azure documentation.
If you deploy RSA Authentication Manager 8.5 on a VMware virtual appliance, you can deploy a virtual appliance
through VMware vCenter Server or directly on the VMware ESXi platform (also known as VMware vSphere
Hypervisor 6.5 or later). VMware vCenter Server is not required to deploy the virtual appliance.
You must deploy a VMware virtual appliance with theRSA Authentication Manager Open Virtualization Appliance
(OVA) file that is located in the RSA Authentication Manager 8.5 download kit.
l VMware ESXi 6.5 (VMware vSphere Hypervisor 6.5)
VMware Platforms
l VMware ESXi 6.7 (VMware vSphere Hypervisor 6.7)
l VMware ESXi 7.0 (VMware vSphere Hypervisor 7.0)
A separate installed vSphere Client is not required.
For VMware ESXi 6.5, Patch Release ESXi650-201801001 (52236) or later is required
to deploy the virtual appliance directly on the VMware ESXi Server 6.5. You can check
VMware vSphere Client
your ESXi Embedded Host Client version by logging on to the ESXi host with SSH, and
running the following command:
For the VMware host hardware requirements, see your VMware documentation.
The virtual appliance supports the versions of VMware vCenter Server that are
compatible with the supported ESXi versions:
(Optional) VMware l VMware vCenter Server 6.5
vCenter Server l VMware vCenter Server 6.7
l VMware vCenter Server 7.0
Note: VMware vCenter Server 7.0 does not support the vSphere Web Client (Flash).
For information on Flash support in VMware vCenter Server 6.5 and 6.7, see vSphere
Web (Flash) Client Supportability and End of Life (78589).
l 100 GB of disk space for storage and 4 GB for a swap file
l 8 GB of memory
l Two virtual CPUs
Verson 8.5 increases the minimum hardware requirements to 8 GB of memory and two virtual CPUs.
The virtual appliance may require additional disk space for virtual machine operations, such as snapshots and
memory management. Use the following formula to calculate the total amount of storage required:
Total disk space = 104 GB + (GB of memory allocated to the virtual appliance x 2) + (Number of snapshots x GB
of memory allocated to the virtual appliance)
For example, a virtual appliance with 8 GB of memory and three snapshots requires about 150 GB of storage.
The calculation 104 GB + (2 x 8 GB of memory) + (3 snapshots x 8 GB of memory) indicates that 144 GB is
required, or 150 GB if you include a 6 GB buffer.
Automatic tuning on the virtual appliance supports 8 GB, 16 GB, or 32 GB of memory. For example, the
appliance uses 32 GB of memory if more than 32 GB is available.
The virtual appliance only supports the E1000 virtual network adapter. Do not change the default network
adapter.
For the VMware host hardware requirements, consult your VMware documentation.
For information on ports used by Authentication Manager, see Port Usage on page 101.
following table.
Feature Support
VMware Fault Tolerance has the following requirements:
l By default, vSphere Fault Tolerance can accommodate Symmetric
Multiprocessing (SMP) virtual machines with up to four virtual CPUs.
By default, each Authentication Manager instance is deployed with
two virtual CPUs.
VMware Fault Tolerance
You can change the number of virtual CPUs. For instructions, see the
VMware documentation.
l VMware Legacy Fault Tolerance does not support IPv6. If you use
Legacy Fault Tolerance, do not create an IPv6 network address on
an Authentication Manager primary or replica instance.
You can take a VMware snapshot of an Authentication Manager primary or
replica instance, but snapshots do not replace the Operations Console
backup feature.
When you take a snapshot of an Authentication Manager instance, specific
VMware snapshots
settings are required. In a complex Authentication Manager deployment,
restoring snapshots requires you to perform additional tasks.
If you deploy RSA Authentication Manager on a Hyper-V virtual appliance, use the Microsoft Hyper-V System
Center Virtual Machine Manager (VMM) Console or the Hyper-V Manager.
Deploy a Hyper-V virtual appliance with the RSA Authentication Manager Hyper-V virtual appliance zip file that is
available at https://my.rsa.com.
To verify that the required Hyper-V and VirtualMachineManager PowerShell modules
are available, run these two PowerShell commands:
Hyper-V Virtual Machine
Manager (VMM) Modules Get-Command -Module Hyper-V
Get-Command -Module VirtualMachineManager
The output displays a list of commands related to each module.
For more information, see your Hyper-V documentation.
If you are using Hyper-V Manager, then install both the Hyper-V role and the
Hyper-V Manager management tools. For example, if you use Server Manager to install the Hyper-V
Software role, the management tools are included by default.
For instructions, see your Hyper-V documentation.
For the Hyper-V host hardware requirements, see your Hyper-V documentation.
l 100 GB of disk space for storage and 4 GB for a swap file
l 8 GB of memory
l Two virtual CPUs
Verson 8.5 increases the minimum hardware requirements to 8 GB of memory and two virtual CPUs.
The virtual appliance may require additional disk space for virtual machine operations, such as checkpoints and
memory management. For example, you may need 150 GB in total storage, or you may need 200 GB in total
storage if you are using 16 GB of memory.
Automatic tuning on the virtual appliance supports 4 GB, 8 GB, 16 GB, or 32 GB of memory. For example, the
appliance uses 32 GB of memory if more than 32 GB is available.
The Hyper-V virtual appliance provides a virtual network adapter that uses the hv_netvsc driver. Do not use the
legacy network adapter. The legacy network adapter is not supported.
For the Hyper-V host hardware requirements, consult your Hyper-V documentation.
For information on ports used by Authentication Manager, see Port Usage on page 101.
Feature Support
Dynamic memory is not supported for the Hyper-V virtual appliance. Static memory is
Dynamic memory
supported. For more information on memory requirements, see Hyper-V Primary or
Feature Support
Replica Instance Hardware Requirements above.
You can create a Hyper-V checkpoint for an Authentication Manager primary or replica
instance, but checkpoints do not replace the Operations Console backup feature.
Hyper-V checkpoints In a complex Authentication Manager deployment, restoring a virtual machine to a
checkpoint requires you to perform additional tasks.
You can store data in:
l The RSA Authentication Manager internal database
l One or more external directory servers that use LDAP (called an identity source within Authentication
Manager).
Internal Database
RSA Authentication Manager is installed with an internal database. The following information is stored only in the
internal database:
l Data that is specific to Authentication Manager, such as token data or policies for administrative roles
and passwords.
l Data that links Authentication Manager with LDAP directory user and user group records.
Users, user groups, and identity attribute data can be stored in an external LDAP directory or in the internal
database.
l Microsoft Active Directory 2008 R2
l Microsoft Active Directory 2012
l Microsoft Active Directory 2012 R2
l Microsoft Active Directory Lightweight Directory Services 2012 R2
l Microsoft Active Directory 2016
l Microsoft Active Directory 2019
l Sun Java System Directory Server 7.0
l Oracle Directory Server Enterprise Edition 11g
l OpenLDAP 2.4.40
Note: The certificate used by the LDAPS protocol must be at least 2048 bits. For example, you must replace the
default Oracle Directory Server certificate, which is 1024 bits.
In Active Directory, you can add a Global Catalog as an identity source, which is used to look up users and
resolve group membership during authentications. You cannot use a Global Catalog identity source to perform
administrative tasks.
Note: Authentication Manager supports Active Directory Lightweight Directory Services (LDS) servers if the
same server does not also have an Active Directory Domain Controller role. If a server has an Active Directory
Domain Controller role, select that identity source type when connecting the identity source to Authentication
Manager.
Authentication Manager has read-only access to all external directory servers. However, you can configure the
system to allow users to change their passwords in LDAP during authentication.
Authentication Manager LDAP integration does not modify your existing LDAP schema, but rather creates a map
to your data that Authentication Manager uses.
Authentication Manager supports Secure Socket Layer (SSL) for LDAP connections. SSL is required if you are
allowing users to change their passwords from Authentication Manager. Non-SSL connections can expose
sensitive data as it passes over the connection. For example, if bind LDAP operations to authenticate are
performed over a non-SSL connection, the password is sent in the clear. The use of LDAP over SSL requires that
the appropriate certificate is accessible by Authentication Manager.
RSA Authentication Manager 8.5 uses a web-based interface for administration. RSA supports the latest versions
of the following web browsers for RSA Authentication Manager 8.5:
l Microsoft Internet Explorer
l Microsoft Edge
l Google Chrome
l Mozilla Firefox
l Safari
The web browser must allow Javascript and cookies. See your web browser documentation for instructions.
Note: To correctly display the web-based interface, you must have a screen resolution of 1024 X 768 or higher.
Authentication agents are software applications that securely pass user authentication requests to and receives
responses from RSA Authentication Manager. Authentication agents are installed on each machine, such as a
domain server, web server, or a personal computer, that you protect with Authentication Manager. Any resource
that is used with SecurID authentication, on-demand authentication (ODA) or risk-based authentication (RBA)
requires an authentication agent.
The agent that you need depends on the type of resource you want to protect. For example, to protect an
Apache web server, you need to download the RSA Authentication Agent for Apache. You may purchase
products that contain embedded RSA Authentication Agent software. For example, these products include all the
major brands of remote access servers and firewalls.
For a list of RSA authentication agents, go to http://www.emc.com/security/rsa-securid/rsa-securid-
authentication-agents.htm#!offerings.
For a list of third-party products that have embedded RSA agents, go to the The RSA Ready Partner Program
website at www.rsaready.com.
For more information, see the Help topic "RSA Authentication Agents."
RSA Authentication Manager is provided with the RSA SecurID Access Base Edition, Enterprise Edition, and
Premium Edition. For more information about what is included in each license, see “RSA SecurID Access
Editions” at https://community.rsa.com/docs/DOC-75836.
Authentication Manager has the following requirements:
l For RSA Authentication Manager 8.0 or later, you cannot use a version 6.1 or version 7.1 license.
l If version 8.2 Patch 3 is applied or if you have version 8.2 Service Pack 1 (SP1) or later, any version 8.0
or later license can be used.
l If you have version 8.2 Patch 2 or earlier, you cannot use a later license. Instead, you must apply a
version 8.2 license, a version 8.1 license, a version 8.0 license, or any combination of these licenses.
Authentication Manager supports stackable licenses that allow you to add users and authenticators to your
existing license. In Authentication Manager, authenticators include hardware tokens, software tokens, and the
RSA SecurID Authenticate app. When Authentication Manager users successfully authenticate with the
Authenticate Tokencode, Approve authentication, or Device Biometrics authentication, their user records are
assigned the Authenticate app as a token. The Authenticate app does not affect the license count for users who
already have an assigned authenticator in Authentication Manager. The Authenticate app increases the license
count by one for users who do not have an assigned authenticator in Authentication Manager.
Authentication Manager deployments can support additional authentication methods through the Cloud
Authentication Service. The RSA SecurID Access Base Edition, Enterprise Edition, and Premium Edition include
support for both Authentication Manager and the Cloud Authentication Service.
Each edition includes the following Authentication Manager features:
l A specific number of tokens (authenticators).
l Self-Service
l Authenticator workflow provisioning
l RADIUS
l Offline authentication
l Embedded identity router
An edition can include the following optional Authentication Manager features:
l On-demand authentication (ODA)
l Risk-based authentication (RBA)
l Business continuity
The Premium Edition includes risk-based identity confidence. This feature allows the Cloud Authentication
Service to establish high or low confidence in a user's identity based on data it collects when users attempt to
authenticate over a period of time
It is important to know:
l You can install multiple licenses.
l The Account ID must be the same for all licenses.
l The License ID (or Stack ID), must be unique for each license. You cannot install the same license twice.
l Users only count against the license limit if they have one or more assigned authenticators. Users
without authenticators do not count against the limit.
l Each assigned authenticator used to access agent-protected resources counts against the license limit.
For example, a user who authenticates with a hardware token and the Authenticate app is considered to
have two authenticators for licensing purposes.
l If High Availability Tokencode is configured, token records are created for each RSA SecurID Access user
who registered the Authenticate app with the Cloud Authentication Service. However, no additional
licenses are consumed.
l The Security Console displays warning messages when you exceed 85, 95, and 100 percent of the user
limit.
l The system updates the user counts every hour and each time that a administrator views the license
status in the Security Console.
RSA provides the license files separately from your RSA Authentication Manager download kit. Make sure that
you know the location of the license file before running the primary appliance Quick Setup. The license file must
be accessible to the browser that is used to run the primary appliance Quick Setup. Do not unzip the license file.
RSA Authentication Manager requires accurate date and time settings for replication and authentication. If the
token clock and the Authentication Manager system clock do not match, the generated tokencodes will not
match, and authentication attempts can fail. Specifying a Network Time Protocol (NTP) server for the instance
prevents replication and authentication issues that are caused by clock drift.
Note: An NTP server is required in a replicated deployment. RSA requires that all Authentication Manager
instances have their time synchronized to an NTP server.
If you do not specify an NTP server in Authentication Manager, the virtual appliance uses the date and time
provided by the physical machine hosting the virtual appliance. In this situation, the physical machine hosting
the virtual appliance should be configured to obtain accurate date and time information from an NTP server.
Make sure that you have the hostname or IP address of an NTP server before running Quick Setup.
After you deploy RSA Authentication Manager on a hardware appliance or a virtual appliance, the operating
system console screen displays a Quick Setup Access Code along with a Quick Setup URL. The Quick Setup
Access Code is only available until Quick Setup is complete.
The Quick Setup Access Code is required to begin Quick Setup, which configures the appliance as an RSA
Authentication Manager instance. This code makes it harder for a malicious user to access Quick Setup and take
control of the appliance.
Note: You must have the Quick Setup Access Code to begin Quick Setup.
RSA recommends the following guidelines when deploying an appliance:
l Deploy a hardware appliance in a test environment or in an isolated network. Only connect the appliance
to your organization’s network after Quick Setup is complete. Restrict physical and network access to the
appliance to authorized individuals.
For example, you can deploy a hardware appliance and run Quick Setup in a protected test environment
that duplicates your production environment. After Quick Setup is complete, you can move the appliance
into the production environment without changing the network settings, such as the hostname and the
IP Address.
Alternately, you can deploy the hardware appliance and run Quick Setup in a protected test environment
and later change the network settings, such as the hostname and IP address, to attach the appliance to
your production environment. For more information, see the Help topic “Primary or Replica Instance
Network Settings Updates.”
l Deploy a VMware or Hyper-V virtual appliance on an isolated network until Quick Setup is complete. Use
VMware or Hyper-V to maintain full control over the appliance. Restrict network access to the appliance,
and only allow authorized individuals to access the virtual appliance.
l Deploy the Amazon Machine Image (AMI) in a private subnet in your virtual private cloud (VPC).
A private subnet has no route to the Internet gateway. The VPC is a virtual network dedicated to your
AWS account. It is logically isolated from other virtual networks in the AWS cloud.
l Deploy the Azure appliance in a private subnet in the your Azure Virtual Network (VNet). A private
subnet uses private IP addresses and is protected by an Azure Security Group. The virtual network
dedicated to your Azure account is logically isolated from other virtual networks in the Azure cloud.
l If you access an appliance to run Quick Setup, and you discover that the appliance has already been
configured or you receive error messages because Quick Setup is in progress, then do the following:
a. Contact other administrators in your organization to ensure that a malicious user is not trying to
take control of the appliance.
b. If you believe that the appliance has been compromised, remove the primary or replica instance
from your deployment. For instructions, see the RSA Authentication Manager Administrator's
Guide.
c. Do one of the following:
l For a hardware appliance, shut down the appliance and remove the machine from
service.
l For a virtual appliance, suspend the appliance, and quarantine the machine for further
investigation.
d. Contact your IT department or RSA immediately.
IPv4 network settings are required to deploy RSA Authentication Manager. The IPv4 address that you specify for
the appliance is used to access Quick Setup. IPv6-only deployments are not supported.
If your deployment uses IPv6-compliant agents, you can add IPv6 network settings in the Operations Console
after Quick Setup is complete. For each Authentication Manager instance, you can define IPv6 addresses to
support authentication agents that use the REST protocol or the TCP protocol and IPv6 RADIUS clients.
IPv6 network settings are not supported for the following:
l Web tier. A web tier is a platform installed in the DMZ that provides services to remote users without
providing them with direct access to your private network.
l Replication. At regular intervals, the primary instance sends administration and authentication data to
each replica instance, and each replica instance sends authentication data to the primary instance.
l Trusted or cross-realm authentication. Two Authentication Manager deployments, each with a
primary instance and, optionally, one or more replica instances, can trust one another and allow users to
authenticate and access resources in the trusted deployment.
l Azure deployments. Microsoft Azure requires primary or replica instances deployed in the Azure cloud
to only use static IPv4 addresses.
l VMware Legacy Fault Tolerance feature. If you use Legacy Fault Tolerance for your VMware virtual
appliances, do not create an IPv6 network address on an Authentication Manager primary or replica
instance.
Before you set up the RSA Authentication Manager primary instance or the replica instance, you must collect the
following information. You enter this information during the appliance deployment and Quick Setup.
Microsoft Windows client computer with access to a Microsoft Windows 2012, 2012 R2, 2016
or 2019 Hyper-V host machine. Use Remote Desktop Protocol or direct access to log on to the Microsoft
Windows 2012, 2012 R2, 2016, or 2019 Hyper-V host machine. You can deploy the appliance through
either the Hyper-V Virtual Machine Manager (VMM) Console or the Hyper-V Manager.
You will also use the Microsoft Windows client computer to run Quick Setup through a supported web
browser. For a list of supported web browsers, see Supported Web Browsers on page 27.
RSA Authentication Manager virtual appliance zip file. The RSA Authentication Manager Hyper-V
virtual appliance zip file is used to deploy your virtual appliance. Copy the file to a location accessible to
Hyper-V. For VMM deployment, copy the file to an existing Hyper-V VMM library server or a shared folder
on a Microsoft Windows 2012, 2012 R2, 2016, or 2019 machine that can be added as a library server. For
Hyper-V Manager deployment, copy the file to a location on the Microsoft Windows 2012, 2012 R2, 2016,
or 2019 Hyper-V host machine.
IPv4 Network settings. Identify the fully qualified domain name and static IP address for the appliance,
the subnet mask and default gateway, and the IP address or hostname of the DNS servers in the network.
You must provide this network information when deploying the appliance. The IP address that you specify
for the appliance is used to access Quick Setup.
hostname or IP address of at least one NTP servers.
Note: An NTP server is required in a replicated deployment. RSA requires that all Authentication
Managerinstances have their time synchronized to an NTP server.
l Initial Security Console administrator User ID and password for the Super Admin role
l Operations Console administrator User ID and password
For information on managing administrator accounts and passwords, see System Administrator Accounts
on page 112.
For more information on creating a replica package, see Generate and Download a Replica Package File on
page 58.
Hostname or IP address of an NTP server. You must synchronize the time on the primary and replica
appliances using a local or Internet Network Time Protocol (NTP) server. During Quick Setup, you can
enter hostname or IP address of at least one NTP server.
Operating system password. Choose a password to access the appliance operating system for
troubleshooting and advanced administration. The password must be between 8 and 32 characters long,
and contain at least 1 alphabetic character and at least 1 special character excluding ^, @, and ~. For
example, gyz!8kMh is a valid password. Choose a unique password for each appliance. For more
information, see System Administrator Accounts on page 112.
Use the following list to specify setup and configuration information for RSA Authentication Manager. RSA
recommends that you complete this list and distribute it to the appropriate personnel for your deployment. Save
a copy of the completed list in a secure location for future reference.
Note: Some of the information that you enter in this list may be sensitive. Review your company’s policies
before entering sensitive information, such as a password, in this list.
Appliance Deployment
Note: If your deployment uses IPv6-compliant agents, you can add IPv6 network settings in the Operations
Console after Quick Setup is complete.
Hardware Appliance
Chapter 2: Deploying a Primary Appliance
Perform Deployment Tasks for the Primary Instance 38
Deploy the RSA Authentication Manager Amazon Machine Image 38
Deploy the RSA Authentication Manager Azure Image File 40
Deploy the Virtual Appliance Through VMware vCenter Server 43
Deploy the Virtual Appliance Directly to the VMware ESXi Server 44
Deploy the Virtual Appliance Through the Hyper-V Virtual Machine Manager Console 46
Deploy the Virtual Appliance Through the Hyper-V Manager 49
Deploy the Hardware Appliance 50
Run Quick Setup on the Primary Instance 52
Certificate Management for Secure Sockets Layer 54
Log On to the Consoles 55
Perform these steps to deploy an appliance and configure an RSA Authentication Manager primary instance.
Procedure
1. Deploy the appliance. Do one of the following:
l For an Amazon Web Services virtual appliance, Deploy the RSA Authentication Manager Amazon
Machine Image below.
l For an Azure virtual appliance, Deploy the RSA Authentication Manager Azure Image File on
page 40.
l For a VMware virtual appliance, you can either Deploy the Virtual Appliance Through VMware
vCenter Server on page 43 or Deploy the Virtual Appliance Directly to the VMware ESXi Server on
page 44.
l For a Hyper-V virtual appliance, you can either Deploy the Virtual Appliance Through the Hyper-V
Virtual Machine Manager Console on page 46 or Deploy the Virtual Appliance Through the Hyper-
V Manager on page 49.
l For a hardware appliance, see Deploy the Hardware Appliance on page 50.
2. Configure the appliance with Quick Setup, a software wizard that creates access permission and specifies
whether the appliance is a primary instance or a replica instance. See Run Quick Setup on the Primary
Instance on page 52.
3. Accept the internal RSA certificate authority (CA) certificate. See Certificate Management for Secure
Sockets Layer on page 54.
4. Log On to the Consoles on page 55.
Deploying the RSA Authentication Manager Amazon Machine Image (AMI) requires several minutes to complete.
Before you begin
l Meet the prerequisites in Amazon Web Services Virtual Appliance Requirements on page 16.
l Request access to the RSA Authentication Manager AMI file for your Amazon account ID. To request
access to the AMI, contact RSA Customer Support.
Note: RSA does not support the Amazon Web Services (AWS) feature for creating an AMI from an
existing Authentication Manager primary or replica instance. Each Authentication Manager instance must
be deployed form the AMI file that RSA provides.
l Manually configure network settings. DHCP is not supported.
Provide the appliance network settings for the virtual appliance:
Description Information
This is the IP address of your AWS VPC Router.
See:
Default Gateway https://docs.aws.amazon.com/vpc/latest/userguide/VPC_
Subnets.html to determine the VPC Router IP for your
subnet configuration.
This is provided in the network interface configuration
Hostname (Fully Qualified Domain Name)
details.
This is provided in the network interface configuration
IP Address
details.
Netmask This must match the netmask of the subnet.
The default DNS server in AWS, 169.254.169.253, can be
Primary DNS Server (Optional)
reached by any private subnet in the VPC.
Secondary DNS Server (Optional)
l Note: If your region does not allow you to view the AWS console Instance Screenshot, you must provide
your own Quick Setup Access Code along with the network settings. The Quick Setup Access is required
to begin Quick Setup.
The Quick Setup Access Code must contain eight of the following characters, including at least one
number: abcdefghijkmnopqrstuvwxyzACDEFGHIJKLMNPQRSTUVWXYZ0123456789. For example,
EgR7t4LR. If you do not meet these requirements,you cannot deploy the virtual appliance . Redeploy the
appliance with a valid access code.
You can record the appliance network settings in a text file, and paste it into AWS when you are creating
the virtual appliance.
Procedure
1. Log on to your AWS account.
2. On the Services tab, select EC2.
3. In Images, select AMIs.
4. Select the Private Image filter.
5. Search for the RSA Authentication Manager 8.5 AMI ID.
6. Right-click the AMI, and select Launch.
7. On the Choose an Instance Type page, select m4.large, m4.xlarge, or m4.2xlarge, and click Next:
Configure Instance Details.
8. On the Configure Instance Details page, select a Network and a Subnet from the drop-down lists.
9. Expand the Network Interfaces section, and add the Primary IP address.
10. Expand the Advanced Details section. In the User data section, enter the appliance network settings as
text. For example, you can enter or paste:
gateway : 172.24.202.129
hostname : aws-am-001.example.com
ip : 172.24.202.187
netmask : 255.255.255.128
primarydns : 169.254.169.253
secondarydns : 0.0.0.0
accesskey : EgR7tbL7
If your region does not allow you to view the AWS console Instance Screenshot, proceed to step 21.
20. Click Refresh to view the updated screenshot.
After to 10 to 15 minutes the Authentication Manager appliance boots and starts configuring network
settings. When the Authentication Manager instance is deployed, the screenshot displays the Quick
Setup URL and the Quick Setup Access Code.
21. Record the following required information:
l The Quick Setup URL, which includes the IP address that you entered in step 10.
https://<IP Address>/
Quick Setup uses an IP address. The administrative consoles that are available after Quick Setup
completes use a fully qualified domain name (FQDN).
l The Quick Setup Access Code, which is required to initiate Quick Setup. The code is automatically
generated, unless you entered it in step 7.
22. Enter the Quick Setup URL in the browser, including https, and press ENTER:
https://<IP Address>/
23. To confirm the authenticity of the virtual appliance, you must verify that the SHA-1 fingerprint of the
certificate presented during Quick Setup matches the SHA-1 fingerprint displayed in the OS Console.
Deploying the RSA Authentication Manager Azure image file requires several minutes to complete.
Before you begin
l Meet the prerequisites in Azure Virtual Appliance Requirements on page 19.
l Manually configure network settings.
Authentication Manager uses a static IPv4 address. DHCP is not supported. The IPv6 protocol is not
supported for the Authentication Manager virtual appliance on Azure, because Azure requires DHCP to
support the IPv6 protocol.
Provide the appliance network settings for the virtual appliance:
Description Information
Default Gateway
Hostname (Fully Qualified Domain Name)
IP Address
Netmask
Primary DNS Server
Secondary DNS Server (Optional)
Note: You have an option to provide your own Quick Setup Access Code along with the network
settings, or you can allow the system to generate a unique code for your virtual appliance. The Quick
Setup Access Code is required to begin Quick Setup.
The Quick Setup Access Code must contain eight of the following characters, including at least one
number: abcdefghijkmnopqrstuvwxyzACDEFGHIJKLMNPQRSTUVWXYZ0123456789. For example,
EgR7t4LR. If you do not meet these requirements, you cannot deploy the virtual appliance. Redeploy the
appliance with a valid access code.
l Resource groups are logical containers that allow you to organize your resources. Two Azure resource
groups are required:
1. The existing resource group of your Azure virtual network. You must have already created the
following components:
a. Virtual Network
b. Subnet
c. Azure Network Security Group for Authentication Manager
d. Diagnostic storage account of the Standard_LRS type.
e. An Available Private IP address in the virtual network.
2. A new, empty resource group.
Procedure
1. Log on to the Azure portal.
2. On the Services tab, select Create a resource.
3. Search for the RSA Authentication Manager 8.5 image. Click Create.
4. On the Basics blade, do the following:
1. An Administrator Username and Password details are not required for Authentication
Manager. Information that you enter in these fields is not saved. To log on to the appliance
operating system, you need the rsaadmin account and the password that you specify during
Quick Setup.
5. On the Virtual Machine Settings blade, do the following:
1. Enter a Virtual Machine name.
2. Select a virtual machine Size. RSA recommends Standard_D8s_v3 and Standard_D4s_v3
virtual machines.
3. Select a Storage Account type for the virtual machine. For information on the performance and
pricing difference between Standard_LRS, Premium_LRS, and StandardSSD_LRS, see the Azure
documentation.
4. Provide the Network Interface Name and the Network Interface Private IP Address for the virtual
machine. During deployment, a new NIC is created with this information and attached to the new
virtual machine.
6. On the Network Settings blade, select the components that you created for the existing resource group:
l Virtual Network
l Subnet
l Azure Network Security Group for Authentication Manager
l Diagnostic storage account of the Standard_LRS type
7. On the User Data blade, do the following:
1. Enter the Gateway, DNS server, Subnet Mask, and Primary DNS server.
2. A Secondary DNS server is optional. Azure requires at least one DNS server.
3. You can provide a Quick Setup Access Code, or you can allow the system to generate a unique
code for your virtual appliance.
8. On the Summary blade, review the information that you entered. You can return to any blade if changes
are required.
9. On the Buy blade, review the terms and conditions for deploying Authentication Manager in the Azure
Marketplace.
10. Click Create to deploy a new virtual machine.
After a successful deployment, you can see the new NIC, Virtual Machine disk and Virtual Machine under
the new resource group that you created earlier.
After 10 to 15 minutes, the Authentication Manager appliance boots and starts configuring network
settings. When the Authentication Manager instance is deployed, the screenshot displays the Quick
Setup URL and the Quick Setup Access Code.
13. Record the following required information:
l The Quick Setup URL, which includes the IP address that you entered in step 5.
https://<IP Address>/
Quick Setup uses an IP address. The administrative consoles that are available after Quick Setup
completes use a fully qualified domain name (FQDN).
l The Quick Setup Access Code, which is required to initiate Quick Setup. The code is automatically
generated, unless you entered it in step 7.
14. Enter the Quick Setup URL in the browser, including https, and press ENTER:
https://<IP Address>/
15. To confirm the authenticity of the virtual appliance, you must verify that the SHA-1 fingerprint of the
certificate presented during Quick Setup matches the SHA-1 fingerprint displayed in the OS Console.
You can deploy a virtual appliance through VMware vCenter Server, if you are using this administrative tool to
manage the virtual appliances. This process requires several minutes to complete.
For the VMware vCenter Server 6.5 or 6.7, you can use the vSphere Client (HTML5) or the vSphere Web Client
(Flash). For the VMware vCenter Server 7.0, use the vSphere Web Client (HTML5). The VMware vCenter Server
7.0 does not support the vSphere Web Client (Flash). For information on Flash support in VMware vCenter
Server 6.5 and 6.7, see vSphere Web (Flash) Client Supportability and End of Life (78589).
Note: Depending on your VMware vCenter configuration and the version of the VMware vSphere Client, some of
the windows that are described in the following procedure may not display. The window names may also vary.
Before you begin
l Collect the required information about each appliance instance being deployed. See Secure Appliance
Deployment on page 29.
l Copy the RSA Authentication Manager Open Virtual Appliance (OVA) file to a location that the VMware
vSphere Client can access.
Procedure
1. Use a browser to access the vCenter Server URL.
2. On the Getting Started page, click either the vSphere Client (HTML5) or the vSphere Web Client
(Flash). Note:Note: The VMware vCenter Server 7.0 only supports the vSphere Web Client (HTML5).
3. On the VMware vCenter Single Sign-On page, log on to the VMware vCenter Server.
4. Do one of the following:
l (vSphere Client with HTML5) On the Navigator pane (left hand side), right-click the VMware
Datacentre/Cluster/Host and select Deploy OVF Template… to start the deployment
wizard.
l (vSphere Web Client with Flash) On the Navigator pane, right-click on the vCenter server and
select Deploy OVF Template… to start the deployment wizard.
8. On the Review Details window, verify that “RSA Authentication Manager” and the expected version
number displays. Click Next.
9. On the Select Storage window, select an existing VMware datastore for the virtual machine files. A
VMware datastore can be a location such as a Virtual Machine File System (VMFS) volume, a directory on
Network Attached Storage, or a local file system path. Click Next.
10. On the Select Networks window, select the networks for the virtual appliance. Click Next.
11. On the Customize template window, enter the following IPv4 network settings for the virtual appliance,
and click Next:
l Fully Qualified Domain Name
l IP Address.
l Subnet Mask
l Default Gateway
l (Optional) Primary DNS Server
l (Optional) Secondary DNS Server
Note: If your deployment uses IPv6-compliant agents, you can add IPv6 network settings in the
Operations Console after Quick Setup is complete.
12. On the Ready to Complete window, review your settings, and click Finish. VMware requires
approximately five minutes to deploy the virtual appliance.
13. Power on the virtual machine.
14. Click the Launch Virtual Machine Console button.
The virtual machine console displays the progress of the virtual appliance deployment.
15. Wait 30 seconds to select the default keyboard layout, English (United States). To select a different
keyboard layout, press any key and follow the instructions on the screen.
16. Verify that the settings are correct. To accept the settings, type y, or wait 30 seconds.
17. When the virtual appliance is deployed, the OS Console displays the Quick Setup URL and the Quick
Setup Access Code. Record the following required information:
l The Quick Setup URL includes the IP address that you entered in step 12.
https://<IP Address>/
Quick Setup uses an IP address. The administrative consoles that are available after Quick Setup
completes use a fully qualified domain name (FQDN).
l The Quick Setup Access Code is required to initiate Quick Setup.
18. Enter the Quick Setup URL in the browser, including https, and press ENTER:
https://<IP Address>/
19. If you want to confirm the authenticity of the virtual appliance, you must verify that the SHA-1
fingerprint of the certificate presented during Quick Setup matches the SHA-1 fingerprint displayed in
the OS Console.
You can deploy a virtual appliance directly to the VMware ESXi server 6.5, 6.7, or 7.0 (VMware Hypervisor).
VMware vCenter is not required to deploy the virtual machine. This process requires several minutes to
complete.
Note: Depending on your configuration of the VMware ESXi server and the server version, some windows that
are described in the following procedure may not display. The window names may also vary.
Before you begin
l For VMware ESXi 6.5, Patch Release ESXi650-201801001 (52236) or later is required. You can check
your ESXi Embedded Host Client version by logging on to the ESXi host with SSH, and running the
following command:
To download the required software, go to https://my.vmware.com.
l Collect the required information about each appliance instance being deployed. See Secure Appliance
Deployment on page 29.
l Copy the RSA Authentication Manager Open Virtual Appliance (OVA) file to a location that the VMware
vSphere Client can access.
Procedure
1. In a browser, log on to the VMware ESXi server.
2. On the Navigator pane, right-click Host and select Create/Register VM to start the deployment
wizard.
3. On the Select creation type window, select Deploy a virtual machine from an OVF or OVA file. Click
Next.
4. On the Select OVF and VMDK files window, enter a Name for the virtual appliance, and locate the RSA
Authentication Manager OVA file to deploy. Click Next.
5. On the Select Storage window, select an existing VMware datastore for the virtual machine files. A
VMware datastore can be a location such as a Virtual Machine File System (VMFS) volume, a directory on
Network Attached Storage, or a local file system path. Click Next.
6. On the Deployment options window, select the networks for the virtual appliance and other options as
required. Click Next.
7. On the Additional settings window, leave all of the fields blank. Click Next.
8. On the Ready to Complete window, review your settings, and click Finish. VMware requires
approximately five minutes to deploy the virtual appliance.
9. Power on the virtual machine.
10. Click the Launch Console button.
The virtual machine console displays the progress of the virtual appliance deployment.
11. Wait 30 seconds to select the default keyboard layout, English (United States). To select a different
keyboard layout, press any key and follow the instructions on the screen.
12. When prompted, enter the following IPv4 network settings for the virtual appliance:
l Fully Qualified Hostname
l IP Address
l Subnet Mask
l Default Gateway
l (Optional) DNS Server Configuration
Note: If your deployment uses IPv6-compliant agents, you can add IPv6 network settings in the
Operations Console after Quick Setup is complete.
13. Verify that the settings are correct. To accept the settings, type y, or wait 30 seconds.
14. When the virtual appliance is deployed, the OS Console displays the Quick Setup URL and the Quick
Setup Access Code. Record the following required information:
l The Quick Setup URL includes the IP address that you entered in step 14.
https://<IP Address>/
Quick Setup uses an IP address. The administrative consoles that are available after Quick Setup
completes use a fully qualified domain name (FQDN).
l The Quick Setup Access Code is required to initiate Quick Setup.
15. Enter the Quick Setup URL in the browser, including https, and press ENTER:
https://<IP Address>/
Note: If you want to confirm the authenticity of the virtual appliance, you must verify that the SHA-1
fingerprint of the certificate presented during Quick Setup matches the SHA-1 fingerprint displayed in the OS
Console.
You can deploy a virtual appliance through the Hyper-V System Center Virtual Machine Manager (VMM) Console.
RSA provides a PowerShell script that creates a virtual machine template that automatically configures the
virtual machine. You complete configuration through the Hyper-V VMM Console. This process requires several
minutes to complete.
Before you begin
l Collect the required information about each appliance instance to deploy. See Secure Appliance
Deployment on page 29.
l Copy the RSA Authentication Manager Hyper-V virtual appliance file, rsa-am-hyper-v-virtual-
appliance-8.5.0.0.0.zip, to an existing Hyper-V VMM library server or a shared folder on a Microsoft
Windows 2012, 2012 R2, 2016, or 2019 machine that can be added as a library server.
l Unzip the file to the current location.
l The contents include a Windows batch file, a PowerShell script, and two virtual hard drive (VHD) files.
The disk1 VHD file is the primary virtual hard drive that the virtual appliance uses for storage. The disk2
VHD file is a swap drive that improves virtual appliance startup times.
Note: Do not rename the VHD files.
Procedure
1. Log on to the Microsoft Windows 2012, 2012 R2, 2016, or 2019 machine that has the Hyper-V VMM
Console installed.
2. (Optional) If the disk1 and disk2 VHD files are not located on an existing library server, add the location
of the VHD files as follows:
a. Open the Hyper-V VMM Console, and log on to the VMM server.
b. On the Home tab, click Add Library Server.
c. Select or enter the library server logon credentials, and click Next.
d. Search for the server that contains the VHD file, select the server, and click Next.
e. Select the share that contains the downloaded VHD file, and click Next.
f. Select the share that contains the downloaded VHD file, and click Next.
g. Click Add Library Servers.
4. Change directories to the location of the Windows batch file. Type the following, and press ENTER:
cd 'Windows_Directory_Path'
Where
'Windows_Directory_Path' is the location of the Windows batch file.
5. To create a Hyper-V virtual machine template, type the following, and press ENTER:
.\create_vm.bat -vmm -server FQDN_or_IP address -port port_number -libraryserver 'Windows_
Directory_Path' -templatename Template_Name
Where
l -vmm makes the batch file run in VMM mode.
l -server FQDN_or_IP address is the fully qualified domain name or IP address of the VMM server.
l -port port_number is the optional argument for the VMM server port. If you do not specify this
option, the system uses the default value 8100.
l -libraryserver 'Windows_Directory_Path' is the location of the library server managed by the
VMM where the VHD files are uploaded.
Note: Do not specify a local folder. The -libraryserver argument must specify a library server
that is a shared location configured in the VMM server.
l -templatename Template_Name is the optional argument for the name of the template. Specify a
template name if you might run the batch file more than one time. If you do not specify a name,
the system uses the default value RSA Authentication Manager Appliance VM Template.
The template name must contain 69 or fewer characters and follow Windows naming
conventions. For example, the filename cannot contain the characters \ / : * ? " < > and |.
6. If you are prompted by a security warning, type r to run the script. By default, PowerShell has a
restrictive security policy that does not trust scripts that you download from the Internet.
7. When you are prompted, enter administrative credentials for the VMM server.
After the script successfully creates the virtual machine template, you can use the Create Virtual
Machine wizard in the Hyper-V VMM Console.
8. If you have not already done so, open the Hyper-V VMM Console, and log on to the VMM server.
9. Click Library > Templates > VM Templates.
Note: If your deployment uses IPv6-compliant agents, you can add IPv6 network settings in the
Operations Console after Quick Setup is complete.
22. Verify that the settings are correct. To accept the settings, type y, or wait 30 seconds.
23. When the virtual appliance is deployed, the OS Console displays the Quick Setup URL and the Quick
Setup Access Code. Record the following required information:
l The Quick Setup URL includes the IP address that you entered in step 22.
https://<IP Address>/
Quick Setup uses an IP address. The administrative consoles that are available after Quick Setup
completes use a fully qualified domain name (FQDN).
l The Quick Setup Access Code is required to initiate Quick Setup.
24. Enter the Quick Setup URL in the browser, including https, and press ENTER:
https://<IP Address>/
Note: To confirm the authenticity of the virtual appliance, you must verify that the SHA-1 fingerprint of
the certificate presented during Quick Setup matches the SHA-1 fingerprint displayed in the OS Console.
You can deploy a virtual appliance through the Hyper-V Manager. RSA provides a PowerShell script that creates
a virtual appliance. You complete configuration through the Hyper-V Manager. This process requires several
minutes to complete.
Before you begin
l Collect the required information about each appliance instance to deploy. See Secure Appliance
Deployment on page 29.
l Verify that you have the RSA Authentication Manager virtual appliance file, rsa-am-hyper-v-virtual-
appliance-8.5.0.0.0.zip.
The file contents include a Windows batch file, a PowerShell script, and two virtual hard drive (VHD) files.
The disk1 VHD file is the primary virtual hard drive that the virtual appliance uses for storage. The disk2
VHD file is a swap drive that improves virtual appliance startup times.
After you create the virtual appliance, running the new appliance modifies the VHD files. For each virtual
appliance that you deploy with the following procedure, you must extract a new set of VHD files from the
.zip file.
Procedure
1. Log on to the Microsoft Windows 2012, 2012 R2, 2016, or 2019 Hyper-V host machine.
2. Copy the RSA Authentication Manager Hyper-V virtual appliance file, rsa-am-hyper-v-virtual-
appliance-8.5.0.0.0.zip, to a location on the Microsoft Windows 2012, 2012 R2, 2016, or 2019 Hyper-
V host machine.
3. Unzip the file to the location where you want to create the virtual appliance, but keep the original .zip
file.
For each virtual appliance that you deploy, you must extract a new set of VHD files from the .zip file.
Note: Do not rename the VHD files.
Type the following, and press ENTER:
cd 'Windows_Directory_Path'
Where
'Windows_Directory_Path' is the location of the Windows batch file.
6. To create a Hyper-V virtual machine, type the following, and press ENTER:
with the name AuthenticationMgrPrimary or type .\create_vm.bat to create a virtual appliance with the
default name RSA Authentication Manager Appliance.
7. If you are prompted by a security warning, type r to run the script. By default, PowerShell has a
restrictive security policy that does not trust scripts that you download from the Internet.
8. When prompted, type y to confirm that you want to create a new virtual machine.
After the script successfully completes, connect the virtual appliance to your network.
Note: If your deployment uses IPv6-compliant agents, you can add IPv6 network settings in the
Operations Console after Quick Setup is complete.
18. Verify that the settings are correct. To accept the settings, type y, or wait 30 seconds.
19. When the virtual appliance is deployed, the OS Console displays the Quick Setup URL and the Quick
Setup Access Code. Record the following required information:
l The Quick Setup URL includes the IP address that you entered in step 18.
https://<IP Address>/
Quick Setup uses an IP address. The administrative consoles that are available after Quick Setup
completes use a fully qualified domain name (FQDN).
l The Quick Setup Access Code is required to initiate Quick Setup.
20. Enter the Quick Setup URL in the browser, including https, and press ENTER:
https://<IP Address>/
Note: To confirm the authenticity of the virtual appliance, you must verify that the SHA-1 fingerprint of
the certificate presented during Quick Setup matches the SHA-1 fingerprint displayed in the OS Console.
Use the following procedure to deploy the hardware appliance.
Before you begin
Collect the information and items that are required for a hardware deployment. For more information, see
Secure Appliance Deployment on page 29.
Procedure
1. Connect a keyboard and monitor to the hardware appliance.
2. Connect an active ethernet link. an active ethernet link. The hardware appliance does not need to be on
the final destination network. You can connect it to any isolated switch or hub.
3. Connect the power cord to the appliance and power on the appliance.
4. When the appliance boot screen displays, select Start RSA Authentication Manager and press
ENTER, or wait 10 seconds for Authentication Manager to load automatically.
Note: Do not use the F2 or F4 function key options that display for language and keyboard settings in
the boot screen. After you start Authentication Manager, you can change the keyboard language when
you are prompted for these settings.
6. When prompted, configure the following network settings for the appliance:
l Fully Qualified Hostname
l IP Address
l Subnet Mask
l Default Gateway
l (Optional) Primary DNS Server
l (Optional) Secondary DNS Server
7. When prompted to confirm the network settings, verify the settings are correct. To accept the settings,
type y.
8. The Quick Setup URL and the Quick Setup Access Code display. Record the following required
information:
l The Quick Setup URL includes the IP address that you entered in step 6.
https://<IP Address>/
Quick Setup uses an IP address. The administrative consoles that are available after Quick Setup
completes use a fully qualified domain name (FQDN).
l The Quick Setup Access Code is required to initiate Quick Setup.
9. If you have not done so already, connect the appliance to the final destination network.
After you finish
l RSA strongly recommends doing one of the following:
l Use standard system disk imaging software to create a backup image of the hardware appliance
in case you need to restore the original settings. RSA has qualified Clonezilla software. For more
information, see Using Clonezilla to Back Up and Restore the RSA Authentication Manager 8.4 or
Later Hardware Appliance.
l Prepare to remotely restore the hardware appliance in a disaster recovery situation. Do the
following:
a. Enable remote access to the hardware appliance. For instructions, see Configuring
Remote Access to the RSA Authentication Manager Hardware Appliance.
b. Download rsa-am-hardware-appliance-8.5.0.0.0.iso from https://my.rsa.com, and
save the ISO file to a location that is accessible to the iDRAC or RMM.
In a disaster recovery situation, see the Help topic Hardware Appliance System Image
Installation.
l (Model 350 Only) The RSA SecurID Hardware Appliance 350 includes the PowerVault self-encrypting
hard drive feature that you can enable. For instructions, see Encrypt the RSA SecurID Hardware
Appliance 350 Hard Drive.
Quick Setup configures the appliance as an RSA Authentication Manager instance. Keep the appliance on a
trusted network until Quick Setup is complete. The client computer and browser used to run Quick Setup should
also be on a trusted network.
If you do not complete Quick Setup, you will be prompted to verify the network settings every time you power
on the virtual or hardware appliance. On Amazon Web Services or on Azure, do not cancel Quick Setup, or you
will be unable to access the Quick Setup URL. In that situation, you must terminate the Amazon Web Services
instance or delete the Azure virtual machine, and deploy the primary instance again.
Before you begin
l You must have deployed a virtual appliance or hardware appliance.
l Verify that the browser on the local computer can access the license file (.zip) used during Quick Setup.
For more information, see Secure Appliance Deployment on page 29.
Note: Before performing Quick Setup, verify the date and time of the appliance BIOS. If you perform
Quick Setup with an incorrect date or time, this setting can result in a failure to start Authentication
Manager or other issues. For more information, see the Knowledgebase article 000016944 at
https://rsaportal.force.com/customer/kA070000000PL8w.
Procedure
1. Launch Quick Setup. Open a web browser and go to the following URL:
https://<IP ADDRESS>
where <IP ADDRESS> is the IP address of the appliance.
2. If your web browser is configured for an enhanced security level, a warning states that this URL is not on
the list of allowed or trusted sites. To continue, click the option that allows your browser to connect to an
untrusted site. For example, your browser might ask you to click a link that reads “I Understand the
Risks.”
3. When prompted, enter the Quick Setup Access Code, and click Next.
4. Read the End User License Agreement (EULA). Click Accept.
5. On the Primary and Replica Quick Setup window, click Start Primary Quick Setup.
6. On the Primary Quick Setup page, click Start Step 1.
7. Specify the location of the license file (.zip), and click Upload.
If you select an evaluation license, 25 evaluation software tokens are created. The evaluation software
tokens are provided for use with the evaluation license.
8. Review the license summary, and click Next.
9. On the Date & Time page, do the following:
a. In the Time Zone section, do the following in this order:
l Select a region, for example, America.
l Select a location. If the time zone uses Daylight Savings Time, two offsets from
Coordinated Universal Time (UTC) are shown, for example, (UTC-05/UTC-04) New York.
To automatically synchronize the time on a hardware appliance or virtual appliance to an NTP
server:
You may enter a second NTP server.
If Quick Setup cannot connect to an NTP server, you can add an NTP Server in the
Operations Console after Quick Setup is complete.
(Amazon Web Services appliance only) Amazon Web Services (AWS) includes a default
Network Time Protocol (NTP) server with the IP address 169.254.169.123.
c. To test the connection to the NTP server and verify that the correct time is selected, click
Preview Current Date & Time.
To automatically synchronize the time on a virtual appliance to the VMware or Hyper-V host
machine:
To manually set the time on a hardware appliance:
c. Click Next.
10. On the OS Password page, create and confirm the operating system password, and click Next.
Note: The operating system password is required to log on to the primary instance.
Record the operating system password, so that you can access it when you need it. For security reasons,
RSA does not provide a utility for recovering the operating system password.
11. On the Initial Administration Accounts page, create the initial administration credentials for the Security
Console Super Admin and the Operations Console (OC) administrator. Click Next.
Note: The User ID must be unique. It can contain 1 to 255 ASCII characters. The characters @ ~ are not
allowed, and spaces are not allowed. If a User ID contains unsupported characters, the user cannot
authenticate.
Record these User IDs and passwords.
Note: After you complete Quick Setup, you can create additional Super Admin and Operations Console
administrator accounts in the Security Console.
12. Review the information that you have entered. If you want to change anything, click Back, and make the
change on the appropriate page. If necessary, use the navigation links at the top of the page.
13. Click Start Configuration.
After the instance is configured, direct links are provided to the Security Console and the Operations
Console.
After you finish
l Web browsers used to administer Authentication Manager must have JavaScript enabled. See your web
browser documentation for instructions on enabling JavaScript.
l RSA recommends enabling SSH on the Amazon Web Services (AWS) virtual appliance and the Azure
virtual appliance, because SSH is the only way to log on to the operating system for these cloud-based
appliances. Enabling SSH is optional on the VMware virtual appliance, the Hyper-V virtual appliance, and
the hardware appliance. For instructions, see the Help topic "Enable Secure Shell on the Appliance."
l (VMware only) After Quick Setup completes, you can change the appliance network settings in the
Operations Console. Network Setting changes made in the VMware vSphere Client will no longer take
effect.
l (Optional) You can download a text file that contains the network settings for the primary instance. You
can refer to this information if you need to restore the original system image on the hardware appliance.
For instructions, see the Help topic “Download Network Settings for a Primary or Replica Instance.”
l Apache components included in the Authentication Manager appliance prevent the use of nonstandard
email domains, such as .bank, .law, and .sms. Authentication Manager allows the nonstandard .local
domain. To use other nonstandard domains, you must edit the Authentication Manager ims.properties
file. For instructions, see the Help topic "Allow the Use of Nonstandard Email Domains."
Secure Sockets Layer (SSL) is enabled by default for communication ports that are used for RSA Authentication
Manager administration and replication. When you deploy an instance of Authentication Manager,
communication is secured by a long-lived SSL certificate. This certificate is unique to your deployment, and it is
signed by an internal RSA certificate authority (CA).
Because this SSL certificate is signed by an internal RSA CA, your browser may present a warning message that
the default certificate cannot be verified. If an Online Certificate Status Protocol (OCSP) client is deployed, you
may receive a message that revocation list information is not available. This is expected behavior.
To continue, click the option that allows your browser to proceed or to connect to an untrusted site. For example,
your browser might ask you to click a link that reads “I Understand the Risks.”
To prevent this warning message from appearing, you must add the internal RSA CA to your browser’s trusted
root certificate list, or replace the RSA certificate with one that is signed by a certificate authority that is trusted
by your browser.
Note: If you use dynamic seed provisioning (CT-KIP) to distribute software tokens for iOS, RSA recommends
that you use a certificate that is signed by a trusted certificate authority.
See your browser documentation for instructions about adding the internal RSA CA to your browser’s list of
trusted root certification authorities.
This procedure describes how to access the Security Console, Operations Console, and the Self-Service Console.
Procedure
1. Open a supported web browser, and enter one of the URLs listed in the following table. Each console
supports more than one URL.
Console URLs
https://<fully qualified domain name>
After installing a web tier in a deployment with a primary instance only,
enter:
Console URLs
https://<fully qualified virtual host name>:<virtual host
port>/console-selfservice
For example, if the fully qualified domain name of your appliance installation is “host.mycompany.com,”
to access the Security Console, enter one of the following URLs in your web browser:
https://host.mycompany.com
https://host.mycompany.com/sc
https://host.mycompany.com:7004/console-ims
2. If your web browser is configured for an enhanced security level, you must add an entry to the list of
allowed or trusted sites. See your browser documentation for instructions about adding allowed or
trusted sites.
3. To access the Security Console, enter the Super Admin User ID and password that you specified during
Quick Setup. To access the Operations Console, enter the Operations Console User ID and password that
were entered during Quick Setup.
For more information on the Console accounts and passwords, see Administrative Accounts on page 111.
Note: The Security Console may take up to 10 minutes to complete initial startup.
Chapter 3: Deploying a Replica Appliance
Perform Deployment Tasks for a Replica Instance 58
Generate and Download a Replica Package File 58
Run Quick Setup on the Replica Instance 59
Attach the Replica Instance to the Primary Instance 62
Perform these steps to deploy an appliance and deploy an RSA Authentication Manager replica instance.
Procedure
1. Deploy the appliance. Do one of the following:
l For an Amazon Web Services virtual appliance, Deploy the RSA Authentication Manager Amazon
Machine Image on page 38.
l For an Azure virtual appliance, Deploy the RSA Authentication Manager Azure Image File on
page 40.
l For a VMware virtual appliance, you can either Deploy the Virtual Appliance Through VMware
vCenter Server on page 43 or Deploy the Virtual Appliance Directly to the VMware ESXi Server on
page 44.
l For a Hyper-V virtual appliance, you can either Deploy the Virtual Appliance Through the Hyper-V
Virtual Machine Manager Console on page 46 or Deploy the Virtual Appliance Through the Hyper-
V Manager on page 49.
l For a hardware appliance, see Deploy the Hardware Appliance on page 50.
2. Generate and Download a Replica Package File below.
3. Configure the appliance with Quick Setup, a software wizard that creates access permission and specifies
whether the appliance is a primary instance or a replica instance. See Run Quick Setup on the Replica
Instance on the facing page.
4. Attach the Replica Instance to the Primary Instance on page 62.
Before you can add a replica instance to the deployment, you must create a replica package file on the primary
instance. This file has configuration data that enables the replica instance to connect to the primary instance.
The replica instance must have access to this file.
Before you begin
You must be an Operations Console administrator.
Procedure
1. On the primary instance, log on to the Operations Console.
local machine. The name of the replica package file is replica_package.zip.
4. Click Done to return to the Operations Console Home page.
Quick Setup performs the following tasks to add a replica appliance to the deployment:
l Quick Setup configures the appliance as an RSA Authentication Manager replica instance.
l Quick Setup attaches the replica instance to the primary instance.
After Quick Setup configures the replica instance, you can choose one of the following options:
l Attach the replica instance immediately to the primary instance.
l Defer attaching the replica instance until a later time.
If you choose to defer attaching the replica instance, Quick Setup powers off the replica instance. The next time
you power on the replica instance, you can access Quick Startup to complete the attach process.
As a best practice, RSA recommends that you keep the appliance on a trusted network until Quick Setup is
complete. The client computer and browser used to run Quick Setup should also be on a trusted network.
If you do not complete Quick Setup, you will be prompted to verify the network settings every time you power
on the virtual or hardware appliance. On Amazon Web Services or Azure, do not cancel Quick Setup or defer
replica attachment, or you will be unable to access the Quick Setup URL. In that situation, you must terminate
the Amazon Web Services instance or delete the Azure virtual machine, and deploy the replica instance again.
Before you begin
l Collect the required information about each replica instance that you want to set up. See Deployment
Checklist for the Primary and Replica Instance on page 31.
l You must have deployed the appliance:
l For an Amazon Web Services AMI appliance, see Deploy the RSA Authentication Manager
Amazon Machine Image on page 38.
l For an Azure appliance, see Deploy the RSA Authentication Manager Azure Image File on
page 40.
l For a VMware virtual appliance, see Deploy the Virtual Appliance Through VMware vCenter
Server or Deploy the Virtual Appliance Directly to the VMware ESXi Server.
l For a Hyper-V virtual appliance, you can Deploy the Virtual Appliance Through the Hyper-V
Virtual Machine Manager Console on page 46 or Deploy the Virtual Appliance Through the Hyper-
V Manager on page 49.
l For a hardware appliance, see Deploy the Hardware Appliance on page 50.
l Generate and Download a Replica Package File on the previous page.
Note: Before performing Quick Setup, verify the date and time of the appliance BIOS. If you perform
Quick Setup with an incorrect date or time, this setting can result in a failure to start Authentication
Manager or other issues. For more information, see the Knowledgebase article 000016944 at
https://rsaportal.force.com/customer/kA070000000PL8w.
Procedure
1. Launch Quick Setup. Open a browser and go to the following URL:
https://<IP ADDRESS>
2. If your web browser is configured for an enhanced security level, a warning states that this URL is not on
the list of allowed or trusted sites. To continue, click the option that your browser presents that allows
you to connect to an untrusted site. For example, your browser might ask you to click a link that reads “I
Understand the Risks.”
3. When prompted, enter the Quick Setup Access Code, and click Next.
4. Read the End User License Agreement (EULA). Click Accept.
7. On the Date & Time Settings page, do the following in this order:
l Select a region, for example, America.
l Select a location. If the time zone uses Daylight Savings Time, two offsets from
Coordinated Universal Time (UTC) are shown, for example, (UTC-05/UTC-04) New York.
To automatically synchronize the time on a hardware appliance or virtual appliance to an NTP
server:
b. Enter the hostname or IP address for a local or Internet Network Time Protocol (NTP)
server.
You may enter a second NTP server.
If Quick Setup cannot connect to an NTP server, you can add an NTP Server in the
Operations Console after Quick Setup is complete.
(Amazon Web Services appliance only) Amazon Web Services (AWS) includes a default
Network Time Protocol (NTP) server with the IP address 169.254.169.123.
c. To test the connection to the NTP server and verify that the correct time is selected, click
Preview Current Date & Time.
To automatically synchronize the time on a virtual appliance to the VMware or Hyper-V host
machine:
b. To test the connection to the virtual host and verify that the correct time is selected, click
Preview Current Date & Time.
To manually set the time on a hardware appliance:
b. From the date box, select the date.
c. From the time drop-down boxes, select the hour and minute.
c. Click Next.
8. Create and confirm the operating system password, and click Next.
Note: The operating system password is required to log on to the replica instance.
Record the operating system password for future use. For security reasons, RSA does not provide a
utility for recovering the operating system password.
9. Review the information that you have entered. If you want to change anything, click Back, and make the
change on the appropriate page. If necessary, use the navigation links at the top of the page.
After the instance is configured, do one of the following:
l Click Begin Attach to attach the replica instance to the primary instance. For instructions, see
Attach the Replica Instance to the Primary Instance on the next page.
l Click Defer Attach to attach the replica instance at another time. When prompted, confirm your
choice. The replica instance powers off. You can attach the replica instance the next time you
power on the replica instance.
Note: On Amazon Web Services or Azure, do not defer replica attachment, or you will be unable to
access the Quick Setup URL. In that situation, you must terminate the Amazon Web Services instance or
delete the Azure virtual machine, and deploy the replica instance again.
After you finish
l Replica Attachment Issues and Solutions on page 63.
l RSA recommends enabling SSH on the Amazon Web Services (AWS) virtual appliance and the Azure
virtual appliance, because SSH is the only way to log on to the operating system for these cloud-based
appliances. Enabling SSH is optional on the VMware virtual appliance, the Hyper-V virtual appliance, and
the hardware appliance. For instructions, see the Help topic "Enable Secure Shell on the Appliance."
l (Optional) You can download a text file that contains the network settings for the replica instance. You
can refer to this information if you need to restore the original system image on the hardware appliance.
For instructions, see the Help topic “Download Network Settings for a Primary or Replica Instance.”
Attaching the replica instance to the primary instance enables the replica instance to synchronize data with the
primary instance. The replica instance records all authentications locally and sends the authentication and log
data to the primary instance at regular intervals. When the primary instance is unavailable, the replica instance
holds this data locally until the primary instance becomes available.
Note: The replica instance cannot authenticate users during the attachment process.
The instances use the TCP/IP protocol over an encrypted link for secure database synchronization. Instances can
communicate over a local area network (LAN) or a wide area network (WAN).
For information on firewalls, see Port Traffic on page 102.
Before you begin
Confirm the following:
l You generated a replica package file on the primary instance and downloaded the replica package to your
local machine. For instructions, see the Help topic "Generate a Replica Package."
l The primary and replica instances can resolve and connect to each other on the following ports:
l 7002/TCP
l 7022/TCP
l 1812/TCP
l 1813/TCP
Note: Ports 1812 and 1813 are used by RSA RADIUS. If you do not plan to use RSA RADIUS, you must
still open these ports on your network, for example, on any firewalls sitting between the primary
instance and the replica instance, for attachment to succeed.
l The RSA RADIUS service is running on the primary instance.
Even if you do not plan to use RADIUS, the service must be running for the replica attachment to
succeed.
l The clocks on the primary and replica instances are synchronized. If the clocks are off by more than 10
minutes, the attachment fails.
l If you deferred attaching the replica instance after it was configured using Quick Setup, power on the
replica instance and access Quick Setup. Quick Setup resumes at the Attach to Primary Instance page.
Procedure
1. On the Attach to Primary Instance page under Upload Replica Package, click Browse, and select the
replica package file to upload from your local machine. Click Next.
After you finish
l Check the replication status by viewing the Replication Status Report for the replica instance. In the
Operations Console for the replica instance, click Deployment Configuration > Instances > Status
Report.
l If you are using RSA RADIUS, verify the replication status of the RADIUS server. In the Security Console
for the replica instance, click RADIUS > RADIUS Servers.
l Make sure that the web browsers used to access the Security Console or the Operations Console have
JavaScript enabled. See your web browser documentation for instructions on enabling JavaScript.
l After the replica instance is attached to the primary instance, network setting changes made in the
VMware vSphere Client will no longer take effect. Use the Operations Console in the primary instance to
change the network settings.
Issue Solution
The replica instance cannot resolve the In the Associated Primary IP Address field, enter the primary
primary instance hostname. instance IP address, and click Next.
In the Retry Options field, correct the primary instance IP
address. Choose one of the following options:
l Address network connectivity issues, and then try to
reach the primary instance again.
Click Next, and enter your Operations Console administrator
credentials.
1. Update the DNS server, if applicable, or use the primary
instance Operations Console to edit the hosts file with the
correct information for the replica instance.
The primary instance cannot resolve the
replica instance hostname For instructions, see the Help topic “Edit the Appliance
Hosts File.”
2. Click Next.
Verify that the RSA RADIUS service is running on the primary
The replica instance cannot communicate
instance. To do so:
with the primary instance on the RADIUS
ports. 1. Log on to the Operations Console on the primary instance.
Issue Solution
2. Select Deployment Configuration > RADIUS
Servers.
3. If prompted, enter your Super Admin user ID and
password.
4. Click the server that you want to restart.
After less than one minute, the RSA RADIUS Service
starts.
7. Verify that the network configuration permits remote
connections over ports 1812/TCP and 1813/TCP.
8. Click Next.
1. Verify that the network configuration permits remote
The primary instance cannot communicate
connections over the communication port 7002/TCP, and
with the replica instance on the
the RADIUS ports 1812/TCP and 1813/TCP.
communication port 7002/TCP, and the
RADIUS ports 1812/TCP and 1813/TCP.
2. Click Next.
You can change the time.
On the primary instance, log on to the primary instance
Operations Console and select Administration > Date & Time.
On the replica instance, redeploy the replica instance with the
correct time. To do so:
1. Delete the failed replica instance from the Operations
Console on the primary instance. For instructions, see the
Help topic “Delete a Replica Instance.”
2. Do the following:
If the time difference between the primary
instance and replica instance is greater than l For a hardware appliance, restore the original
10 minutes, replica attachment fails. backup image that you created when you first
deployed the appliance.
If a backup image is not available, you can apply
the original hardware appliance system image. For
instructions, see the RSA Authentication Manager
Administrator's Guide.
l For a VMware virtual appliance, in VMware
vCenter or on the ESXi server, shut down and
delete the virtual appliance for the failed replica
instance.
Issue Solution
l For a Hyper-V virtual appliance, in the Hyper-V
System Center Virtual Machine Manager Console
or the Hyper-V Manager, shut down and delete the
virtual appliance for the failed replica instance.
3. Deploy a new replica instance.
Chapter 4: Configuring a Virtual Host and Load Balancer
Virtual Host and Load Balancer Overview 68
Load Balancer Requirements 68
Configure a Load Balancer and Virtual Host 68
Load Balance Using the Web Tier with Round Robin DNS 70
The virtual host is the gateway to the DMZ for users outside of the network who use risk-based authentication
(RBA), the Self-Service Console, and dynamic seed provisioning. You must configure a virtual host and assign
each web tier to the virtual host.
Load balancing distributes web tier traffic to the web tier servers. The web-tier deployment can include a load
balancer or you can use round robin DNS. The virtual host can be associated with up to 2 load balancers.
For more information on network configurations that require a load balancer, see the RSA Authentication
Manager Planning Guide.
A load balancer must meet the following requirements:
l User persistence. The load balancer must send a client to the same server repeatedly during a session.
The load balancer must send the client to the same Authentication Manager instance or web-tier server,
depending on your deployment scenario, during an authentication session.
In addition to the required features, consider the following:
When adding a load balancer, you must configure a virtual hostname, IP address, and listening port. The load
balancer acts as the virtual host providing an entry point to the demilitarized zone (DMZ). You must configure
the virtual host before you can install a web tier.
If your deployment has a load balancer, the virtual hostname must resolve to the public IP address of the load
balancer.
If your deployment does not have a load balancer, the virtual hostname must resolve to the public IP address of
your web tier.
If you change the name of the load balancer or use another load balancer, you must change the virtual
hostname accordingly.
Before you begin
l You must be a Super Admin.
l The virtual hostname must be configured in the Domain Name System (DNS) to point to the load
balancer.
Procedure
1. In the Operations Console on the primary instance, click Deployment Configuration > Virtual Host
& Load Balancing.
2. If prompted, enter your Super Admin User ID and password.
3. On the Virtual Host & Load Balancing page, do the following:
b. Enter a fully qualified virtual hostname unique to the deployment.
c. (Optional) Change the default port number.
d. Provide the IP address for each of the load balancers that you intend to use. You can add up to
two load balancers.
The virtual host must be configured in the Domain Name System to point to the load balancers.
If you are not using a load balancer, leave the IP address blank.
e. Click Add.
4. Click Save.
The system saves the virtual hostname and key material in the keystore file.
6. Click Done.
After you finish
In the Operations Console, perform the appropriate mandatory next steps.
l If you updated load balancer details, you must reboot the primary and replica instances. In the
Operations Console, click Maintenance > Reboot Appliance and reboot each instance.
l If you updated the virtual hostname, generate a new integration script for each web-based application
using RBA, and then redeploy the integration scripts.
l If the deployment includes a web tier, update the web tier. In the Operations Console, click Deployment
Configuration > Web-Tier Deployments > Manage Existing. Click the update link for each web
tier.
l If the deployment includes a web tier, replace the certificate on the load balancer and on the firewall with
the virtual host certificate.
l If the deployment uses dynamic seed provisioning, update the hostname and port for the CT-KIP URL
with the hostname and port that you specified for the virtual host. In the Security Console, go to Setup
> System Settings. Click Tokens.
l If the deployment uses the RSA Self-Service Console, update the Self-Service Console URL with the
hostname and port you specified for the virtual host. In the Security Console, go to Setup > Self-
Service Settings. Click E-Mail Notifications for User Account Changes.
Load Balance Using the Web Tier with Round Robin DNS
If you do not want to use a load balancer, you can set up the web-tier servers to distribute risk-based
authentication (RBA) requests using round robin Domain Name System (DNS).
To set up load balancing using round robin DNS, associate the virtual hostname with the publicly accessible IP
addresses of the web-tier servers in your DNS, and then enable round robin. The DNS server then sends RBA
requests to web-tier servers.
The following figure shows a sample deployment of Authentication Manager using round robin DNS load
balancing.
Chapter 5: Installing Web Tiers
Web Tier Overview 72
Web-Tier Hardware and Operating System Requirements 74
Setting Up the Web-Tier Environment 75
Install the Web Tier 76
The web tier is a specialized software package included with RSA Authentication Manager, providing a secure
method to deploy the Self-Service Console, dynamic seed provisioning (CT-KIP), and risk-based authentication
(RBA) services. You can enable these three services individually to meet the needs of your deployment.
The web-tier protects the private network by receiving and managing inbound traffic from the internet. This
eliminates the need to expose Authentication Manager directly to the public network for self-service, secure
software token provisioning (CT-KIP), and risk-based authentication (RBA).
In addition to enabling services and providing network security, deploying Authentication Manager web-tier
servers in your network demilitarized zone (DMZ) offers the following benefits:
l Certificates for Self-Service Console, dynamic seed provisioning (CT-KIP), and RBA are managed in a
dedicated container.
l Provides the ability to specify the listening port for these services.
l Enables risk-based integration for web-based applications in environments licensed for this feature.
Web-tier installation requires an Authentication Manager primary instance. In production environments, it is
preferable to have at least two Authentication Manager instances located in your private network (a primary
instance and a replica instance), as well as two web-tier servers front-ended by a load balancer located in your
DMZ (one web tier for each instance). If a replica instance is promoted to the primary instance, the web-tier
servers automatically follow the promotion. An Authentication Manager realm can have up to 16 web tiers.
You need Super Admin permissions to manage Authentication Manager and the web-tier servers. Administrative
privileges are required to install the web-tier component; however, the service runs under a non-privileged
account.
Web-tiers are not required, but your deployment might need them to satisfy your network configuration and
requirements. For environments using software tokens, RSA recommends using web-tier servers to distribute
tokens through CT-KIP instead of file-based (CTF) distribution. For more information on the Authentication
Manager deployment types, see the Planning Guide.
The following diagram shows traffic flow and ports in a typical web-tier deployment.
The preferred RBA instance is the first instance to which Authentication Manager directs RBA traffic. You must
choose a preferred RBA instance when you deploy a web tier. RSA recommends that you select a different
preferred RBA instance for each web tier. You can select any Authentication Manager instance as a preferred
RBA instance.
The following diagram shows how Self-Service, dynamic seed provisioning, and RBA traffic flows through a web
tier.
If ever the preferred RBA instance is unavailable, Authentication Manager directs RBA traffic to the next instance
on the server list.
Note that if you delete a replica that is a preferred RBA instance, the associated web tier is also deleted. RBA
traffic flow through the deleted web tier is stopped. If the deployment has a load balancer and virtual host, make
sure that they no longer point to the deleted replica and associated web tier.
The following table lists the minimum requirements for the web-tier server. RSA recommends that you adjust
these requirements upwards based on expected usage.
Description Requirements
Hard Drive: 2 GB for web tier installation
Hard Drive: 4 GB-20 GB free space for logs and updated component downloads
Hardware
RAM: 4 GB
CPU: At least 2 virtual CPUs.
External Firewall: 443 HTTPS (TCP)
Ports DMZ: 443 HTTPS (TCP)
Internal Firewall: 7022 T3S (TCP)
Operating Red Hat Enterprise Linux 5 Server (64-bit)
Systems Red Hat Enterprise Linux 6 Server (64-bit)
Description Requirements
Red Hat Enterprise Linux 7.4 Server (64-bit)
Red Hat Enterprise Linux 7.6 Server (64-bit)
Red Hat Enterprise Linux 7.9 Server (64-bit)
Red Hat Enterprise Linux 8.1 Server (64-bit)
Red Hat Enterprise Linux 8.3 Server (64-bit)
Note: The System Management BIOS (SMBIOS) is required.
Windows Server 2012 (64-bit)
Windows Server 2012 R2 (64-bit)
Windows Server 2016 Standard
Windows Server 2019
Note: The Microsoft Visual C++ 2015 Redistributable package is required on Windows Server
platforms.
Before installing a web tier, perform the following tasks to set up the web-tier environment.
Procedure
1. Verify that you have Super Admin permissions, and permissions to install software.
2. Verify that you have access to the Operations Console.
3. On Linux systems, verify that the open files hard limit for the local user is at least 16384.
4. On Linux systems, if you do not plan to use the default installation directory, then you must use the
following command to set the proper permissions on your custom directory:
5. Make sure that your web-tier servers meet the recommended hardware and operating system
requirements. For more information, see Web-Tier Hardware and Operating System Requirements on
the previous page.
6. Set up the web-tier servers where you plan to install the web tier, for example, in the network DMZ.
7. Confirm that the date and time on the server where you plan to install the web tier matches the date and
time on the instance with which the web tier will be associated (primary or replica) within one minute.
The time zones do not have to be the same. For example, the web-tier server time can be 7:00 am
(GMT), and the associated instance time can be 9:00 am (GMT + 2).
8. Configure the virtual host. The virtual hostname can be a load balancer hostname or a round-robin
Domain Name System (DNS). For instructions, see Configuring a Virtual Host and Load Balancer on
page 67.
9. (Optional) On the virtual host, replace the default certificate..
10. On the load balancer and on the firewall, replace the certificate with the virtual host certificate. For
instructions, see your load balancer and firewall documentation.
11. Configure a Domain Name System (DNS) server with the Fully Qualified Hostname (FQHN) of the web
tier. The web-tier FQHN must resolve from the RSA Authentication Manager primary instance, and the
FQHN of the primary instance must resolve from the web tier.
If you cannot configure a DNS server, update the appliance hosts file with the web-tier FQHN. Click
Administration > Network > Hosts File, and follow the instructions in the Help topic Edit the
Appliance Hosts File.
RSA Authentication Manager includes web-tier installers for Windows and Linux, which are located in the RSA
Authentication Manager8.5 Extras download kit. After a web tier is installed, the Authentication Manager
Operations Console can be used to apply version updates.
Before you begin
l Obtain the RSA Authentication Manager 8.5 Extras download kit from https://my.rsa.com.
l Confirm that the virtual host and load balancer are configured.
l Know the following information:
l Directory name and location where you want the web-tier software installed
l Fully qualified hostname of the web-tier server
l Primary NIC IP address (IPv4) of the web-tier server
l Web-tier deployment package name, location, and web-tier package password
l For Linux, local user name (do not use root)
Procedure
1. On the public and private DNS servers, enter the web-tier hostname and IP address.
2. On the primary instance, add a web-tier deployment record and generate a web-tier deployment
package. For instructions, see Add a Web-Tier Deployment Record on the facing page.
3. On the web-tier server associated with the primary instance, run the RSA Authentication Web-Tier
Installer for your platform. For instructions, see the following:
l Install a Web Tier on Windows Using the Graphical User Interface on page 78.
l Install a Web Tier on Windows Using the Command Line on page 79.
l Install a Web Tier on Linux Using the Graphical User Interface on page 80.
l Install a Web Tier on Linux Using the Command Line on page 82.
4. Modify the Self-Service Console URL to point to the virtual host and virtual host port. For instructions,
see the Help topic Configure E-mail Notifications for Self-Service User Account Changes.
5. If your deployment uses dynamic seed provisioning, modify the token-key generation URL to point to the
virtual hostname, virtual host port, and self-service console. For instructions, see the Help topic
Configure Token Settings.
6. On each web-tier server, run the RSA Authentication Web-Tier Installer for your platform.
An instance can have up to 16 web tiers. Each web tier requires a web-tier deployment record.
In the last step of this procedure you can either generate the web-tier deployment package now or generate it at
a later date. The web-tier deployment package contains the information that RSA Authentication Manager uses
to connect a web tier to the associated instance. The web-tier deployment package is required prior to installing
the web tier. If you generate the web-tier package now, you can install the web tier now.
Before you begin
l You must be a Super Admin.
l If you are installing a new web-tier deployment, configure a virtual hostname, listening port, and load
balancer.For instructions, see Configure a Load Balancer and Virtual Host on page 68.
Procedure
1. On the primary instance, in the Operations Console, click Deployment Configuration > Web-Tier
Deployments > Add New.
2. If prompted, enter your Super Admin User ID and password.
3. On the Add New Web-Tier Deployment page, in the Details section, enter the following information:
l Deployment name. The name you want for the web-tier deployment (0-255 characters. The &
% > < ’ and ” characters are not allowed).
l Hostname. Fully qualified hostname of the web-tier server where you are installing the web-tier
deployment.
l Self-Service Console
l Risk-based authentication
l Dynamic seed provisioning
5. In the Virtual Host section, confirm the following information.
l Virtual Hostname. Must be the fully qualified name of the virtual host.
l Port Number. The default is 443.
6. Do one of the following:
l Click Save. The system saves the record in the database on the associated primary instance. The
trust certificate is updated when you generate a web-tier deployment package.
Note: If the web-tier hostname is not resolved, a confirmation screen displays. Follow the
instructions on the screen.
After you finish
l Confirm the details of this web-tier deployment record. For instructions, see the Help topic “View Web
Tier Deployments.”
l If you chose to save the web-tier deployment record without generating the web-tier deployment
package, generate the web-tier deployment package before installing the web tier.
l Install the web tier.
Use only numbers and English characters when specifying paths and filenames. Single-byte and double-byte
characters are not supported.
Before you begin
l Complete the steps to Install the Web Tier on page 76.
l Copy the Webtier folder from the RSA Authentication Manager 8.5 Extras download kit to the supported
Windows platform. The linux-x86_64 folder is not needed.
Procedure
1. In the location where you copied the RSA Authentication Manager 8.5 Extras download kit, go to
Webtier/windows-x86_64 and locate install_webtier.bat.
2. Do one of the following:
l If User Access Control (UAC) is on, right click install_webtier.bat and select Run As
Administrator.
l If User Access Control (UAC) is off, double-click install_webtier.bat.
3. On the Welcome screen, read the overview and navigation instructions. Click Next.
b. Type the Password.
c. Click Next.
7. On the Summary screen, do one of the following:
l If the summary is correct, click Next.
l If the summary is incorrect, click Previous, and correct the information.
After you finish
After you exit the web-tier installer, the Web-Tier Update Service connects to the primary server to install the
necessary services. Use the Operations Console to check the status of this process.
Use only numbers and English characters when specifying paths and filenames. Single-byte and double-byte
characters are not supported.
Before you begin
l Complete the steps to Install the Web Tier on page 76.
l Copy the Webtier folder from the RSA Authentication Manager 8.5 Extras download kit to the supported
Windows platform. The linux-x86_64 folder is not needed.
Procedure
1. In the location where you copied the RSA Authentication Manager 8.5 Extras download kit, go to
Webtier/windows-x86_64 and launch install_webtier.bat in console mode.
install_webtier.bat -console
a. Press ENTER to continue to the next page of the License Agreement.
On the last screen, type YES and press ENTER to accept the terms of the license agreement.
b. Type Q to quit the License Agreement.
Type YES and press ENTER to accept the terms of the license agreement.
a. Enter the web-tier package location and file name, and press ENTER.
b. Enter the web-tier package password, and press ENTER.
c. Press ENTER.
8. On the Summary screen, review the summary and do one of the following:
l If the summary is correct, type 1 to continue and press ENTER.
The installation begins and the Finish screen displays when the installation is successful.
l If the summary is incorrect, type 2 and press ENTER to quit.
The installation terminates and you must begin again.
9. On the Finish screen, press ENTER to exit.
After you finish
After you exit the web tier installer, the Web-Tier Update Service connects to the primary server to install the
necessary services. Use the Operations Console to check the status of this process.
l Use only numbers and English characters when specifying paths and filenames. Single-byte and double-
byte characters are not supported.
l The install user must have execute permission for the folder into which the web tier is installed.
l Do not save the web-tier installer and the web-tier package under the /root directory.
l Do not use spaces in the installation path.
Before you begin
l Verify that the open files hard limit for the local user is at least 16384.
l Complete the steps to Install the Web Tier on page 76.
l Copy the Webtier folder from the RSA Authentication Manager 8.5 Extras download kit to the /tmp
directory on the supported Linux platform. You can exclude the windows-x86_64 folder.
Procedure
1. Log on as root.
2. On the command line, change directories to the location where you copied the Webtier folder from the
RSA Authentication Manager 8.5 Extras download kit. Type the following and press ENTER:
cd /tmp/Webtier/linux-x86_64
3. Specify read, write, and execute access for the installation files. On the command line, do the following:
l For the install_webtier.sh file, type the following, and press ENTER:
l For the /tmp/Webtier/linux-x86_64/jdk/bin directory, type the following, and press
ENTER:
4. On the command line, type the following, and press ENTER:
./install_webtier.sh
5. On the RSA Authentication Manager Web-Tier Installer screen, click Next.
6. On the Welcome screen, read the overview and navigation instructions and click Next.
b. Type the Password.
c. Click Next.
10. On the Install User screen, enter the local user name and click Next.
11. On the Summary screen, do one of the following:
l If the summary is correct, click Next.
l If the summary is incorrect, click Previous, and correct the information.
15. Delete the Webtier folder from the /tmp directory.
After you finish
After you exit the web-tier installer, the Web-Tier Update Service connects to the primary server to install the
necessary services. Use the Operations Console to check the status of this process.
l Use only numbers and English characters when specifying paths and filenames. Single-byte and double-
byte characters are not supported.
l The install user must have execute permission for the folder into which the web tier is installed.
l Do not save the web-tier installer and the web-tier package under the /root directory.
l Do not use spaces in the installation path.
Before you begin
l Verify that the open files hard limit for the local user is at least 4096.
l Complete the steps to Install the Web Tier on page 76.
l Copy the Webtier folder from the RSA Authentication Manager 8.5 Extras download kit to the /tmp
directory on the supported Linux platform. You can exclude the windows-x86_64 folder.
Procedure
1. Log on as root.
2. On the command line, change directories to the location where you copied the Webtier folder from the
RSA Authentication Manager 8.5 Extras download kit. Type the following and press ENTER:
cd /tmp/Webtier/linux-x86_64
3. Specify read, write, and execute access for the installation files. On the command line, do the following:
l For the install_webtier.sh file, type the following, and press ENTER:
l For the /tmp/Webtier/linux-x86_64/jdk/bin directory, type the following, and press
ENTER:
./install_webtier.sh -console
l Press ENTER to continue to the next page of the License Agreement.
On the last screen, type YES and press ENTER to accept the terms of the license agreement.
l Type Q to quit the License Agreement.
Type YES and press ENTER to accept the terms of the license agreement.
a. Enter the location of the installation folder.
b. Press ENTER.
a. Enter the web-tier package location and file name, and press ENTER.
b. Enter the web-tier package password, and press ENTER.
c. Press ENTER.
a. Enter the installation user, and press ENTER.
b. Press ENTER.
11. On the Summary screen, review the summary and do one of the following:
a. If the summary is correct, type 1 to continue and press ENTER.
The installation begins and the Finish screen displays when the installation is successful.
The installation terminates and you must begin again.
12. On the Finish screen, press ENTER to exit.
13. Delete the Webtier folder from the /tmp directory.
After you finish
After you exit the web tier installer, the Web-Tier Update Service connects to the primary server to install the
necessary services. Use the Operations Console to check the status of this process.
Chapter 6: Next Steps for Your Deployment
Next Steps for Your Deployment 86
After deploying RSA Authentication Manager, you must perform the required configuration tasks. You can
perform additional configuration tasks based upon your deployment.
Protocol (LDAP) directories. Help topic "RSA Authentication
ManagerIdentity Sources."
An authentication agent is the For a list of RSA authentication
component on the protected resource agents, go to
that communicates with RSA http://www.emc.com/security/rsa-
Authentication Manager to process securid/rsa-securid-authentication-
authentication requests. Any resource agents.htm#!offerings.
Authentication Agents
that is used with SecurID For a list of third-party products
authentication, on-demand that have embedded RSA agents,
authentication (ODA) or risk-based go to the RSA Ready Partner
authentication (RBA) requires an Program web site at
authentication agent. www.rsaready.com.
RSA RADIUS Configuration
In a RADIUS-protected network,
RADIUS clients control user access at
the network perimeter.
RADIUS clients, which can be VPN
servers, wireless access points, or
Network Access Servers connected to See the Help topic "RSA RADIUS
RSA RADIUS Configuration
dial-in modems, interact with Overview."
RSA RADIUS servers for user
authentication and to establish
appropriate access control parameters.
When authentication succeeds, RADIUS
servers return a set of attributes to
Device manufactured by RSA that
generates and displays tokencodes. A
tokencode is always displayed and
changes automatically at intervals, such
as every 60 seconds. The tokencode
must be combined with the user’s PIN to
create a passcode, which enables
authentication.
Software Token
Software-based security token installed
with an associated RSA SecurID
application to a Windows desktop or
Hardware and Software laptop, a Macintosh computer, or a See the Help topic "RSA SecurID
Tokens mobile device. Tokens.”
In most cases, software tokens are
configured to request a user’s PIN. The
software token combines the PIN with
the tokencode, and then displays the
passcode, which enables
authentication.
To see if Authentication Manager
supports your current software token
version, go to the "Product Version Life
Cycle for RSA SecurID Suite" page on
RSA Link at
https://community.rsa.com/docs/DOC-
73369.
The Cloud Authentication Service To deploy the Cloud Authentication
supports a variety of secure and Service, contact your RSA Sales
convenient authentication methods, representative.
including Authenticate Tokencode,
To use multifactor authentication,
Approve, and Device Biometrics.
You can connect in two ways:
The Cloud Authentication Service helps
Cloud Authentication secure access to software as a service l If you are using identity
Service (SaaS) and on-premise web routers on other platforms
applications for users. The Cloud in your on-premises
Authentication Service can also accept network or in the Amazon
authentication requests from a third- Web Services cloud, see
party single sign-on (SSO) solution or Connect RSA Authentication
web application that has been Manager to the Cloud
configured as the identity provider (IdP) Authentication Service.
ODA delivers a one-time tokencode to a
user by e-mail or text message. You
must configure the on-demand
On-Demand Authentication tokencode delivery method. Install the See the Help topic
(ODA) authentication agent software on the “On-Demand Authentication.”
resource that you want to protect,
unless the agent is already embedded in
the protected resource.
RBA identifies potentially risky or
fraudulent authentication attempts by
silently analyzing user behavior and the
Risk-Based Authentication See the Help topic
device of origin. RBA strengthens
(RBA) “Risk-Based Authentication.”
traditional password-based
authentication RSA SecurID
authentication.
Additional Deployment Steps
You can configure RSA Authentication
Manager to enable users to perform See the Help topic “RSA Self-
Self-service configuration
maintenance and troubleshooting tasks Service Overview.”
through the Self-Service Console.
You can display a custom logon banner
before users log on to the Operations
Console, the Security Console, the Self-
Service Console, or the appliance
operating system with a Secure Shell See the Help topic "Custom Logon
Custom logon banners (SSH) client. Banners."
The logon banner is often used for legal
reasons, for example, to warn users
that only authorized personnel have
permission to access the system.
You may need to perform additional
network and product configuration for
secure operation, depending on your
network topology and on the RSA
Authentication Manager features that See the RSA Authentication
Securing Your Deployment you intend to use. ManagerSecurity Configuration
In addition, each RSA Authentication Guide.
Manager instance includes Clam
Antivirus (ClamAV) software. ClamAV is
an open-source software toolkit that is
intended to reduce the risk of intrusion
Appendix A: Upgrading to RSA Authentication Manager
8.5
Upgrading to RSA Authentication Manager 8.5 92
Before Installing RSA Authentication Manager 8.5 92
Installing Version 8.5 94
Reinstall the Web Tier 98
Reconnecting to the Cloud Authentication Service 100
You can apply the RSA Authentication Manager 8.5 upgrade patch to any hardware appliance or virtual appliance
that has RSA Authentication Manager 8.4, 8.3, or 8.2 SP1 software.
Note: From earlier versions of RSA Authentication Manager, you must upgrade to RSA Authentication Manager
8.2 SP1 or later before applying version 8.5. For instructions, see the RSA Authentication Manager 8.2 SP1
Setup and Configuration Guide.
RSA Authentication Manager 8.5 includes the software fixes in the cumulative Patch 13 for version 8.4. Applying
version 8.5 removes any software fixes that are not included in the cumulative Patch 13 for version 8.4. To
obtain the software fixes in later version 8.4 patches, you must apply version 8.5 patches as they become
available.
To apply version 8.5, perform these tasks in order:
1. Review the prerequisites. See Before Installing RSA Authentication Manager 8.5 below.
2. Follow the standard steps to apply an Authentication Manager update from a Windows shared folder, an
NFS share, or a DVD or CD. See Installing Version 8.5 on page 94.
Note: Applying the version 8.5 upgrade through your local web browser is not supported.
3. If your deployment includes a web tier, you reinstall it. See Reinstall the Web Tier on page 98.
4. To use some version 8.5 features, such as the embedded identity router and High Availability Tokencode
when the connection to the Cloud Authentication Service is not available, an Authentication Manager
deployment that is already connected to the Cloud Authentication Service must connect again after
upgrading to version 8.5. See Reconnecting to the Cloud Authentication Service on page 100.
Note: The current RSA Authentication Manager 8.5 upgrade kit prevents an internal replication error that
sometimes occurred immediately after upgrading. For more information, see the RSA Authentication Manager
8.5 Known Issues.
Before installing this upgrade, review the following guidelines and requirements.
Note: RSA strongly recommends backing up your deployment, backing up a hardware appliance with
Clonezilla, taking an AWS snapshot, taking an Azure Snapshot or Backup, taking a VMware snapshot, or creating
a Hyper-V checkpoint before applying version 8.5.
l If you deployed a hardware appliance or a virtual appliance, you can back up the version 8.2 SP1, 8.3,
8.4, or 8.5 database. Use the Back Up Now feature in the Operations Console of the primary instance.
See the Help topic Create a Backup Using Back Up Now.
l If you deployed a hardware appliance, RSA recommends using standard system disk imaging software to
create a backup image in case you need to restore the hardware appliance.
RSA has qualified Clonezilla software for version 8.4 or later. For instructions, see Using Clonezlla to Back
Up and Restore the RSA Authentication Manager 8.4 or Later Hardware Appliance.
For version 8.2 SP1 or 8.3, you can use PING to create a backup image of the hardware appliance in case
you need to restore the original settings for the hardware appliance. For instructions, see Using PING to
Back Up and Restore the RSA Authentication Manager 8.2.x Hardware Appliance.
l If you deployed an Azure virtual appliance, you can take a snapshot of each virtual machine in the
version 8.4 deployment or create an Azure Backup for the RSA Authentication Manager primary instance
and each replica instance. For additional instructions, see "Primary or Replica Instance Azure Snapshots"
and "Primary or Replica Instance Azure Backups" in the RSA Authentication ManagerAdministrator's
Guide.
l If you deployed an Amazon Web Services virtual appliance, you can take a snapshot of each virtual
machine in the version 8.3 or 8.4 deployment. For additional instructions, see "Primary or Replica
Instance Amazon Web Services Snapshots" in the RSA Authentication ManagerAdministrator's Guide.
l If you deployed a VMware virtual appliance, you can take a snapshot of each virtual machine in the
version 8.2 SP1, 8.3, or 8.4 deployment. When you take a snapshot of an Authentication Manager
instance, you must specify the following settings:
l Do not save the virtual machine’s memory.
l Choose to quiesce the guest file system. This option pauses running processes on the
Authentication Manager instance.
For additional instructions, see the VMware vSphere Client documentation.
l If you deployed a Hyper-V virtual appliance, you can create a checkpoint of the version 8.2 SP1, 8.3, or
8.4 deployment. For additional instructions, see the Microsoft Hyper-V documentation.
You can restore your previous version of Authentication Manager if you took an AWS snapshot, a VMware
snapshot, or a Hyper-V checkpoint before applying version 8.5. Export your data or take other steps to preserve
your data before reverting to a snapshot or checkpoint. See the RSA Authentication Manager Administrator's
Guide for information about restoring snapshots and checkpoints.
You can restore your previous version of Authentication Manager if you backed up your deployment before
applying version 8.5. For restoring from an Authentication Manager backup, see the Help topic Restore from
Backup.
Replicated Deployments
If you have a replicated deployment, all replica instances must be running and replicating successfully before
you apply version 8.5 or any other update or patch to the primary instance. To verify the replication status, log
on to the primary instance Operations Console, and then click Deployment Configuration > Instances >
Status Report.
Apply version 8.5 to the RSA Authentication Manager primary instance before upgrading the replica instances in
your RSA Authentication Manager 8.4, 8.3, or 8.2 SP1 deployment. On the primary instance, the replication
status may display “Internal Replication Error” or another error until all replica instances have been upgraded or
patched. The RADIUS server replication status also displays a replication status of "package failure" or another
error until all replica instances have been upgraded or patched.
Note: You must successfully upgrade your primary instance before upgrading your replica instances.
Additional Requirements
Version 8.5 has the following additional requirements:
l Each virtual appliance must have at least 6 GB of free disk space to apply version 8.5.
l For version 8.5, the VMware virtual machine and the Hyper-V virtual machine require hardware that
meets or exceeds the following minimum requirements:
l 8 GB of memory
l At least two virtual CPUs
l The minimum hardware requirements for the web-tier server were increased in version 8.4:
l 2 GB for web tier installation and 4 GB to 20 GB free space for logs and updated component
downloads.
l 4 GB of memory
l At least two virtual CPUs
l The following credentials are required for the upgrade:
l Operating system password for the rsaadmin user account on each virtual appliance.
l An Operations Console administrator account, with access to the Operations Console, for the
primary instance and each replica instance.
l You can apply the version 8.5 update from a Windows shared folder, an NFS share, or a DVD or CD.
The RSA Authentication Manager 8.5 ZIP file, rsa-am-update-8.5.0.0.0.zip, contains the RSA Authentication
Manager 8.5 ISO file, am-update-8.5.0.0.0.iso, that is used to apply version 8.5 to Authentication Manager.
You can apply the version 8.5 update from a Windows shared folder, an NFS share, or a DVD or CD.
Note: Applying the version 8.5 upgrade through your local web browser is not supported.
The overall steps to install this service pack are as follows:
l Specify a Product Update Location below
l Scan for Updates on page 96
l Apply the Product Update on page 96
You can apply the version 8.5 update from a Windows shared folder, an NFS share, or a DVD or CD. Applying the
version 8.5 upgrade through your local web browser is not supported.
If you have already specified a location, see Scan for Updates.
Before you begin
l Download the version 8.5 update from RSA Link to a location that the primary or replica instance can
access.
l If you intend to scan for updates on an RSA-supplied DVD or CD, do the following:
l On a hardware appliance, use the DVD/CD drive or mount an ISO image.
l On a virtual appliance, you must configure the virtual appliance to mount a DVD/CD or an ISO
image. See the Help topic “VMWare DVD/CD or ISO Image Mounting Guidelines” or “Hyper-V
DVD/CD or ISO Image Mounting Guidelines.”
Procedure
1. In the Operations Console, click Maintenance > Update & Rollback.
2. On the Update & Rollback page, your local browser is configured as the method for applying an update.
To change that setting, click Configure Update Source.
3. On the Configure Update Sources page, specify a location for updates.
l (Optional) In the Windows Username field, enter a username. If your Windows share
configuration requires it, enter the domain and username.
l (Optional) In the Windows Password field, enter a password only if it is required by your
Windows share configuration.
5. Click Save.
After you finish
Scan for Updates.
Procedure
1. In the Operations Console, click Maintenance > Update & Rollback.
The Available Updates section displays a list of updates, with the following information for each
update:
l Version. The version of the update. To see the current Authentication Manager version, see the
top of the Update and Rollback page.
l Reversible. Indicates whether you can roll back (undo) the update. Service pack 1 is not
reversible.
l Action. States whether the update is available to apply. Lists the minimum system requirement
for the update.
The Applied Updates section displays the updates applied to the instance. This section includes the
update version numbers, the time and date that each update was applied, and which administrator
applied the update.
After you scan for updates, the new list displays for 24 hours. Logging out of the Operations Console
does not remove the list from the system cache. If you restart the Operations Console, download
additional updates, or change the product update locations, you must perform another scan to see the
most current list.
After you finish
Apply the version 8.5 upgrade to the RSA Authentication Manager deployment. See Apply the Product Update.
Note: You must successfully upgrade your primary instance before upgrading your replica instances.
Before you begin
l Ensure that port 8443/TCP is open for https traffic.
Access to this port is required for real-time status messages when applying RSA Authentication Manager
patches and service packs.
During a product update, the appliance opens this port in its internal firewall. The appliance closes this
port when the update is complete.
If an external firewall blocks this port, the browser displays an inaccessible or blank web page, but the
update can successfully complete.
l Specify a Product Update Location on page 94
You can apply the version 8.5 update from a Windows shared folder, an NFS share, or a DVD or CD.
Applying the version 8.5 upgrade through your local web browser is not supported.
l After you configure an NFS share, a Windows shared directory, or a DVD/CD as an update location, Scan
for Updates on the previous page.
l In a replicated deployment, all replica instances must be running and replicating successfully before you
apply version 8.5 or any other update or patch to the primary instance. To verify the replication status,
log on to the primary instance Operations Console, and then click Deployment Configuration >
Instances > Status Report.
After upgrading the primary instance, the Authentication Manager replication status may display
“Internal Replication Error” or another error until all replica instances have been upgraded or patched.
The RADIUS server replication status also displays a replication status of "package failure" or another
error until all replica instances have been upgraded or patched.
Procedure
1. In the Operations Console, click Maintenance > Update & Rollback.
2. Do the following:
4. The basic status messages appear while the update is applied. You can view more detailed information
on the Advanced Status View tab.
Note: If the browser displays an inaccessible or blank web page, then port 8443/TCP might be blocked
by an external firewall. Real-time status messages are not available. Wait for the update to complete.
5. After the Authentication Manager upgrade is applied, the appliance automatically restarts, and the
appliance operating system is upgraded. The required time is based upon your system configuration.
Note: Do not attempt to restart the appliance manually.
When the restart is complete, click Done.
After Authentication Manager and the appliance operating system are upgraded, the following occurs:
l Authentication Manager moves the update from the Available Updates section to the Applied
Updates section.
l The software version information is updated. To view the software version information, log on to the
Security Console, and click Software Version Information.
After you finish
l You can download a detailed log file containing the information that was displayed on the Advanced
Status View tab. The file is named update-version-timestamp.log, where version is the update
version number and timestamp is the time that the update completed. For instructions, see the Help
topic Download Troubleshooting Files.
l After you have upgraded the primary instance and all of the replica instances, do the following:
l Verify that replication and radius replication is functioning correctly on the primary instance and
the replica instance.
l Version 8.5 includes the software fixes in the cumulative Patch 13 for version 8.4. As needed,
obtain later software fixes by applying the latest version 8.5 cumulative patches to the upgraded
Authentication Manager instances.
l If the deployment includes a web tier, you must reinstall it. For instructions, see Reinstall the Web Tier
below.
l To use some version 8.5 features, such as the embedded identity router and High Availability Tokencode
when the connection to the Cloud Authentication Service is not available, an Authentication Manager
deployment that is already connected to the Cloud Authentication Service must connect again after
upgrading to version 8.5. See Reconnecting to the Cloud Authentication Service on page 100.
If your deployment includes a web tier, after upgrading the primary and replica instances, you must upgrade the
web tier. Follow these procedures to retain all existing web-tier configuration and customization settings:
1. Uninstall the Web Tier below
2. Run the Web-Tier Installer for Your Platform on the facing page
3. Update the Web Tier on page 100
For instructions, see the following:
Uninstall a Web Tier on Linux on the facing page
Uninstall a Web Tier on Windows on the facing page
Before you begin
l Confirm that you have root privileges.
l Verify that the open files hard limit for the local user is at least 4096.
Procedure
1. Log on to the web-tier server.
2. Change directories to your-authentication-manager-web-tier-installation/uninstall.
3. On the command line, type:
./uninstall.sh
4. Press ENTER.
5. On the Welcome screen, type:
yes
6. Press ENTER.
The system uninstalls the web tier and displays “Uninstall Complete” when finished.
Before you begin
Confirm that you have Windows credentials to uninstall a program.
Procedure
1. On the web-tier server, go to Start > Control Panel > Programs and Features > Uninstall a
Program.
3. On the command line, type:
and press ENTER.
When finished, the uninstaller screen displays Uninstall finished.
4. Press ENTER.
The system removes the web-tier services and installation folders, except the top-level folder.
web-tier server, run the RSA Authentication Manager Web-Tier Installer for your platform. For instructions, see
the following:
l Install a Web Tier on Windows Using the Graphical User Interface on page 78.
l Install a Web Tier on Windows Using the Command Line on page 79.
l Install a Web Tier on Linux Using the Graphical User Interface on page 80.
l Install a Web Tier on Linux Using the Command Line on page 82.
Procedure
1. In the Operations Console, click Deployment Configuration > Web-Tier Deployments > Manage
Existing.
When the update is complete, the Status column for the updated web tier displays Online.
After you finish
To use some version 8.5 features, such as the embedded identity router and High Availability Tokencode when
the connection to the Cloud Authentication Service is not available, an Authentication Manager deployment that
is already connected to the Cloud Authentication Service must connect again after upgrading to version 8.5. For
instructions, see Reconnecting to the Cloud Authentication Service below.
To use some version 8.5 features, such as the embedded identity router and High Availability Tokencode when
the connection to the Cloud Authentication Service is not available, you must connect a new or upgraded RSA
Authentication Manager 8.5 deployment to the Cloud Authentication Service.
Note: An Authentication Manager deployment that is already connected to the Cloud Authentication Service
must connect again after upgrading to version 8.5.
For more information on version 8.5 features, see the RSA SecurID Access Release Notes for RSA Authentication
Manager 8.5.
For instructions on how to establish the connection, see the following:
l If you are using identity routers on other platforms in your on-premises network or in the Amazon Web
Services cloud, see Connect RSA Authentication Manager to the Cloud Authentication Service
l To connect with an embedded identity router, see Configure an Embedded Identity Router.
Appendix B: Port Usage
Port Traffic 102
Ports for the RSA Authentication Manager Instance 102
Ports on the Web Tier with a Load Balancer Deployed 107
Ports on the Web Tier Without a Load Balancer 107
Access Through Firewalls 108
Port Traffic
The following figure represents a common RSA Authentication Manager deployment with primary and replica
instances, web tiers, and a load balancer. An external firewall protects the primary and replica instances, and
another external firewall protects the DMZ. For more information on RADIUS ports, see Ports for the RSA
Authentication Manager Instance below.
The RSA Authentication Manager instance has an internal firewall that limits traffic to specific ports. The internal
firewall restricts inbound traffic to the hosts and services that provide product functionality. Outbound traffic is
not restricted. RSA recommends that you deploy the instance in a subnet that also has an external firewall to
segregate it from the rest of the network.
The following table lists ports used by the Authentication Manager instance. Note the following:
l These ports are configured to be able to accept network traffic from remote systems. You should
configure these ports for access on your local network.
l Authentication Manager uses other, internal network connections for communication between processes.
Remote access to these ports is blocked by the internal firewall configured on the appliance.
l When blocking external access to ports on web-tier servers, do not block connections and traffic from
services on the same system. For example, you can use a firewall to block external access to ports 7030,
TCP, and 7036, TCP, but you must allow connections on the external NIC if the connections are from the
same web-tier server.
l All ports support IPv4 only, unless IPv6 support is specified in the description.
Port Number
Function Source Description
and Protocol
Disabled by default. SSH can be enabled
Secure Shell in the Operations Console. SSH allows
22, TCP SSH client
(SSH) the operating system account (rsaadmin)
to access the operating system.
This port is closed unless TACACS is
TACACS configured. Used to receive
49, TCP TACACS client
authentication authentication requests from a Network
Access Device (NAD).
Quick Setup
Used for Quick Setup. After Quick Setup
Operations is complete, the appliance redirects
80, TCP Console, Administrator’s browser
connections from this port to the
Security appropriate console.
Console
Used by the Authentication Manager
SNMP agent to listen for GET requests
and send responses to a Network
161, UDP SNMP SNMP client Management System (NMS).
This port is closed, unless SNMP is
enabled. It can be configured in the
Security Console.
Quick Setup
Operations Used for Quick Setup. After Quick Setup
Console, is complete, the appliance redirects
443, TCP Security Administrator’s browser
connections from this port to the
Console, Self- appropriate console.
Service
Console
This port receives authentication
RADIUS requests from a RADIUS client.
1645, UDP authentication RADIUS client For more information, see Required RSA
(legacy port) RADIUS Server Listening Ports on
page 106.
This port receives inbound accounting
RADIUS requests from a RADIUS client.
1646, UDP accounting RADIUS client For more information, see Required RSA
(legacy port) RADIUS Server Listening Ports on
page 106.
This port is used for communication
between primary RADIUS and replica
RADIUS
RADIUS services.
1812, TCP replication Another RADIUS server
port If you do not use RSA RADIUS, but you
have replica instances, you must allow
Port Number
Function Source Description
and Protocol
connections between Authentication
Manager instances on this port. You
should restrict connections from other
systems that are not Authentication
Manager instances. For more
information, see Required RSA RADIUS
Server Listening Ports on page 106.
This port receives authentication
RADIUS requests from a RADIUS client.
1812, UDP RADIUS client
authentication If you do not plan to use RSA RADIUS
authentication, you can close this port.
This port is used to administer RADIUS
from the Security Console over the
protected RADIUS remote administration
channel.
If you do not use RSA RADIUS, but you
RADIUS have replica instances, you must allow
1813, TCP RADIUS server connections between Authentication
administration
Manager instances on this port. You
should restrict connections from other
systems that are not Authentication
Manager instances. For more
information, see Required RSA RADIUS
Server Listening Ports on page 106.
This port receives accounting requests
RADIUS from a RADIUS client.
1813, UDP RADIUS client
accounting If you do not plan to use RSA RADIUS
authentication, you can close this port.
Accepts requests from TCP-based
authentication agents and sends replies.
Agent RSA SecurID Authentication Required for RSA SecurID and on-
5500, TCP
authentication protocol agents demand authentication (ODA). This port
supports both IPv4- and IPv6-compliant
agents.
Accepts requests from UDP-based
authentication agents and sends replies.
Agent RSA SecurID Authentication
5500, UDP Required for RSA SecurID, ODA and risk-
authentication protocol agents
based authentication (RBA). This port
only supports IPv4-compliant agents.
Used for communication with
Agent auto- authentication agents that are
5550, TCP RSA agents
registration attempting to register with
Authentication Manager.
Port Number
Function Source Description
and Protocol
Accepts requests from REST-based
authentication agents and sends replies.
Agent RSA SecurID Authentication Required for RSA SecurID and on-
5555, TCP
authentication API agents demand authentication (ODA). This port
supports both IPv4- and IPv6-compliant
agents.
Used to receive requests for additional
offline authentication data, and send the
offline data to agents. Also used to
Offline update server lists on agents.
5580, TCP authentication RSA agents
service This can be closed if offline
authentications are not in use and no
agents in your deployment use the Login
Password Integration API.
Used for communication between an
Authentication Manager primary and
replica instances and for communication
between replica instances (for replay
7002, TCP Authentication detection).
Another appliance
SSL-encrypted Manager Used by the RSA application
programming interface (API).
Enable if you have at least one replica
instance.
RSA Token
Management Enable this port if you plan to use the
7002, TCP snap-in for the Microsoft Management RSA Token Management snap-In to
SSL-encrypted Microsoft Console manage users and authenticators from
Management MMC.
Console (MMC)
Required for administering your
7004, TCP Security deployment from the Security Console.
Administrator’s browser
SSL-encrypted Console Accepts requests for Security Console
functions.
Required for using the Self-Service
7004, TCP Self-Service
Console or RBA. Accepts requests for
Console and User’s browser
SSL-encrypted RBA Self-Service Console functions and RBA
authentication.
Cryptographic
7004, TCP Token-Key
Required for using dynamic seed
Initialization User’s browser
SSL-encrypted Protocol (CT- provisioning.
KIP)
Port Number
Function Source Description
and Protocol
Authentication Manager primary and
replica instances and for communication
Manager,
between replica instances (for replay
trusted realm
detection).
network realm, or the web tier and
SSL-encrypted
access point, another appliance Used to communicate with trusted
RBA, or the realms and for RBA.
web tier
Allows communication between the
appliance and its web tier.
Required for administering your
7072, TCP Operations deployment from the Operations
Super Admin’s browser
SSL-encrypted Console Console. Accepts requests for Operations
Console functions.
Authentication During a product update, the appliance
8443, TCP Manager opens this port in its internal firewall. The
Administrator’s browser
SSL-encrypted patches and appliance closes this port when the
service packs update is complete.
If an external firewall blocks this port,
the browser displays an inaccessible or
blank web page, but the update can
successfully complete.
Used for communication between
Authentication Manager and the
9786, TCP Embedded embedded identity router for multifactor
Authentication Manager
SSL-encrypted identity router authentication (MFA) token verification
over the Authentication Manager-identity
router channel.
1646, 1812, and 7082) on the Authentication Manager server are open by default.
Note: You must protect these ports by blocking the ones that are not used and restricting access to the ones
that must be used only by Authentication Manager.
The RADIUS standard initially used UDP ports 1645 and 1646 for RADIUS authentication and accounting
packets. The RADIUS standards group later changed the port assignments to 1812 and 1813. The
Authentication Manager RADIUS server listens on all four ports for backward compatibility. If all the RADIUS
clients are configured to talk to the RADIUS servers only on ports 1812 and 1813, you should block legacy ports
1645 and 1646 on the external firewall.
Whether or not you use RSA RADIUS, if you have replica instances in your deployment, you must allow
connections between Authentication Manager instances on TCP ports 1812 and 1813. These ports are required
for tasks such as replica attachment, replica promotion, and IP address and hostname changes. New replica
instances must be allowed to connect on these ports.
You must restrict all connections to TCP ports 1812 and 1813 from other systems that are not Authentication
Manager instances. For example, use your external firewall to block access or use additional layers of network
protection to block unauthorized internal users and all other connections that are not Authentication Manager
instances.
If you do not plan to use RADIUS, you can close the RADIUS authentication UDP ports 1645 and 1812.
The following table lists the default listening ports on the web-tier server when a load balancer is installed in a
deployment.
If your environment has firewalls or proxy servers, make sure that they allow communication between the web
tier and all other hosts and services that provide Authentication Manager functionality. These hosts and
services, which are listed in the Source column, include Authentication Manager appliances, load balancers, and
browsers.
Port
Number
Function Source Destination Description
and
Protocol
Self-Service Console, risk-based Primary web- Accepts requests for Self-Service
User’s
443, TCP authentication (RBA), and tier Console functions, RBA authentication,
browser
dynamic seed provisioning hostname and dynamic seed provisioning.
Web-tier
Load Accepts requests for RBA authentication
443, TCP RBA virtual
balancer that use the virtual hostname.
hostname
The following table lists the default listening ports on the web-tier server when a load balancer is not used in
your deployment.
If your environment has firewalls or proxy servers, make sure that they allow communication between the web
tier and all other hosts and services that provide Authentication Manager functionality. These hosts and
services, which are listed in the Source column, include Authentication Manager appliances, load balancers, and
browsers.
Port
Number
Function Source Destination Description
and
Protocol
Self-Service Console, risk-based Primary Accepts requests for Self-Service
User’s
443, TCP authentication (RBA), and dynamic web-tier Console functions, RBA authentication,
browser
seed provisioning hostname and dynamic seed provisioning.
Web-tier
User’s Accepts requests for RBA
443, TCP RBA virtual
browser authentication.
hostname
Note: Keep port 443 (or another port number if you change the default) open on the replica web tier, so that a
listening port is available.
RSA recommends that you set up all RSA Authentication Manager instances in a subnet that has an external
firewall to segregate it from the rest of the network. To enable authentication through external firewalls and to
accommodate static Network Address Translation (NAT), you can configure alias IP addresses for Authentication
Manager instances and alternate IP addresses for authentication agents. You can assign the following:
l Four distinct IP addresses (the original IP address and up to three aliases) to each Authentication
Manager instance. For instructions, see the Help topic “Add Alternative IP Addresses for Instances.”
l An unlimited number of alternate IP addresses (one primary IP address) to your agents. For instructions,
see the Help topic “Add an Authentication Agent.”
Each distinct IP address must be assigned to only one Authentication Manager instance. Authentication Manager
instances must not share an IP address, even if it is hidden by NAT.
You must know the primary IP address and aliases for each Authentication Manager instance. If your
deployment includes multiple locations, you must also know which ports are used for Authentication Manager
communications and processes. You may need to open new ports in your firewall, or clear some existing ports
for your deployment. Port translation is supported if the primary and replica instances are communicating on the
standard Authentication Manager ports. For example, the primary and replica instances must communicate on
port 7002, TCP. For more information on ports, see Port Traffic on page 102.
l If your deployment does not include a replica, or if your primary and replica instances are on the same
LAN, close port 7002 on your external firewall (not the appliance firewall) so that it does not pass
external traffic to the primary or replica instances.
l If your primary and replica instances are connected through a WAN and there is a firewall between them,
open port 7002 on the firewall, but restrict traffic on this port to originate only from the IP addresses of
the primary and replica instances.
Appendix C: Administrative Accounts
System Administrator Accounts 112
Manage a Super Admin Account 113
The following accounts provide permission to modify, maintain, and repair the Authentication Manager
deployment. Quick Setup creates these accounts with information that you enter. If you plan to record the logon
credentials for these accounts, be sure that the storage method and location are secure.
User IDs for a Super Admin and a non-administrative user are validated in the same way. A valid User ID must
be a unique identifier that uses 1 to 255 ASCII characters.
A valid User ID for an Operations Console administrator must be a unique identifier that uses 1 to 255 ASCII
characters. The characters @ ~ are not allowed, and spaces are not allowed.
RSA recommends the following best practices for administrative accounts:
l Create a separate administrative account for each administrator, for example, create a separate
Operations Console administrator account for each Operations Console user. Do not share account
information, especially passwords, among multiple administrators.
l RSA does not recommend associating administrative roles with external LDAP or Active Directory user
accounts. Use separate administrative accounts with their own credentials for external identity source
administrators and Authentication Manager administrators.
l If you have multiple administrators, restrict the scope and permissions of Authentication Manager
administrative accounts, and restrict access by dividing your deployment into security domains.
Separation of privileges is especially important if you are using LDAP or Active Directory users as
administrators.
l If administrative roles in Authentication Manager are associated with an external LDAP account, a
specific role. with appropriate limiting controls, should be used. For instructions, see the Help topic
Administrative Role Scope and Permissions on RSA Link.
Every appliance also has a root user account. This account is not needed for normal tasks. You cannot use this
account to log on to the appliance.
You can access the operating system with Secure Shell (SSH) on a hardware appliance or a virtual appliance.
Before you can access the appliance operating system through SSH, you must use the Operations Console to
enable SSH on the appliance.
On a VMware virtual appliance, you can also access the appliance operating system with the VMware vSphere
Client. On a Hyper-V virtual appliance, you can also access the appliance operating system with the Hyper-V
System Center Virtual Machine Manager Console or the Hyper-V Manager.
An Operations Console administrator can change the operating system account password, rsaadmin, in the
Operations Console.
RSA does not provide a utility to recover the operating system password.
Only a Super Admin can manage a Super Admin account.
Procedure
1. In the Security Console, click Identity > Users > Manage Existing.
2. Use the search fields to find the user that you want to edit.
3. Click the user that you want to edit and select Edit.
4. Update the user settings.
5. Click Save.
Appendix D: Installing the RSA Authentication Manager
Token Management Snap-In
Overview 116
System Requirements 116
Install the Token Management Snap-In for Local Access 116
Install the Token Management Snap-In for Remote Access 117
Performing Post-Installation Tasks 119
Appendix D: Installing the RSA Authentication Manager Token Management Snap-In 115
RSA Authentication Manager 8.5 Setup and Configuration Guide
Overview
The RSA Token Management snap-in provides a convenient way to manage RSA SecurID tokens for
deployments that have an Active Directory identity source. The RSA Token Management snap-in extends the
context menus, property pages, control bars, and toolbars in the Active Directory Users and Computers snap-in
for the Microsoft Management Console (MMC). You can use the RSA Token Management snap-in to enable or
disable a token, assign a token, or perform other token-related tasks without logging on to the Security Console.
For more information on the administrative actions enabled by this extension, see the RSA Token Management
Snap-In for the Microsoft Management Console Help.
System Requirements
You can install the RSA Token Management Snap-In on the following platforms:
l Windows Server 2019 Domain Controller
l Windows Server 2019 with the Active Directory Domain Services (AD DS) Snap-Ins and Command Line
Tools
l Windows Server 2016 Domain Controller
l Windows Server 2016 with the Active Directory Domain Services (AD DS) Snap-Ins and Command Line
Tools
l Windows Server 2012 or 2012 R2 Domain Controller
l Windows Server 2012 or 2012 R2 with the Active Directory Domain Services (AD DS) Snap-Ins and
Command Line Tools
l Windows 10 with the Active Directory Domain Services (AD DS) Snap-Ins and Command Line Tools
Note: The RSA Token Management snap-in does not support Microsoft Active Directory Lightweight Directory
Services.
Use this procedure if you want to administer the Authentication Manager through the Token Management Snap-
In directly on the host where Active Directory is installed.
Before you begin
You must have the administrative permissions. These permissions (for example, domain level) depend on your
Windows network configuration. At minimum, you must be a domain administrator and a local machine
administrator.
116 Appendix D: Installing the RSA Authentication Manager Token Management Snap-In
RSA Authentication Manager 8.5 Setup and Configuration Guide
Procedure
1. Obtain the RSA Token Management Snap-In installation files. The files are in the RSA Authentication
Manager 8.5 – Token Management Snap-In for MMC.zip file that you can download from RSA Link.
2. Unzip all of the installation files into a directory that is located on the same machine where you are
installing the snap-in.
3. Run setup64.exe.
Note: The installer also installs the Visual C++ redistributable package if it is not already present.
5. For Authentication Manager server settings, enter values for the following:
l Authentication Manager server hostname
l Authentication Manager server port number
l Command Server Port
7. Review the Pre-installation screen, and click Next to continue.
8. Click Finish.
Use this procedure if you want to administer the Authentication Manager through the Token Management Snap-
In remotely from Windows 10, Windows Server 2012 or 2012 R2, Windows Server 2016, or Windows Server
2019 without Active Directory.
Active Directory Domain Services (AD DS) Snap-Ins and Command Line Tools are part of the Remote Server
Administration Tools and are used for remotely managing Active Directory Domain Controllers. To use these
tools:
l On Windows Server 2012 or 2012 R2, Windows Server 2016, and Windows Server 2019, the Remote
Server Administration Tools feature is part of the operating system and can be added from the Server
Manager.
l On Windows 10 with the October 2018 Update or later, you can add the Remote Server Administration
Tools feature. Go to "Manage optional features" in Settings and click "Add a feature." Select and install
"RSAT:Active Directory Domain Services and Lightweight Directory Services Tools."
You can enable the AD DS Snap-Ins and Command Line Tools after installing the Remote Server Administration
Tools.
Appendix D: Installing the RSA Authentication Manager Token Management Snap-In 117
RSA Authentication Manager 8.5 Setup and Configuration Guide
Before you begin
l You must have the appropriate permissions. These permissions (for example, domain level) depend on
your Windows network configuration. At minimum, you must be a domain administrator and a local
machine administrator.
l The administrator using the AD DS Snap-In and Command Line Tools to remotely administer the Active
Directory must have appropriate administrative permissions. These permissions (for example, domain
level) depend on your Windows network configuration.
Procedure
1. Enable the AD DS Snap-Ins and Command Line Tools feature in Remote Server Administration
Tools.
2. Obtain the RSA Token Management Snap-In installation files. The files are in the RSA Authentication
Manager 8.5 – Token Management Snap-In for MMC.zip file that you can download from RSA Link.
3. Unzip all of the installation files into a directory that is located on the same machine where you are
installing the snap-in.
4. Do one of the following:
l If you have a 32-bit version of Windows 10, run setup32.exe.
l If you have a 64-bit operating system, run setup64.exe.
6. For Authentication Manager server settings, enter values for the following:
l Authentication Manager server hostname
l Authentication Manager server port number
l Authentication Manager Command Server Port
8. Review the Pre-installation screen, and click Next to continue.
9. Click Finish.
118 Appendix D: Installing the RSA Authentication Manager Token Management Snap-In
RSA Authentication Manager 8.5 Setup and Configuration Guide
After a successful installation, perform the following tasks to complete the MMC Extension setup.
Procedure
1. Make sure that the Authentication Manager is set up and running.
2. Make sure that Active Directory is configured and registered as an identity source. For more information
see the Help topic "Identity Sources."
3. Start the Active Directory User and Computer Management Console below to open the RSA Token
Management Snap-In.
4. Configure the Connection with Authentication Manager below
5. Make sure that the Windows user for the Token Management Snap-In is a valid Active Directory
administrator and a valid Authentication Manager administrative user. For more information on
administrator and administrative permissions, see System Administrator Accounts on page 112.
Before you begin
Perform all of the preceding steps in Performing Post-Installation Tasks above.
Procedure
Do one of the following:
l Click Control Panel > Administrative Tools > Active Directory Users and Computers.
l From a command prompt, run dsa.msc.
Before you begin
Perform all of the preceding steps in Performing Post-Installation Tasks above
Procedure
1. Access the Active Directory Users and Computers Management Console.
2. Click on any user. This makes the RSA button visible in the toolbar.
The RSA Token Management Setting page is displayed.
Appendix D: Installing the RSA Authentication Manager Token Management Snap-In 119
RSA Authentication Manager 8.5 Setup and Configuration Guide
The format of the username displayed in the Login User field will be based on the chosen UserID
type.
Note: The UserID type must be the same as that defined for this identity source in the
Authentication Manager.
This user must be a member of the Domain Administrators group in Active Directory and must be
assigned Super Admin privileges in Authentication Manager.
If the UserID exists in more than one identity source, you can choose the identity source to test.
The chosen identity source will be displayed in the Identity Source Name field. When
prompted to use the certificate for future communication, click yes.
120 Appendix D: Installing the RSA Authentication Manager Token Management Snap-In