Installing the Client Application

The Oracle Universal Authenticator client application must be installed on any Windows device that will use Oracle Universal Authenticator to log in. How the installer or application is deployed on the client will depend on how your organization normally rolls out applications.

The installer can run in GUI mode, or in silent mode. Regardless of how the Oracle Universal Authenticator application or installer is deployed, you must login as a local Administrator user and the installer must be executed from inside a command prompt run using the Run as Administrator option.

Before running the Oracle Universal Authenticator client application installer, you must know the following information about the DRSS endpoint, for example https://oaa.example.com:443/oaa-drss:

Host: <DRSS_HOSTNAME>, for example oaa.example.com.
Port: <DRSS_PORT>, for example 443.
User name: <DRSS_APIUSER>, for example OAA_INSTALL_OAA_DRSS.
Password: <DRSS_APIKEY>.

Note:

For details on how to find the required DRSS information, see Print Deployment Details.

Downloading the Oracle Universal Authenticator Client Application Software

Follow the instructions below to download the Oracle Universal Authenticator client application software:

Download the Oracle_Universal_Authenticator_<version>.zip from Oracle Software Delivery Cloud. Alternatively, it can be downloaded from the location referenced in document ID 2723908.1 on My Oracle Support.
Extract the zip file to a working directory %WORKDIR% on the installation host. The Oracle Universal Authenticator.msi will be extracted.

Running the Installer in GUI Mode

Follow the instructions below to install the Oracle Universal Authenticator client application in GUI mode:

Start a Command Prompt selecting Run As Administrator.
Inside the command prompt run the following to set the permissions:
```
powershell.exe Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
```

Inside the same command prompt run:

Msiexec.exe /i "%WORKDIR%\Oracle Universal Authenticator.msi"

In the Welcome screen, select Next.
In the DRSS Server Endpoint Setup screen, enter the following information and click Next:
- Server: <DRSS_HOSTNAME>
- Endpoint: /oaa-drss
- Port: <DRSS_PORT>
- API User: <DRSS_APIUSER>
- API Key: <DRSS_APIKEY>
In the Setup Type screen, select Complete and click Next.
In the Ready to Install the Program screen, click Install.
In the InstallShield Wizard Complete screen, click Finish.
In the Oracle Universal Authenticator Installer Information screen, select No to restart the system.
Inside the same command prompt run the following command to import the required certificate:
```
powershell.exe -ExecutionPolicy Bypass "%WORKDIR%\AddCertificate.ps1"
```
The output will look similar to the following:
```
Certificate import successful
SSL Certificate successfully added
Binding successful
```
Restart Windows.

Running the Installer in Silent Mode

Follow the instructions below to install the Oracle Universal Authenticator client application in silent mode:

Start a Command Prompt selecting Run As Administrator.
Inside the command prompt run the following to set the permissions:
```
powershell.exe Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
```
Inside the command prompt, run the installer as follows:
```
Msiexec.exe /i "%WORKDIR%\Oracle Universal Authenticator.msi" HOST=<DRSS_HOSTNAME> ENDPOINT="/oaa-drss" PORT=<DRSS_PORT> APIUSER=<DRSS_APIUSER> APIKEY=<DRSS_APIKEY> /qn
```
Note:
The /qn flag runs the installer in silent mode. If /qn is not used the GUI will launch and the Administrator will need to navigate through the screens as per Running the Installer in GUI Mode.
Inside the same command prompt run the following command to import the required certificate:
```
powershell.exe -ExecutionPolicy Bypass "%WORKDIR%\AddCertificate.ps1"
```
The output will look similar to the following:
```
Certificate import successful
SSL Certificate successfully added
Binding successful
```
Restart Windows.