- Website: https://saml.to
- Forums: https://github.com/saml-to/vscode/discussions
- Documentation: https://docs.saml.to
This is the VSCode Extension for SAML.to. It allows for AWS role assumption within VSCode.
- Assume AWS Roles in VSCode
- Automatic Refreshes
- Automatically update
~/.aws/config
and~/.aws/credentials
with:AWS_ACCESS_KEY_ID
,AWS_SECRET_ACCESS_KEY
andAWS_SESSION_TOKEN
- Works seamlessly with the AWS Toolkit
Please make sure the following is installed:
- VSCode 1.84+
Then, install the VSCode Extension from the VSCode Marketplace.
Once the VSCode Extension is installed, run the following commands to login and assume roles:
- Open the Command Palette (
Cmd/Ctrl
+Shift
+P
) - Choose
SAML.to: Assume AWS Role
If no logins or roles are available, an administrator for an AWS account should complete the initial setup.
Add the --help
flag to any command for available options.
github.token
: Provide a GitHub Token instead of using VSCode Authentication. This token requires theuser:email
scope. (Overridden by theGITHUB_TOKEN
environment variable.)assumeAws.assumeRoleAtStartup
: Automatically attempt to assume a role at startup. IfassumeAws.role
orassumeAws.rememberRole
is set, the role prompt will be skipped.assumeAws.autoRefresh
: Automatically refresh the credentials before they expire.assumeAws.region
: The AWS Default Region to set after assuming a role. (Overridden by theAWS_DEFAULT_REGION
environment variable.)assumeAws.role
: Skip role selection input and assume this role. (Overridden by theAWS_ROLE_ARN
environment variable.)assumeAws.rememberRole
: Skip role selection input and assume the last role used. This is ignored when theassumeAws.role
setting is set.assumeAws.profile.name
: Save AWS Credentials to a named profile in~/.aws/config
. (Overridden by theAWS_PROFILE
environment variable.)
Visit SAML.to Install to get started by connecting a GitHub User or Organization to an AWS Account.
Please Open a New Issue in GitHub if an issue is found with this tool.