Skip to content

Profiles

Profiles are ObserverContexts — the identity, scope, and permission set under which Escher observes your cloud estate.


What a profile is

A profile is not a credential. It is Escher's representation of a cloud CLI configuration entry:

Profile: prod-admin
  Provider:     AWS
  Account:      123456789012
  Region:       us-east-1 (default)
  Source:       ~/.aws/credentials [prod-admin]
  Permissions:  ec2:Describe*, s3:List*, iam:Get*, ...
  Status:       Active

Escher discovers profiles from:

  • ~/.aws/credentials and ~/.aws/config (AWS)
  • az account list output (Azure)

Profile lifecycle

Discovered → Enabled → Active (scanning) → Disabled

                              Error (auth failure, insufficient permissions)
ActionDescription
DiscoverScan local CLI config for new profiles
EnableAllow the profile to participate in estate scans
Test AccessValidate credentials and check permissions
DisableExclude from scans without deleting
AnnotateAttach a local note (e.g. "prod read-only", "audit account")
View DiagnosticsSee specific API errors preventing full scan coverage

Multiple profiles, same account

You can enable multiple profiles for the same cloud account. This is useful for:

  • Validating least-privilege access (compare what audit-readonly sees vs prod-admin)
  • Covering different permission scopes (e.g. one profile for EC2/S3, another for IAM)

The EstateView merges observations across profiles and annotates which profile provided each resource.


Profile status meanings

StatusDescription
OKFull scan completed, all domains accessible
PARTIALSome service domains failed (insufficient permissions for those APIs)
ERRORAuthentication failed — credentials expired or invalid
DISCONNECTEDProfile was previously active but credentials can no longer be validated

Next steps

Escher — Agentic CloudOps by Tessell