Listing Your Access
Overview
Before you can check out access, you need to know what is available to you. The pybritive ls command lists the profiles, applications, and secrets that your Britive administrator has assigned to your identity.
What you’ll learn:
- How to list your available profiles
- How to filter to currently checked-out profiles
- How to list applications and secrets
- How to change the output format
Before You Begin
- PyBritive installed and authenticated — see Getting Started
- At least one Resource or Application profile assigned to your account
List Your Access
List your profiles
Profiles are the core unit of access in Britive. Each profile grants temporary credentials to a cloud account, resource, or application.
pybritive ls profilesEach profile is displayed in the format Application Name/Environment Name/Profile Name. For example:
AWS SE Organization/696226360299 (se-demo)/S3 Bucket Admin
Britive Azure Tenant/Britive Azure Tenant/Subscription Owner
GCP - CIS/GCP - CIS/Big Query ViewerNote: Your profile names will differ from the examples above. Use the output of
pybritive ls profilesto find your exact profile names throughout these tutorials.
This is the profile identifier you will use with pybritive checkout in later tutorials.
Filter to checked-out profiles
To see only the profiles you currently have checked out:
pybritive ls profiles --checked-outThis is useful for confirming active sessions and knowing what access you need to check in.
List applications
To see the applications available to you:
pybritive ls applicationsList secrets
To see secrets your identity has access to:
pybritive ls secretsChange the output format
By default, PyBritive outputs results as a list. You can change the format using the --format flag.
JSON:
pybritive ls profiles --format jsonYAML:
pybritive ls profiles --format yamlTable:
pybritive ls profiles --format tableThe --format flag works the same way across all ls subcommands.
Troubleshoot
| Symptom | Cause | Fix |
|---|---|---|
| No profiles returned | No profiles assigned to your account | Contact your Britive administrator |
| No secrets returned | No secrets assigned to your account | Contact your Britive administrator |
Not authenticated error | Session expired | Run pybritive login and try again |
Next Steps
- Check Out and Check In — use a profile name from
ls profilesto request temporary credentials