Skip to content
Listing Your Access

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 profiles

Each 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 Viewer

Note: Your profile names will differ from the examples above. Use the output of pybritive ls profiles to 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-out

This 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 applications

List secrets

To see secrets your identity has access to:

pybritive ls secrets

Change 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 json

YAML:

pybritive ls profiles --format yaml

Table:

pybritive ls profiles --format table

The --format flag works the same way across all ls subcommands.

Troubleshoot

SymptomCauseFix
No profiles returnedNo profiles assigned to your accountContact your Britive administrator
No secrets returnedNo secrets assigned to your accountContact your Britive administrator
Not authenticated errorSession expiredRun pybritive login and try again

Next Steps

Last updated on