Atlas Docs

API Credentials

Properties1
descriptionShows how to obtain Atlas Cloud API credentials for use with Terraform and CLI tools.

2 min read

Overview

Get your Atlas Cloud API credentials to use with Terraform, CLI tools, or programmatic access.

Step 1: Log In

Go to sky.runatlas.is and log in with your account.

Step 2: Access Profile Settings

Click your profile icon in the top-right corner of the dashboard.

Step 3: Generate API Keys

  1. Look for the API Keys section
  2. The keys appear in your user card. If none exist, use the control to generate new API and Secret keys

Atlas User and Atlas ReadOnly accounts need an Atlas Admin

Generating and viewing API keys is an Atlas Admin action. An Atlas User or Atlas ReadOnly account cannot generate or read its own keys; the control returns an error. An Atlas Admin in the account’s domain generates the keys for that account and hands them over. The same applies to object-storage keys. See Create a new user for account roles.

Step 4: Copy Credentials

Copy both values:

CredentialUsed For
API KeyUsername in API calls
Secret KeyPassword in API calls

Security

Store these securely! They provide full access to your account.

Using with Terraform

Add to your terraform.tfvars:

cloudstack_api_url    = "https://sky.runatlas.is/client/api"
cloudstack_api_key    = "your-api-key-here"
cloudstack_secret_key = "your-secret-key-here"

Using with cmk CLI

Set environment variables:

export CLOUDSTACK_API="https://sky.runatlas.is/client/api"
export CLOUDSTACK_API_KEY="your-api-key-here"
export CLOUDSTACK_SECRET_KEY="your-secret-key-here"

Regenerating Keys

If your keys are compromised or you need to rotate them:

  1. Go to your profile
  2. Use the regenerate control in the API Keys section
  3. Copy the new keys immediately
  4. Update all your scripts/configs

Rotate When Ready

Regenerate keys only when you are ready to update every client that uses them, so your automation keeps working with the current credentials.

Backlinks