Metadata-Version: 2.4
Name: iamroles
Version: 1.2.0
Summary: Alias for rolesanywhere-onboard -- installs the `iamroles` command
Author: Viresh Solanki
License: MIT
Project-URL: Homepage, https://github.com/vireshsolanki/iam-roles-anywhere-automation
Project-URL: Issues, https://github.com/vireshsolanki/iam-roles-anywhere-automation/issues
Keywords: aws,iam-roles-anywhere,certificate-authority,x509,pki
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: rolesanywhere-onboard==1.2.0

# iamroles

This is an **alias package**. It contains no code — it just installs
[`rolesanywhere-onboard`](https://pypi.org/project/rolesanywhere-onboard/),
which is where everything actually lives.

It exists because the command is called `iamroles`, so `pip install iamroles`
is what people naturally type. This makes that work, and claims the name so
nobody else can publish something else under it.

```bash
pip install iamroles
```

Either package name gets you the same `iamroles` command:

```bash
iamroles --url <ApiEndpoint> --secret <ApiKeyValue> --name alice \
    --trust-anchor-arn <arn> --profile-arn <arn> --role-arn <arn> --days 365
```

**Full documentation:**
[rolesanywhere-onboard](https://pypi.org/project/rolesanywhere-onboard/) ·
[GitHub](https://github.com/vireshsolanki/iam-roles-anywhere-automation)

## What it does

Onboards a developer against a self-hosted AWS IAM Roles Anywhere Certificate
Authority: generates an RSA keypair locally (the private key never leaves the
machine), requests a signed certificate over HTTPS, and writes an AWS CLI
profile backed by `aws_signing_helper` — so `aws s3 ls` just works, with
short-lived credentials and no static access keys anywhere.

Needs Python 3.8+ and nothing else. No AWS account, no `aws` CLI, no `openssl`.
Linux, macOS, and Windows.

## License

MIT
