Configure App within Box Account
Using Box as a docuflow repository requires the following steps:
- Generate your private key certificate
- Generate your private key .der file
- Generate your public key
- Creation and configuration of the docuflow App within your Box account
- Authorization of the docuflow App within your Box account
- 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.
Create your private key certificate using the following OpenSSL command:
openssl genrsa -aes256 -out <your_privatekey>.pem 2048
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 from the <your_privatekey>.pem file:
openssl rsa -in <your_privatekey>.pem -outform PEM -pubout -out <your_publickey>.pem
- Log in as a Box Administrator to your Box environment.
- Navigate to your Dev Console section
- Choose "Custom App" and then click Next.
- Choose "Create New App"
- Navigate to the "Configuration" section
- Selection OAuth 2.0 with JWT (Server Authentication) and click Next
- Name your app. It is suggested docuflow is included in the name.
- Click "View Your App"
- Take note of your Client ID and Client Secret for configuration of the docuflow middleware. Keep this information secure
- Ensure the "App Access Level" is set to "Application + Enterprise Access"
- Ensure the "Application Scopes" is set to:
- Read all files and folders stored in Box
- Write all files and folders stored in Box
- Manage Users
- Under advanced features enable "Generate user access tokens".
- Under "Add and Manage Public Keys, choose "Add a Public Key" and enter the public key from the step "Generate your public key" above.
- Click "Save Changes" in the top right of your screen.
- Navigate back to the "General" section on the left of your screen
- Click "Submit for Authorization"
- Copy the Client ID and the Public Key ID for the next step below
- Log in as a Box Administrator to your Box environment.
- Navigate to your Enterprise Settings
- Click on the “Apps” tab
- Choose "Custom Apps"
- Click “Authorize New App"
- Press the “Authorize” button
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:
- Enterprise ID
- Client ID
- Public Key ID
- Client Secret
- <your_privatekey>.der file