Credentials Management with CLI

1. Description

Credentials in the Aether platform enable secure connections to external services and resources, including:

  • Docker registries
  • Cloud storage services (S3, Google cloud storage, azure blob)

By managing credentials through Aether, users can:

  • Securely store authentication information
  • Configure access to multiple external services
  • Quickly update and rotate credentials
  • Maintain granular control over service connections

2. Prerequisites

  • Alteia CLI installed (version ≥ alteia-cli 1.11.0)
  • Required authentication details for the target service (e.g., Docker registry credentials, S3 access keys)

3. Create your credential

step 1 : Prepare Credentials JSON File

Example of credential

{
    "name": "YourCredentialName",
    "company": "YourCompany",
    "credentials": {
        "Credential-param1": "Credential-param1-value",
        "Credential-param2": "Credential-param2-value"
    },
    "labels": {
        "label1": "label1-value"
    }
}

The Credential section specify the required parameters based on the service:

  • Docker Registry
    •  “registry”, “login” and “password”
  • S3 credential
    • “bucket”, “aws_access_key_id”, “aws_secret_access_key” and “aws_region”
  • Azure Blob
    •  “account_url”, “azure_client_id”, “azure_tenant_id” and “azure_client_secret”
  • Google Cloud Storage
    •  “project_id”, “private_key”, “client_email”, “token_uri” and “bucket”

The Label section allows you to add custom metadata (e.g., descriptions or usage notes) to help you easily identify and manage your credentials later.

step 2 : create credentials

Run the following command:

alteia credentials create --filepath [credentials-file.json] --company [company-id]

step 3 : verify the creation of your credential 

List all credentials to confirm that yours has been successfully created:

 alteia credentials list --filepath [credentials-file.json] --company [company-id]

4. Update Credentials Details

Step 1 : Modify the credentials section in JSON file:

{
    "Credential-param1": "Credential-param1-value",
    "Credential-param2": "Credential-param2-value"
}

Step 2 : Update the credentials section

alteia credentials set-credentials [credential-name] --filepath [credentials-file.json] --company [company-id]

5. Update Labels

Step 1 : Modify the labels section in JSON file:

{
    "label1": "label1-value",
    "label2": "label2-value"
}

Step 2 : Update the credentials section

alteia credentials set-labels [credential-name] --filepath [labels-file.json] --company [company-id]

6. Delete your credentials

Remove a credential using the following command:

alteia credentials delete [credential-name] --company [company-id]

7. Notes

  • Replace placeholders (e.g., [credential-name], [company-id]) with your actual values
  • Ensure you have the necessary permissions to manage credentials
  • Keep credential files secure and do not share them


Knowledge Base Software powered by Helpjuice