...
| width | 64% |
|---|
...
...
| width | 32% |
|---|
...
AWS Security Credentials Variations
The add-on currently supports the following Principal Types:
| Info | ||
|---|---|---|
| ||
Each Principal Type has different capabilities and restrictions regarding Single Sign-On (SSO) to the AWS Management Console, Multi-Factor Authentication (MFA) and calling the IAM and STS APIs in turn, see Comparing Features of AWS STS APIs for more details. |
| Principal Type | AWS Documentation | API action | Notes | |
|---|---|---|---|---|
 | Federated User | Temporary Security Credentials to Enable Access for Federated Users | GetFederationToken | |
| IAM User | Temporary Security Credentials to Enable Access for IAM Users | GetSessionToken | |
| IAM Role | Temporary Security Credentials for Delegating API Access | AssumeRole |
|
 | SAML Federation | Temporary Security Credentials for SAML Federation | AssumeRoleWithSAML | Support for SAML is not on our roadmap, see the resp. FAQ for details |
AWS Connector Management
Create Connector
In order to enable the desired access to your AWS resources, you need to create at least one AWS Connector. You can access this functionality via the AWS Connectors management screen:
Create/Edit Connector
Clicking Create Connector (or Edit later on) opens the Edit AWS Connector dialog:
Here are the required steps:
...
Choose the Principal Type - there are two choices currently:
...
...
(Optional) Grant the permission to use this Connector to one or more of your JIRA or Bamboo groups
| Info |
|---|
| Administrators always have permission to use all Connectors. |
...
Add/Edit Account
In order to create AWS Connectors, you need to add the at least one account resp. IAM User, which provides the required long-term AWS security credentials used to derive temporary AWS security credentials for your Atlassian users, see Create individual users for getting started with this approach.
| Note | ||
|---|---|---|
| ||
| In order to use the Federated User or Assume Role principal types, you need to Grant an IAM Group Permission to Create Temporary Credentials! See the Principal Types table above for details. |
Accounts are added/edited/deleted inline while creating/editing an AWS Connector. All fields are required, you can select an arbitrary name according to your needs.
| Info |
|---|
| Editing an existing account will change it for all AWS Connectors using it. |
Clicking Create Account (or Edit later on) opens the Edit Account (IAM User) dialog:
Configuring an AWS Connector with (optional) IAM Policy and Atlassian user group selection
Once you have added at least one account (see above) you can configure an arbitrary number of AWS Connectors using these. A Connector requires an arbitrary name according to your needs, the account to use and an (optional) IAM Policy, see Overview of Policies. You can reuse existing policies already in use in your organization or create new policies tailored to your use case via the AWS Policy Generator.
While not required, you might want to grant one or more of your Atlassian user groups the permission to use the AWS Connector (if no group is selected, only administrators will be able to use it).
IAM Policy Examples
Clicking on 'IAM Policy Examples' allows you to select from a few example policies to ease getting started (just click one to copy it to the policy field) - links to the AWS Policy Generator and the IAM Policy Simulator are also provided:
...
Administration
Maintaining the Add-on
The following topics are applicable to regular add-on maintenance:
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|
Managing AWS Resources
The following topics are applicable to AWS resource management:
| Filter by label (Content by label) | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Configuring Advanced Scenarios
The following topics are applicable to advanced scenarios only:
| Filter by label (Content by label) | ||||||||
|---|---|---|---|---|---|---|---|---|
|
How-to Articles
| Filter by label (Content by label) | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Frequently Asked Questions (FAQ)
| Questionslist macro | ||||||||
|---|---|---|---|---|---|---|---|---|
|