SAML.to
Search
⌃K

list-roles

saml-to list-roles
The list-roles command is a command to list available Service Providers that have roles that can be assumed.

Usage

saml-to list-roles
Show roles that are available to assume
Options:
--version Show version number [boolean]
--help Show help [boolean]
--org Specify an organization [string]
--provider Specify a provider [string]
--refresh Refresh cached logins from source control [boolean] [default: false]

Options

--org

In the event you're a member of multiple organizations, you can filter the output for a specific organization with this flag.
E.g. npx saml-to list-roles --org stark-international

--provider

In the event you have a large list of providers, you can filter the output for a specific provider with this flag.
E.g. npx saml-to list-roles --provider aws-iam

--refresh

SAML.to performs some caching of available logins on the backend. In the event the outputted list seems out-of-sync with what should be available, add the --refresh flag to the command.
The refreshed output will appear as normal, but the command might take a few extra seconds to run while the cache on the backend is refreshed.
Note: The --org flag is required for a refresh
E.g. npx saml-to list-roles --org stark-international --refresh

Example Output

➜ ~ npx saml-to list-roles
npx: installed 1 in 3.071s
┌─────────┬───────────────────────────────────────────────┬───────────┬───────────────────────┐
│ (index) │ role │ provider │ org │
├─────────┼───────────────────────────────────────────────┼───────────┼───────────────────────┤
│ 0 │ 'arn:aws:iam::874599868815:role/iam-readonly' │ 'aws-iam' │ 'stark-international' │
└─────────┴───────────────────────────────────────────────┴───────────┴───────────────────────┘
➜ ~
➜ ~ npx saml-to list-roles --refresh --org stark-international
npx: installed 1 in 1.281s
┌─────────┬───────────────────────────────────────────────┬───────────┬───────────────────────┐
│ (index) │ role │ provider │ org │
├─────────┼───────────────────────────────────────────────┼───────────┼───────────────────────┤
│ 0 │ 'arn:aws:iam::874599868815:role/iam-readonly' │ 'aws-iam' │ 'stark-international' │
└─────────┴───────────────────────────────────────────────┴───────────┴───────────────────────┘
➜ ~
➜ ~ npx saml-to list-roles --refresh --org stark-international --provider aws-iam
npx: installed 1 in 1.242s
┌─────────┬───────────────────────────────────────────────┬───────────┬───────────────────────┐
│ (index) │ role │ provider │ org │
├─────────┼───────────────────────────────────────────────┼───────────┼───────────────────────┤
│ 0 │ 'arn:aws:iam::874599868815:role/iam-readonly' │ 'aws-iam' │ 'stark-international' │
└─────────┴───────────────────────────────────────────────┴───────────┴───────────────────────┘
➜ ~