Set Up the OCI Account

When you switch OCI accounts or change from using the Free VM account to using an OCI account, you may need to manually set up the OCI account and then connect it to VB Studio.

1. Open the OCI console and, in the upper-left corner, click Navigation Menu .
2. Select Identity & Security and then, under Identity, select Compartments.
3. On the Compartments page, create a compartment to host VB Studio resources.
   1. To create the compartment in the tenancy (root compartment), click Create Compartment.
   2. In the Create Compartment dialog box, fill in the fields and click Create Compartment.
   To learn more about compartments, see Managing Compartments.
4. Create a user that can access the VB Studio compartment:
   1. In the navigation menu, select Identity & Security.
   2. Under Identity, select Users.
   3. Click Create User.
   4. Select the IAM user type.
   5. In the Create User dialog box, fill in the fields, then click Create.
   To learn more about OCI users, see Managing Users.
5. On your computer, generate a private-public key pair in the PEM format.
   To find out how to generate a private-public key pair in the PEM format, see How to Generate an API Signing Key.

   Here's an example of private-public key files on a Windows computer:

   
   

   
   Description of the illustration private-public-key.png

   
   
6. Upload the public key to the user's details page:
   1. Open the public key file in a text editor and copy its contents.
   2. In the navigation menu, select Identity and Security.
   3. Under Identity, select Users.
   4. Click the user's name created in Step 4.
   5. Under Resources, click API Keys.
   6. Click Add API Key.
   7. In the Add API Key dialog box, select the Paste Public Key option, paste the contents of the public key file, then click Add.
   To learn more about uploading keys, see How to Upload the Public Key.
7. On the Groups page, create a group for the user who can access the VB Studio compartment and add the user to that group:
   1. In the navigation menu, select Identity and Security.
   2. Under Identity, select Groups.
   3. Click Create Group.
   4. In the Create Group dialog box, fill in the fields and click Create.
   5. On the Groups page, click the group's name.
   6. On the Group Details page, click Add User to Group.
   7. In the Add User to Group dialog box, select the user created in Step 4 and click Add.
   To learn more about groups, see Managing Groups.
8. In the root compartment, not the VB Studio compartment, create a policy to allow the group created in step 6 to access the VB Studio compartment.
   1. In the navigation menu, select Identity and Security.
   2. Under Identity, select Policies.
   3. On the left side of the Policies page, from the Compartment list, select the root compartment.
   4. Click Create Policy.
   5. In Name and Description, enter a unique name and a description.
   6. In Compartment, select the root compartment.
   7. In Policy Builder, click Show manual editor and add these statements:
      • allow group <group-name> to manage all-resources in compartment <compartment-name>

        This grants all permissions to the VB Studio group users to manage all resources within the VB Studio compartment.

      • allow group <group-name> to read all-resources in tenancy

        This grants read permissions to the VB Studio group so that its users can read—but not use, create or modify—all resources inside and outside the VB Studio compartment. The group users can't use, create, or modify the resources.

      Here's an example:

      
      

      
      Description of the illustration oci_create_policy_dialog_crop.png

      
      
   8. Click Create.
   To learn more about policies, see Managing Policies.