Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Ensure that powershell is up to date and installed on your server (odds are it is). For more info, please refer to this documentation

  2. Ensure that you have Admin access to the Microsoft server containing your domain controller, along with admin access to Zilla.

  3. We require a service account on Active Directory with domain user access that will be used to export user data from AD.

  4. We require an SSH Public/Private RSA Key to be made. To do this:

    1. Run the following command. Do not add a passphrase to the key. This is not supported at this time:

      Code Block
      ssh-keygen -b 2048 -t rsa -f '/home/...'
    2. This will generate a public/private key in the filepath that you defined. Be sure to include the name of the key pair at the end of the filepath. If you didn’t define a path, it will be stored at /home/user_name/.ssh/ with the name id_rsa

    3. If you are using Zilla’s sFTP server, you will need to provide the public key to you Zilla Technical Contact. You can also email support@zillasecurity.com to open a ticket and request an sFTP server. Be sure to include the public key file in the request.

    4. take note of the filepath for the private key for later configuration.

  5. You will need to request an sFTP server be created by Zilla (recommended) or have your own sFTP server. You can ask your Zilla Technical Resource (Sales Engineer or Customer Success Engineer) or submit a request by emailing support@zillasecurity.com. You must provide us with the public key file for us to create this server. To Access the sFTP Server, you will use the following:

    1. Hostname: sftp.zillasecurity.com

    2. Username: This is the domain corresponding to your zilla tenant. You can find this inside of the global settings of your zilla tenant. It will be the first domain listed under Your Domains. In the screenshot below, my sFTP username would be mp.access-ventures.com

...

c. Password: this is the string value contained in your private SSH key:

...

Configuring Active Directory

...

  1. Fill out the attributes in the form.

    1. If you are using Zilla’s sFTP Server, then the values should be the following:

      1. Host: sftp.zillasecurity.com

      2. Port: 22

      3. Username: your zilla tenant’s domain. You can find this inside of the global settings of your zilla tenant. It will be the first domain . See step 5 in the requirements section for more informationlisted under Your Domains. In the screenshot below, my sFTP username would be mp.access-ventures.com

        image-20240416-160838.pngImage Added
      4. File Path: This is the name of the CSV file you are generating. Example would be directory.csv

      5. Password: The Private Key value generated. See step 5 in the requirements section for more information

    2. If you are using your own sFTP Server, then you will need to setup SSH Key-based authentication (see this guide for more info on how to do this) and add the public key you generated to your authorized_keys directory. You will also need to create a service account for zilla to use. Once this is done, the values in Zilla will be:

      1. Host: the hostname of your sFTP server

      2. Port: 22

      3. Username: the username of the service account you created.

      4. File Path: This is the path corresponding to where the CSV file is stored. For example if you stored the file directory.csv in /sftp/zilla on your sFTP server, then the value here would be sftp/zilla/directory.csv

      5. Password: The Private Key value generated. See step 5 in the requirements section for more information

Info

Do not include the BEGIN and END OPENSSH PRIVATE KEY headers in the password. It should only be the raw string in between.

...

  1. Select Sync Now to kickoff the automated syncs.

Help:

Having trouble? Please refer to this documentation