# aws-saml-login

> A simple cli utility to get temporary AWS credentials via a SAML endpoint

Latest version **0.5.2** (published 2021-11-04) · ISC license · 0 weekly downloads

## Install

```sh
npm install aws-saml-login
pnpm add aws-saml-login
yarn add aws-saml-login
bun add aws-saml-login
```

Provides the command `aws-saml-login`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.5.2 |
| Published | 2021-11-04 |
| First published | 2019-06-18 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=10.12.0 |
| Dependencies | 6 |
| Unpacked size | 23 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Matt Aschmann |
| Maintainers | mattaschmann |

## Links

- npm: https://www.npmjs.com/package/aws-saml-login
- Repository: https://github.com/mattaschmann/aws-saml-login
- Homepage: https://github.com/mattaschmann/aws-saml-login#readme
- Issues: https://github.com/mattaschmann/aws-saml-login/issues
- npm.io page: https://npm.io/package/aws-saml-login

## Dependencies (6)

- [ini](https://npm.io/package/ini.md) 2.0.0
- [colors](https://npm.io/package/colors.md) 1.4.0
- [aws-sdk](https://npm.io/package/aws-sdk.md) 2.902.0
- [commander](https://npm.io/package/commander.md) 7.2.0
- [puppeteer](https://npm.io/package/puppeteer.md) 9.1.1
- [readline-sync](https://npm.io/package/readline-sync.md) 1.4.10

## Recent versions

- 0.5.2 (latest) — 2021-11-04
- 0.4.0 — 2021-05-07
- 0.3.3 — 2020-06-24
- 0.3.2 — 2019-12-16
- 0.3.1 — 2019-11-20
- 0.3.0 — 2019-09-30
- 0.2.1 — 2019-08-28
- 0.2.0 — 2019-08-13
- 0.1.1 — 2019-06-21
- 0.1.0 — 2019-06-21
- 0.0.2 — 2019-06-18
- 0.0.1 — 2019-06-18
- 0.0.0 — 2019-06-18

## README

## aws-saml-login
Utility to help with AWS credential management via SAML.  This uses puppeteer
and chromium to go to a user specified login url.  After following all redirects
and allowing the user to login, it will intercept the `SAMLResponse` and make a
call to Amazon STS to get temporary credentials.  These can then be used via the
[AWS profiles feature](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html).

## Install
```shell
$ npm install -g aws-saml-login
```

## Usage
```shell

Usage: aws-saml-login [options] <login_url>

A simple cli utility to get temporary AWS credentials via a SAML endpoint

Options:
  -V, --version                 output the version number
  -b, --basic_auth              use basic auth from the cli to login, this will run the browser in
                                headless mode
  -d, --duration <secs>         session duration in seconds (default: "3600")
  -p, --profile <profile_name>  default profile to use
  -r, --refresh <profile_name>  attempts to refresh an existing profile using config options saved
                                in "~/.config/aws-saml-login/config".  Will create the entry if it
                                does not exist.

  -a, --role_arn <role_arn>     role ARN to login as
  -h, --help                    display help for command

```

---
_Source: https://npm.io/package/aws-saml-login · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._