Flowdock Enterprise Export

Enterprise export is supported on the following operating systems:

For Linux, Unix, and Mac

For enterprise export, open a command line window, such as Terminal or iTerm.

Create a public or private key

Create keys using either the PEM or DER format. Follow these steps to create a public and private key pair with the PEM format (note that all commands are run on the command line):

  1. openssl genrsa -aes256 -out private.pem 4096
    • Enter a pass phrase when prompted.
    • This creates a file called private.pem that contains the private key.
  2. openssl rsa -aes256 -inform PEM -outform PEM -pubout -in private.pem -out public.pem
    • Enter the pass phrase used in step 1.
    • This creates a file called public.pem that contains the public key.
  3. Contact Flowdock support. The entire contents of the public.pem file, including the BEGIN and END lines, will be entered by Flowdock support into the organization’s enterprise export configuration.

Decrypt the .iv, .key, and .zip files

After you download the .iv, .key, and .zip files from links in an email sent to you with the subject line: Flowdock: Enterprise export finished, follow these steps to generate an unencrypted zip file:

  1. openssl rsautl -decrypt -in (input file name).iv -out (output file name).iv -inkey private.pem -keyform PEM
    • In this case, private.pem contains the previously generated private key.
    • (input file name).iv is the downloaded .iv file.
    • Enter the pass phrase.
    • The decrypted initialization vector will be stored in (output file name).iv.
  2. openssl rsautl -decrypt -in (input file name).key -out (output file name).key -inkey private.pem -keyform PEM
    • In this case, private.pem contains the previously generated private key.
    • (input file name).key is the downloaded .key file.
    • Enter the pass phrase.
    • The decrypted key will be stored in (output file name).key.
  3. openssl aes-256-cbc -d -iv `xxd -c256 -p (output file name).iv` -K `xxd -c 256 -p (output file name).key` -in (input file name).zip -out (output file name).zip
    • This uses the previously decrypted (output file name).iv and (output file name).key files.
    • (input file name).zip is the downloaded .zip file.
    • The output is placed into (output file name).zip which can be unzipped using normal methods. For example, unzip (output file name).zip.

For Windows

  1. Create a folder for your enterprise export on your Windows machine in your user directory.
  2. Install Cygwin on your Windows machine:
  3. Important: Install the xxd Hexdump utility when choosing the packages to install.

    • Select Skip in the New column to change to the revision. If this step is missed when initially installing Cygwin, redeploy the installer (setup-x86_64.exe or setup_x86.exe) and search for the xxd package.
    • Watch this step-by-step video on how to install Cygwin.
  4. If you are unable to see the file folders on your C drive, you will have to mount the C drive using Cygwin with the following commands:
    1. cd /
    2. mkdir c
    3. mount c: /c
    4. cd /c or cd c: ls

      You may have to do a cd users then cd (your username) to see the zip files you downloaded.

  5. Using Cygwin, navigate to your enterprise export directory:
    1. cd c
    2. ls (to list directories) then cd to the enterprise export directory

Create a public or private key

Using Cygwin, enter the following commands to create a public and private key:

  1. openssl genrsa -aes256 -out private.pem 4096
  2. Enter a pass phrase when prompted to create a file called private.pem that contains the private key.
  3. openssl rsa -aes256 -inform PEM -outform PEM -pubout -in private.pem -out public.pem
  4. Enter the pass phrase used in the previous step to create a file called public.pem that contains the public key.
  5. Contact CA Flowdock support to send the following information:
    • The entire contents of the public.pem file, including the BEGIN and END lines. These are entered by Flowdock support into the organization's enterprise export configuration.
    • The email address that will receive the enterprise export. This will need to be a Flowdock userID that is an administrator for the Flowdock organization.
    • You will be notified after CA Flowdock Support configures the export for your company. The export runs every night at 8:00 pm Mountain Standard Time and sends an email with the export information.

Decrypt the .iv, .key, and .zip files

Using the Windows File explorer, download the three files from the enterprise export email to the enterprise export directory you created.

  1. Open a browser window and login to Flowdock as the user listed in the previous section.
  2. Using Cygwin, navigate to the enterprise export folder.
  3. Using Cygwin, enter the following commands to decrypt the export files:
    1. openssl rsautl -decrypt -in (input file name).iv -out (output file name).iv -inkey private.pem -keyform PEM
      • In this case, private.pem contains the previously generated private key.
      • (input file name).iv is the downloaded .iv file.
      • Enter the pass phrase.
      • The decrypted key is located in (output file name).key.
    2. openssl rsautl -decrypt -in (input file name).key -out (output file name).key -inkey private.pem -keyform PEM
      • In this case, private.pem contains the previously generated private key.
      • The (input file name).key is the .key file downloaded from the email.
      • Enter the passphrase.
      • The decrypted key is located in (output file name).key.
    3. openssl aes-256-cbc -d -iv `xxd -c256 -p (output file name).iv` -K `xxd -c 256 -p (output file name).key` -in (input file name).zip -out (output file name).zip
      • If you receive the following error when running the above command, see step 2 to install the xxd hex package on Cygwin: -bash: xxd: command not found.
      • This uses the previously decrypted (output file name).iv and (output file name).key files.
      • (input file name).zip is the downloaded .zip file.
      • The output is placed into (output file name).zip which can be unzipped using normal methods. Example: unzip (output file name).zip.

You should see all the folders containing the export information in the enterprise export folder you created.

Feedback

Need more help? The CA Agile Central Community is your one-stop shop for self-service and support. To submit feedback or cases to CA Agile Central Support, find answers, and collaborate with others, please join us in the CA Agile Central Community.