Bombaat CLI - awscli / boto AWS API access using Azure Active Directory (AD) service.
Project description
BOMBAAT CLI
Azure Active Directory single sign-on (SSO) integration with Amazon Web Services CLI (AWS CLI / BOTO)
Bombaat CLI enables you to access AWS Cloud accounts via awscli/boto using Azure AD single sign on service
System Requirements
- Mac OSX or Linux
- Python3.6+
Prerequisite
NOTE: If you just want to test the tool, no need to follow the below steps. It installs default drivers and sample cloud profiles.
If you have plan to use it in your own environment, this installation requires to host set of configuration files somewhere on the network. (example: you can upload both the zip files to a S3 bucket and update s3 permissions to make it accessible via network)
Download the following files.
- https://bombaat.s3.ap-south-1.amazonaws.com/drivers.zip
- https://bombaat.s3.ap-south-1.amazonaws.com/profiles.zip
Unzip profiles.zip, update your cloud environment URLs and name, zip it back.
Installation
These steps are one time setup, which installs bombaat cli and required configuration files.
Step 1:
$ pip3 install bombaat
step 2:
Ignore this step, if you are not setting this tool in your own environment. Otherwise, run the following command to set the host where you have uploaded zip files as per the Prerequisite
step.
Please make sure you are providing hostname without forward slash. For example if you have hosted your zip files under https://example.com/drivers.zip or https://example.com/profiles.zip, just enter https://example.com
$ bombaat init
Step 3:
Download and install configuration files either from default host or from the host configured in step 2.
$ bombaat update all
Usage
Step 1: Configure cloud profile:
Before log in any AWS cloud account, you need to configure the same as it collects login info.
- Azure AD SSO Username - It should be your email ID
- Default - It can be set True or False. [If you set True, the profile becomes your default cloud account while using
awscli
orboto
. If you dont, it always be False.]
$ bombaat configure
You can always come back and run the bombaat configure
command to change the settings.
Step 2: To log in to a profile:
Profiles which you have configured in the previous step will be shown in login
command.
$ bombaat login
Help
To see help text:
$ bombaat --help
$ bombaat <command> --help
Compatibility
- Compatible with Mac OSX or Linux with python3.6 or higher version.
Requirements
- Azure AD SSO integration with Amazon Web Services. Follow this link to setup Azure SSO with AWS Console.
Authors
bombaat
was written byRavi Boodher<boodher@gmail.com>
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.