Integrating Identity Federation for AWS

Identity Federation for AWS is an Amazon Web Services (AWS) integration app that provides Temporary AWS Security Credentials via a REST API – this is a brief guide for developers who want to use AWS services from their own Atlassian apps and integrate the shared AWS credentials management provided by Identity Federation for AWS.

Getting started

The Identity Federation for AWS REST API is based on open standards, so you can use any web development language or command line tool capable of generating an HTTP request to access the API, e.g. the popular cURL (a CLI tool for transferring data with URL syntax) or the highly recommended HTTPie (a CLI, cURL-like tool for humans). All resources can be used like the regular Jira Server REST APIs (or Bitbucket Server REST API, see info below):

 

REST API Browser

The easiest way to explore and experiment with the Identity Federation for AWS API is by means of the Atlassian REST API Browser, simply select the Identity Federation for AWS resources.

 

Structure of the REST URIs

The Identity Federation for AWS REST API provides access to resources (data entities) via URI paths. To use the REST API, your application will make an HTTP request and parse the response. The Identity Federation for AWS REST API uses JSON as its communication format, and the standard HTTP methods like GET, PUT, POST and DELETE. URIs for Identity Federation for AWS REST API resources are keyed by the app namespace and have the following structure:

1 http://host:port/context/rest/identity-federation-for-aws/2.1

 

Frequently Asked Questions (FAQ)