Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated to release 2.6.0.
Excerpt

In order to enable access to your AWS resources, you need to create at least one AWS Connector. You can access this functionality via the AWS Connectors configuration screen.

Image Removed

Image Added

Panel
borderColor#bbb
bgColor#eeeeee

On this page:

Table of Contents
maxLevel2
exclude(Popular.*|Recent.*)

Panel
borderColor#bbb
bgColor#eeeeee

Related pages:

AWS Security Credentials Variations

The add-on currently supports the following Principal Types:

Info
titleCapabilities and Restrictions

Each Principal Type has different capabilities and restrictions regarding credential lifetime, 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 details.

Principal TypeAWS DocumentationAPI actionCredential lifetime (min/max/default)Notes(tick)Federated UserTemporary Security Credentials to Enable Access for Federated UsersGetFederationToken

IAM user: 15m/36hr/12hr

Root account: 15m/1hr/1hr

(tick)Assume RoleTemporary Security Credentials for Delegating API AccessAssumeRole15m/1hr/1hr(tick)IAM UserTemporary Security Credentials to Enable Access for IAM UsersGetSessionToken

IAM user: 15m/36hr/12hr

Root account: 15m/1hr/1hr

(error)SAML FederationTemporary Security Credentials for SAML FederationAssumeRoleWithSAML15m/1hr/1hrSupport for SAML is not on our roadmap, see the resp. FAQ for detailsCreate/Edit Connector

Configuration

To configure an AWS Connector:

  1. Navigate to the Identity Federation for AWS configuration.
  2. Click Edit for an existing AWS Connector, or click Create Connectorconnector to create a new one.

Image Removed

Complete the following settings:

Account (IAM User) CredentialsSelect the long-term AWS security credentials to derive temporary AWS security credentials from - see also add/edit accounts belowrefer to Configuring an AWS Access Key for details.
Connector Name

Specify a custom name to identify this connector.

Principal Type

Select one of the supported principal types:

Info
titleCapabilities and Restrictions

Each principal type has different capabilities and restrictions regarding credential lifetime, 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 details.

Include Page
_PrincipalTypesTable
_PrincipalTypesTable

IAM Policy(Conditional) Specify an IAM Policy (supported for principal types Federated User and Assume Role)
  • (lightbulb) 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.
Maximum Duration

(Optional) Set the maximum number of seconds temporary credentials based on this connector can be valid - leave empty to use the AWS default valuescredential lifetime (refer to table Principal Types above for details).

Groups
(Optional) Grant the permission to use this Connector to one or more of your JIRA or Bamboo groups:

Image Modified

Info

Administrators always have permission to use all Connectors.

  1. click into the selection box to search for groups
    • (info) Bamboo < 5.6 and JIRA < 6.2 feature a different user interface for group selection still, see 
      Jira Legacy
      serverJIRA (utoolity.atlassian.net)
      columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
      serverIdfac61c2e-db0a-39da-bb3c-e0dc0ef556f0
      keyUAA-89
       for details.
  2. start typing to narrow down the selection

    Info
    titlePerformance with more than 100 groups

    If there are more than 100 groups, you need to type at least one character to make all matching groups appear.

    (warning) Depending on the number of groups and naming scheme paired with browser and system performance, frequently used characters like 'e' might still yield slightly sluggish behavior - typing quickly should circumvent such sluggishness, if any!

  3. select each desired group

    • (warning) all changes persist on save of the connector only

Scope(Optional) Select System Scope to allow usage of this AWS Connector from elevated code without an active user session (e.g. by other add-ons like Tasks for AWS and Automation with AWS).

Add/Edit Account

In order to create AWS Connectors, you need to add 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 IAM users for getting started this approach.
Info
titleRequired IAM Permissions
The Federated User and Assume Role principal types require Permissions to Create Temporary Credentials - see the Principal Types table above for details.

To configure an Account (IAM User):

  • Navigate to the Identity Federation for AWS configuration.
  • Click Edit for an existing Connector, or click Create Connector to create a new one.Click Edit for an existing Account (IAM User
    )
    , or click Add Account to create a new one.

    Image Removed

    Complete the following settings:

    Account NameSpecify a custom name to identify this account.
    Access Key ID

    Provide the Access Key ID of your long-term AWS Security Credentials.

    Secret Access Key
    Provide the Secret Access Key of your long term AWS Security Credentials.

    How-to Articles

    Filter by label (Content by label)
    max8
    showSpacefalse
    sorttitle
    excerptTypesimple
    cqllabel = "administration" and label in ("kb-how-to-article","kb-troubleshooting-article") and label = "identity-federation-for-aws" and label = "connector"

    Frequently Asked Questions (FAQ)

    Questionslist macro
    filterpopular
    asktrue
    limit8
    topicidentity-federation-for-aws,connector