Connecting an Oracle Cloud Infrastructure (OCI) account

Oracle Cloud Infrastructure

Oracle Cloud Infrastructure (OCI) is a comprehensive platform offering high-performance computing and a wide range of cloud services, designed for reliability, scalability, and security.

Integrating DigiUsher with OCI allows you to efficiently manage your cloud resources, optimize spending, and gain valuable insights into your OCI cloud operations.

Oracle Cloud Infrastructure is FOCUS ready, and fetches Cost and Usage Reports from the FOCUS Schema. To learn more about FOCUS and it's schema, please refer to the FOCUS Cost Report Schema on OCI documentation.

Create a New Group for DigiUsher

Access permissions in Oracle are assigned to groups. Create a separate group for DigiUsher to ensure access only to the necessary billing resources.

1. Go to the OCI navigation menu → Identity & Security → Domains → <digiusher_domain> → Groups.
2. [OPTIONAL] If you don't have a separate domain for DigiUsher and want to create one, do so by following the instructions in the OCI documentation.
3. Click Create group. Once you click on this button, a side panel will open.
4. Fill in the Group Name as Digiusher and add a suitable Description.
5. Click Create.

Add a Policy to Access the Cost Reports

Assign a policy to the group for accessing cost reports. In OCI, group permissions are managed through policies.

1. Go to the OCI navigation menu → Identity & Security → Policies.
2. Click Create policy.
3. Choose a name for the policy that clearly indicates its purpose for accessing cost reports. Also, write a description for the policy.
4. In the policy builder box, activate the Show manual editor button and enter the following statements:

define tenancy usage-report as ocid1.tenancy.oc1..aaaaaaaaned4fkpkisbwjlr56u7cj63lf3wffbilvqknstgtvzub7vhqkggq endorse group Digiusher to read objects in tenancy usage-report

5. Click Create.

Create a User for DigiUsher

1. Go to the OCI navigation menu → Identity & Security → Domains → <digiusher_domain> → Users.
2. Click Create User.
3. Fill in the name and email of the DigiUsher user.
4. Assign the user to the new DigiUsher group you created in step 1 of Create a New Group for DigiUsher.
5. Click Create.

Generate an API Key

Generate an API key to enable DigiUsher users to access the reporting bucket via the Oracle API key.

1. Navigate to Identity & Security → Domains → <digiusher_domain> → Users, and click the DigiUsher user to access their profile.
2. Navigate to the Resources section and select API keys.
3. Click Add API key.
4. Select Generate API key pair radio button.
5. Click Download Private Key and save the key in a local directory.
6. Click Add.
7. A Configuration file preview will be displayed. This will have user id, fingerprint, tenancy id and region. Save these details somewhere by clicking on the copy button.

Add Oracle Cloud Infrastructure Data Source to DigiUsher

1. Go to the DigiUsher navigation menu → Data Sources. If you are a new user, you will see the Connect Data Source button. Click on it. If you have already added a data source previously, you will see the Add button. Click on it.

2. You will see the Connect Data Source page. Select Oracle Cloud Infrastructure as the data source type.

3. Fill in the details for the Oracle Cloud Infrastructure data source. From the Configuration File section, paste the details you saved in step 7 of the Generate an API Key section.

4. Upload the private key file you saved in step 5 of the Generate an API Key section.
5. Click Connect.

Your OCI data source should now be ready for integration with DigiUsher! Please contact our Support Team at support@digiusher.com if you have any questions or face any issues.