How to use Box Service Account - Part 1

What is Box Dicom

• The Box Dicom Viewer allows developers to store, view and share Dicom files like X-rays, CT scans, Ultrasounds and MRIs securely with Box while still embedding the viewer into their own application.
• The Box Dicom viewer is an FDA cleared class II Medical Device for diagnostic viewing.
• Box Platform supports two distinctly different application types.
• The type of service you are trying to create determine the type of Box App you will want to configure.

What is Service Account

• A Service Account is a unique kind of App User that is similar to an Admin User yet has no login credentials and can only access Box via the API.
• Service Accounts are automatically created when a Custom App is created in the developer console with the JWT authentication method. When these applications authenticate the default user it authenticates as is the Service Account for that application.
• With the right scopes configured Service Accounts can edit enterprise permissions and manage both Managed Users and App Users

How to Connect to Box Service Account

• Using service account we can store data on the application level irrespective of users.
• To store file in box there is need to create Application in Box.
• For that first we have to create Application in Box.
• After that we have to create account in Auth0 and register an application for getting JWT token from Auth0.

Following are the steps -

Create Login in Box Dicom

• For creating account in Box Dicom go to link https://developer.box.com/guides/embed/box-dicom/
• You will get the following screen
• Click on Sign Up

• 
  
  

• After that you will get the following screen.
• Fill all the details and click on Submit.

• After that you will get the following screen.

• You will get verification link to your email Id that you have registered.
• After clicking on that link you will reset your password.
• After that you will get the following screen.
• Login to your account.

• You will get the following screen.
• Click on Dev Console.

• You will get the following screen.
• Click on Create New App.

• You will get the following screen
• Select the Custom App and click on Next

• You will get the following screen
• Select the Oauth 2.0 with jwt (Server Authentication)
• Click on Next

• You will get the following screen.
• Enter your application name
• Click on Create App

• You will get the following screen.
• Click on View your App
  
  
   
• You will get the following screen.
• In the configuration section following settings should be checked, which is used for using service account.

 

• After that click on Generate a Public/Private Keypair
  
   

• After clicking on Generate a public/private key pair, you will get the following notification.
• Becaue for generating public/private key pair, 2 step verification settings should be enabled.
• Click on settings which is highlighted in red notification.

• You will get the following screen.
• Check on Require 2 step verification to protect your account.

• You will get the following screen.
• Enter your mobile number and click on Continue

• You will get the following screen.
• You will get the verification code on your mobile number.
• Enter the code in below screen.

•  After that you will get the following screen.

• Click on your application that you have created.
• Go to configuration.
• Click on Generate a public/private key pair.
• After that you have to download the configuration file and save it.
• Using this configuration file you can connect to the box account and upload and download file in that application.
• Click on admin console
• You will get the following screen
• Click on Apps

• You will get the following screen
• Click on Custom apps

• You will get the following screen
• Click on Authorize New App
   
• You will get the following screen
• Paste the client id that is present in configuration section
• Click on Next
   

• You will get the following screen.
• Click on Authorize

•  After that you will get the following screen.

So you have created application on box. Now next we need to create account in Auth0 and then connect box application with Auth0 to securely access box application using Auth0 via our code. 

Service Account With Box Dicom - Part 2