Skip to content

Authentication

LDAP authentication

LDAP (Lightweight Directory Access Protocol) is a protocol used to locate organizations, individuals, and other resources within a network.

Create an authentication mode

  1. In the left navigation bar, navigate to Show more > LDAP authentication.
  2. At the top, click New authentication mode (LDAP).
  3. Fill in the following fields:

    • Name: Give the directory a name.
    • Host: the LDAP hostname.
    • Port: the LDAP port.
    • LDAP: select which LDAP to use to access the directory.
    • Account: Enter a username that has read access to the LDAP; otherwise, leave this field blank if your LDAP can be read anonymously.
    • Password: password for the account.
    • Base DN: the top-level DN of your LDAP directory tree (example: dc=example,dc=com).
    • LDAP filter: filters can be used to limit the number of users or groups that are allowed to access an application.
    • Timeout (in seconds): if the LDAP provider does not receive an LDAP response within the specified period, it aborts the read attempt.
    • On-the-fly user creation: By checking this, any LDAP user will have their VNCdirectory account automatically created the first time they log into VNCdirectory. Otherwise, you will have to manually create the user in VNCdirectory for each LDAP user who wants to log in.
  4. Under the Attributes section, specify the following fields:

    • Login attribute: the login name under which a user logs in and is authenticated.
    • Firstname attribute: attribute for first name.
    • Lastname attribute: attribute for last name.
    • Email attribute: attribute for email.
  5. Click CREATE.

Delete an authentication mode

  1. In the left navigation bar, navigate to Show more > LDAP authentication.
  2. Click the trash bin icon next to the authentication mode you want to delete.
  3. When prompted, click OK confirming that you want to delete the authentication mode.

Instance Certificates

Create a certificate

  1. In the left navigation bar, navigate to Show more > Instance Certificates.
  2. At the top, click + New Certificate.
  3. Enter Serial number and Instance subdomain for the cettificate.
  4. Enter Description for the certificate.
  5. Under the Certificate Information section, provide details that will be embedded in the digital certificate. These fields help identify the certificate owner and are used during verification processes.

    • Organization name. The legal name of the organization that owns or operates the application or service. This name appears in the certificate as part of the entity's identity.
    • (Optional) Organization country code. A two-letter ISO country code (e.g., US, DE, PL) that indicates the country where the organization is legally registered.
    • (Optional) Organization city. The city where the organization is located. Used to give more context to the certificate holder’s geographical presence.
    • (Optional) Organization state. The state, province, or region of the organization’s location. This helps disambiguate organizations with similar names in different areas.
    • (Optional) Organization unit. The department or division within the organization responsible for managing the certificate or the service it secures (e.g., IT Department, Security Team).
    • (Optional) Organization common name. A name that usually reflects the domain name associated with the certificate (e.g., app.example.com). It is often used in server-side certificates to match the domain clients are trying to reach.
  6. Under the Validity Information section, specify the start and expiry date for the certificate.

  7. Check the box next to a required product.
  8. Click CREATE.

The certificate is now successfully created and will be available in the Certificates list.

Edit certificate information

There are 2 ways to edit certificate information.

Way 1. Using the pencil icon.

  1. In the left navigation bar, navigate to Show more > Instance Certificates.
  2. Click the pencil icon next to the certificate you want to edit.
  3. Make the changes.
  4. Click SAVE.

Way 2. Going to the Certificate overview page.

  1. In the left navigation bar, navigate to Show more > Instance Certificates.
  2. Click the eye icon next to the certificate you want to edit.
  3. In the Info tab, click Edit.
  4. Make the changes.
  5. Click SAVE.

View certificate information

  1. In the left navigation bar, navigate to Show more > Instance Certificates.
  2. Click the eye icon next to the certificate you want to view.