Credential Management
Secure and efficient credential management is essential for reliable access to external services. The platform makes this easy by allowing users to store, manage, and update credentials for various services such as Docker registries, Amazon S3, Google Cloud Storage, and Azure Blob Storage.
1- What are Credentials ?
Credentials in the Aether platform enable secure connections to external services, 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- Access to credentials Dashboard
To access and manage credentials, you must have the appropriate user role:
Manager Role: Required for managing credentials in a company
Steps to Access the Dashboard
- Navigate to the Administration menu in the left sidebar
- Click on Credentials
The Credential Dashboard will open, displaying all credentials you manage
Dashboard Columns:
- Name: Name of the credential
- Labels: Tags used for categorization
- Company: company of the credential
- Edited by: last user to update the credential
- Edition date: date of the last update
3- Create New Credential
To create a new credential, click on “CREATE” button in the Dashboard
Enter Basic Information
- Enter a Credential Name
- Select the Company the credential belongs to
Enter Credential details
Credentials are the required parameters used to authenticate and connect to an external service.
Credentials should be entered in JSON format and must contain all required fields based on the service you're connecting to.
Examples by service:
| Service | Credential definition with required parameters |
| Docker Registry |
{
"registry": "<your-registry>",
"login": "<your-login>",
"password": "<your-password>"
}
|
| S3 | {
"bucket": "s3://<your-bucket>",
"aws_access_key_id": "<your-access-key>",
"aws_secret_access_key": "<your-secret>",
"aws_region": "<aws-region>"
}
|
| Azure blob | {
"account_url": "<your-account-url>",
"azure_client_id": "<your-client-id>",
"azure_tenant_id": "<your-tenant-id>",
"azure_client_secret": "<your-client-secret>"
}
|
| Google Cloud Storage | {
"project_id": "<your-project-id>",
"private_key": "<your-private-key>",
"client_email": "<your-email>",
"token_uri": "<your-tocken-uri>",
"bucket": "<your-bucket>"
}
|
Warning
For security reasons, credentials are not visible after saving.
Add Labels (Optional)
Labels help categorize credentials without impacting functionality.
- Click Add to input a label name and value
Save
- Click Save to create the credential. It will appear in the dashboard list.
4- Edit a Credential
To update an existing credential:
- Click on the Edit Credentials menu from the dashboard
- You can update both the Credential Details and Labels
Edit Credential details
- Click on “Set Credential” to update Credentials details
- Add new credential parameters.
Warning
Updating the credential will overwrite the existing one.
Edit Labels
- Update existing labels
- Add new labels
- Remove labels no longer needed
5- Delete a Credential
To delete a credential:
- Use the “Delete Credentials” menu
- Confirm the deletion
The credential will be permanently removed from the dashboard
