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