Microsoft Standalone CA

Prerequisites

The prerequisites for configuring Microsoft Standalone CA in AppViewX are as follows:
  • AppViewX Windows Gateway installer should be installed in a windows machine, running and reachable from AppViewX vendor plugin through the Communication Modes described below.
  • Windows Gateway URL: It is the registered gateway URL of the server where the windows gateway is hosted/installed. The URL format is https://hostname:portnumber/appviewx. For example: https://10.10.10.10:8999/appviewx
  • Client Authentication Certificate: It is the certificate (.p12 or .pfx format) that is shipped with the windows gateway agent installer.
  • AppViewX server should either have internet access or have a proxy configured in AppViewX general settings. Refer to the section Managing Proxy Settings in the Platform guides.
Table 1. Communication Mode Table
Communication mode Category Windows gateway machine Microsoft CA
NATIVE API User account type Service account Service account
User permission NA Read, Request certificates, Issue and Manage certificates permission at CA level for the service account or the service account group or authenticated users

Enroll permission at Certificate template level for the service account or the service account group or authenticated users
Services RPC service RPC service

certutil.exe command availability
Ports NA 135 as incoming port
POWERSHELL User account type Service account Service account
User permission NA Full control permission to C:\Windows\Temp

Read, Request certificates, Issue and Manage certificates permission at CA level for the service account or the service account group or authenticated users
Services RPC Service,WinRM Service,WinRM Configuration, Powershell remoting,certutil.exe command availability RPC Service,WinRM Service,WinRM Configuration, Powershell remoting,certutil.exe command availability
Ports NA 5985
WMI User account type Service account Service account
User permission NA Full control permission to C:\Windows\Temp

Read, Request certificates, Issue and Manage certificates permission at CA level for the service account or the service account group or authenticated users
Services WMI service

certutil.exe command availability

 WMI service

certutil.exe command availability
Ports NA 135, 445 or 139

Configuring Microsoft Standalone CA

  1. Go to menu > KUBE+ > CLUSTER PKI > Certificate Authority.
  2. From the displayed CA, select Microsoft.
    The Microsoft home page is displayed.
  3. Select the Standalone tab.
  4. In the Status column of the grid with the listed accounts, click and then click +Add icon or Configure Now button.
  5. Enter/Select the CA General Information.
    Table 2. General Information - Field Description Table
    Fields Description
    Name A unique name to identify the CA setting.
    Note: No special characters other than ‘.’, ‘-’,’_’ are allowed. Names should not start with special characters.
    *Purpose/Usage Certificate Type for which CLM actions will be enabled. For example: Server, Client, and Code Signing.
    Proxy Required Enable this field if the CA communication needs to happen via Proxy. The proxy details configured in general settings will be used for communication.
    Data Center (AppViewX's CA agent) Select the data center through which the CA communication needs to happen.
    *: Mandatory fields
  6. Enter/Select the CA Configuration details.
    Table 3. CA Configuration - Field Description Table
    Fields Description
    Windows Gateway Mode For communicating with Windows-based devices, from the following options, select the gateway agent mode to be used:
    • External

      This mode will use the AppViewX Windows Gateway Agent that is set up on a Windows device.

    • Integrated

      This mode will use the prepackaged gateway that is integrated in the AppViewX Cloud Connector (enabled only in the SaaS and Managed Kubernetes installations).

    Prerequisites for using the Integrated Windows Gateway mode
    *Windows Gateway URL For Windows Gateway Mode = External, enter the URL of the endpoint where the AppViewX Windows Gateway Agent is installed and running.
    Command Execution Type Select the command type that will be used for communication with the External AppViewX Windows Gateway Agent.
    Note: The integrated gateway uses only the PowerShell command execution type and therefore, this field is not displayed when Windows Gateway Mode = Integrated.
    Command execution host (IP/FQDN)
    Note: This field is displayed when Windows Gateway Mode = Integrated.
    Enter the IP address/FQDN of the remote Windows device that the integrated gateway will use for CA communication.
    *Credential Type You will be required to enter credentials to access the command execution host/Windows device on which the gateway agent is running.

    From this dropdown list, select the mode through which the credentials will be entered (manually or fetched from a credential list).
    Username Enter the username for accessing the Windows device.
    Password Enter the password for accessing the Windows device.
    Client Authentication Certificate
    Note: This field is displayed only when Windows Gateway Mode = External and Select gateway = New.
    Upload the client certificate used while installing Windows Gateway. You can use the default client certificate (ClientCertificateGateway.pfx) or a custom certificate.
    *: Mandatory fields
  7. Click Fetch CA Names to retrieve CAs accessible from Windows Gateway installed machine.
    Upon successful completion of Fetch CA Names, all reachable CAs listed in Select CA.
  8. Click on one specific CA and proceed.
    Table 4. Dynamic Fields for Select CA Section
    Fields Description
    Select CA All the reachable CAs are listed here.
    *CA Machine Hostname Host name of the CA Machine will be auto-filled.
    *CA Name Name of the CA chosen which will be auto-filled.
    CA Manager Approval Approves the pending enroll / Renew request submitted from AppViewX Certificate.
    *: Mandatory fields
  9. Click Save.

Validating Microsoft Standalone

Once the Microsoft Standalone settings are added validation needs to be done to check whether the connection between AppViewX and Microsoft Enterprise is properly configured.
  1. Go to menu > KUBE+ > CLUSTER PKI > Certificate Authority.
  2. From the displayed CA, select Microsoft.
    The Microsoft home page is displayed.
  3. Select the Standalone tab.
  4. In the Status column of the grid with the listed accounts, click Check to validate the CA setting that has been created.
    The CA communication will be validated and the Connection Status will be shown as either Success or Failure.Success scenario for Native APISuccess scenario for PowershellSuccess scenario for WMI.
    Success scenario for Native API
    Success scenario for Powershell
    Success scenario for WMI