Authentication in Cloud Infrastructure via Terraform

Here we explain how to get started with Terraform — specifically, how to connect to the Peerobyte cloud infrastructure using Terraform. To do this, you will obtain authentication data from the OpenRC file and from the Peerobyte Cloud Infrastructure service control panel, insert these data into your Terraform configuration file, and authenticate against the cloud infrastructure. You can also refer to the official HashiCorp documentation on configuring the OpenStack Provider for Terraform, available at the provided link. 

Prerequisites

1. Peerobyte Account.
   You must have an account in the Peerobyte client portal. For instructions on how to register, see “Creating an Account”.
   
2. Cloud Infrastructure service is enabled.
   You must have ordered the “Cloud Infrastructure” service and received a notification of its readiness either via the email associated with your account or in your Peerobyte client portal. For instructions on ordering the service, see “How to Order Cloud Infrastructure”.

I. Obtaining the Password from the Service Control Panel

Password for authentication is only available in the control panel of the Peerobyte cloud infrastructure service and can be obtained as follows:

1. Log in to the Peerobyte Control Panel. For instructions on how to do this, see:
   • a. If 2FA is not used, see “Logging in to the Control Panel”.
   • b. If 2FA is enabled, see “Logging in to the Control Panel with 2FA”.
     
2. Click “Services” in the main menu to navigate to “My Products & Services”.
   
3. Select the cloud infrastructure service you wish to authenticate to.
   
   
   
4. In the “Management Panel” section, click the “Click to copy” button (two-sheet icon) next to “Password”.
   
   
   
   The password will be copied to your clipboard, confirmed by the message “The data has been successfully copied to the clipboard.”

II. Obtaining the OpenRC File

You can download the OpenRC file from the cloud infrastructure control panel (Horizon) by following these steps:

1. Log in to the cloud infrastructure control panel (Horizon). For details, see “Logging in to the Cloud Infrastructure Control Panel (Horizon)”.
   
2. Click the user menu in the top-right corner of the Horizon interface.
   
   
   
   A drop-down menu of user actions will appear.
   
3. Select “Get OpenRC file” from the dropdown.
   
   
   
   The “Get OpenRC file” window will open.
   
4. In the “Get OpenRC file” dialog, click the “Type” dropdown.
   
5. Choose “Password Type”.
   
6. Click “OK”.
   
   
   
   A save dialog will appear.
   
7. Save the OpenRC file locally.

Important: This file contains credentials required to connect to your infrastructure and must be kept confidential.

III. Creating the Configuration File for Authentication

Terraform configuration files (.tf) must be UTF-8 encoded in HCL format. Use a plain-text editor supporting UTF-8, for example:

• Windows: VS Code, Notepad++, Sublime Text, IntelliJ IDEA
  
• macOS: VS Code, Sublime Text, IntelliJ IDEA, Vim, Nano
  
• Linux: VS Code, Sublime Text, IntelliJ IDEA, Vim, Nano, Gedit, Kate

Do not use: office editors (Word, LibreOffice, WordPad, Google Docs) as they save files in incompatible formats.

1. Create a directory for your Terraform configurations.
   
2. Create a file with the “.tf” extension, for example, “main.tf”.
   
3. Add the following HCL structure:
   

   		
   
   			
   				
   			
   		
   		terraform {
     required_version = ">= 0.14.0"
     required_providers {
       openstack = {
         source  = "terraform-provider-openstack/openstack"
         version = "~> 1.53.0"
       }
     }
   }
   
   provider "openstack" {
     user_name   = "<user_name>"
     password    = "<password>"
     auth_url    = "https://cli.peerobyte.com:5000/v3/"
     region      = "RegionOne"
     domain_name = "<domain_name>"
     tenant_name = "<tenant_name>"
   }
   	

4. Open the OpenRC file downloaded in Section II.
   
5. Replace the placeholder values in angle brackets <...> with the actual values for your project, excluding the brackets themselves, for the following parameters:
   1. password – the password obtained in Section I.
      
   2. user_name –  set to the “OS_USERNAME” value from the OpenRC file.
      
   3. domain_name – set to the “OS_USER_DOMAIN_NAME” value from the OpenRC file obtained in Section II.
      
   4. tenant_name – set to the “OS_PROJECT_NAME” value from the OpenRC file.

Example result: 

		

			
				
			
		
		terraform {
  required_version = ">= 0.14.0"
  required_providers {    openstack = {
      source  = "terraform-provider-openstack/openstack"
      version = "~> 1.53.0"    }
  }
}

provider "openstack" {
  user_name           = "quofcquo"
  password            = "5pi81Xd5pi"
  auth_url            = "https://cli.peerobyte.com:5000/v3/"
  region              = "RegionOne"
  domain_name         = "my-domain-31-705-731-1746522131"
  tenant_name         = "my-project-31-705-731"
}
	

6. Save the configuration file.

IV. Checking Authentication 

Ensure that the credentials you have entered are correct and that Terraform can manage the Peerobyte cloud infrastructure. To verify authentication, connect to the cloud and request the project ID – successfully obtaining the identifier indicates that authentication was successful.

To verify authentication, perform the following steps:

1. Open your configuration file for editing.
   
2. Add these blocks to retrieve and output your project ID:
   

   		
   
   			
   				
   			
   		
   		# Retrieve data about the existing project in Identity v3 by name
   data "openstack_identity_project_v3" "current" {
     name = "<project_name>"  # OS_PROJECT_NAME from the OpenRC file
   }
   
   # Output the found project IDoutput "project_id" {
     value = data.openstack_identity_project_v3.current.id  # Unique project identifier
   }
   	

3. Specify the value of the “name” parameter by replacing the <project_name> placeholder with the “OS_PROJECT_NAME” value from your OpenRC file.
   
4. Save the changes to the configuration file.

5. Open a terminal (Windows: PowerShell or CMD; macOS/Linux: Bash, Zsh, etc.).
   
6. Navigate to your configuration directory, e.g.:
   

   Linux/macOS:
   

   		
   
   			
   				
   			
   		
   		cd /home/user/terraform/conf
   	

   Windows (PowerShell/CMD):
   

   		
   
   			
   				
   			
   		
   		cd "C:\Program Files\terraform\conf"
   	

7. Initialize Terraform:
   

   		
   
   			
   				
   			
   		
   		terraform init
   	

   You should see:
   

   		
   
   			
   				
   			
   		
   		Terraform has been successfully initialized!
   	

8. Run the plan to verify authentication:
   

   		
   
   			
   				
   			
   		
   		terraform plan
   	

   On success, you’ll see your project’s unique ID, e.g.:
   

   		
   
   			
   				
   			
   		
   		project_id = "e905701a98324d3398b5365707905701"
   	

9. Remove the blocks added in step 2 (they are only needed for verification) and save your changes.

What’s Next?

You can now build out your cloud infrastructure by following the examples in the “Quick Start with Terraform".