for ECC and S/4
Installation and Base Configur...

Configure App within Box Account

6min

Using Box as a docuflow repository requires the following steps:

  1. Generate your private key certificate
  2. Generate your private key .der file
  3. Generate your public key
  4. Creation and configuration of the docuflow App within your Box account
  5. Authorization of the docuflow App within your Box account
  6. Adding generated and configured elements to the docuflow Enterprise Connector

Steps 1 thru 3 require OpenSSL. Please download it.

Enter the following commands in command prompt via the openssl binary.

"C:\openssl-1.1\x64\bin>openssl.exe" is the binary we want to pass parameters to in command prompt.

Generate your private key certificate

Create your private key certificate using the following OpenSSL command:

openssl genrsa -aes256 -out <your_privatekey>.pem 2048

Generate your private key .der file

Create your private key .der file from the <your_privatekey>.pem file using the following OpenSSL command:

openssl pkcs8 -topk8 -inform pem -in <your_privatekey>.pem -outform der -nocrypt -out <your_privatekey>.der

Generate your public key

Generate your public key from the <your_privatekey>.pem file:

openssl rsa -in <your_privatekey>.pem -outform PEM -pubout -out <your_publickey>.pem

Creation and configuration of the docuflow App within your Box account

  1. Log in as a Box Administrator to your Box environment.
  2. Navigate to your Dev Console section
  3. Choose "Custom App" and then click Next. 
  4. Choose "Create New App"
  5. Navigate to the "Configuration" section
  6. Selection OAuth 2.0 with JWT (Server Authentication) and click Next
  7. Name your app. It is suggested docuflow is included in the name.
  8. Click "View Your App"
  9. Take note of your Client ID and Client Secret for configuration of the docuflow middleware. Keep this information secure
  10. Ensure the "App Access Level" is set to "Application + Enterprise Access"
  11. Ensure the "Application Scopes" is set to:
    1. Read all files and folders stored in Box
    2. Write all files and folders stored in Box
    3. Manage Users
  12. Under advanced features enable "Generate user access tokens".
  13. Under "Add and Manage Public Keys, choose "Add a Public Key" and enter the public key from the step "Generate your public key" above.
  14. Click "Save Changes" in the top right of your screen.
  15. Navigate back to the "General" section on the left of your screen
  16. Click "Submit for Authorization"
  17. Copy the Client ID and the Public Key ID for the next step below

Authorization of the docuflow App within your Box account

  1. Log in as a Box Administrator to your Box environment.
  2. Navigate to your Enterprise Settings
  3. Click on the “Apps” tab
  4. Choose "Custom Apps"
  5. Click “Authorize New App"
  6. Press the “Authorize” button

Adding generated and configured elements to the docuflow Enterprise Connector

Refer to the section "Base docuflow Enterprise Connector Configuration – docuflow ECM Only" for configuration of the docuflow middleware and creation of app users that will require:

  1. Enterprise ID
  2. Client ID
  3. Public Key ID
  4. Client Secret
  5. <your_privatekey>.der file