Managing Connections
Learn how to view, filter, validate, and delete your AWS connections.
Viewing Connections
Navigate to Connections > AWS to see all your AWS connections.
Connection Stats
At the top of the page, you'll see summary statistics:
| Stat | Description |
|---|---|
| Total Connections | Number of all AWS connections |
| Active | Connections that are validated and working |
| Organization-wide | Connections available to all sites |
| Site-specific | Connections scoped to individual sites |
| Security Issues | Number of least privilege issues found |
Connection Cards
Each connection displays as a card with:
- Connection Name — The name you assigned
- Status Badge — Current connection status
- Scope Badge — Organization-wide or Site-specific
- AWS Account ID — The 12-digit AWS account identifier
- Actions — Validate, View Details, Delete
Filtering Connections
Use the filter dropdowns to narrow down your connection list.
Filter by Status
| Status | Description |
|---|---|
| All Statuses | Show all connections |
| Active | Only validated, working connections |
| Pending | Connections awaiting validation |
| Invalid | Connections that failed validation |
Filter by Scope
| Scope | Description |
|---|---|
| All Connections | Show all scopes |
| Organization-wide | Only org-wide connections |
| Site-specific | Only site-scoped connections |
Connection Details Panel
Click View Details from the connection dropdown menu (or click on a connection card) to open the details panel.
Information Displayed
Quick Actions
From the details panel, you can:
- Copy Account ID — Click the copy button
- Copy Role ARN — Click the copy button
- Validate — Re-check the connection
- Delete — Remove the connection
Validating Connections
Validation checks if Orkestia can successfully use your AWS connection.
When to Validate
- After creating a new connection
- After modifying IAM role permissions
- If deployments are failing
- Periodically to ensure continued access
How to Validate
- Find the connection in the list
- Click the Validate button on the card
- Wait for validation to complete
What Validation Checks
Assume Role Test
Can Orkestia assume the IAM role?
Permission Check
Does the role have all required permissions?
Least Privilege Analysis
Are there overly permissive policies?
Validation Results
| Result | Meaning |
|---|---|
| Validation Passed | Connection is active and ready to use |
| Validation Failed | Check the error message for details |
| Passed with Warnings | Works but has security recommendations |
Deleting Connections
Remove an AWS connection when it's no longer needed.
Before Deleting
- No sites are actively using this connection
- You've migrated any dependent sites to another connection
- You have another valid connection if needed
How to Delete
- Click the dropdown menu (three dots) on the connection card
- Click Delete
- Confirm the deletion
Connection In Use
If you try to delete a connection that's being used by sites, you'll see an error:
Cannot delete connection: This connection is currently in use by 3 sites.
To resolve:
- Navigate to each site using this connection
- Change the site's AWS connection to another one
- Return and delete the original connection
After Deletion
To delete the IAM role:
Open IAM Console
Go to the AWS IAM Console.
Find the role
Navigate to Roles and find your Orkestia role.
Delete the role
Select the role and click Delete.
Connection Statuses Reference
| Status | Color | Description | Action |
|---|---|---|---|
| Active | Green | Connection is valid and ready | None needed |
| Pending | Yellow | Waiting for first validation | Click Validate |
| Invalid | Red | Validation failed | Check IAM role config |
| Suspended | Gray | Too many failed validations | Review and fix issues |