REST API v1 resources (Identity Federation)
| Note |
|---|
|
The REST API v1 is deprecated, please use the REST API v2 for future developments:  the REST API v1 remains supported in Identity Federation for AWS 2.x and will be removed once a REST API v3 will be published the Marketplace enforced split of the add-on into dedicated ones per Atlassian application required us to change the base path for the REST API v1 resources from /rest/identity-federation-for-aws/1.0 to /rest/identity-federation-for-aws/1.0 in Identity Federation for AWS 2.x (Identity Federation for AWS 1.x remains unchanged) - please ensure to adjust this in case you need to keep existing v1 clients working with Identity Federation for AWS 2.x
|
This is the reference of all resources relevant to this add-ons actual functionality as a token vendor for Identity Federation - please see the REST API resources (complete reference) if you intent to include this add-on into administrative automation scenarios (e.g. for scripting).
| Resource | URI template | methods | description | permissions | comments |
|---|
| Connectors | | | | |  This is the main resource to interact with currently in order to retrieve temporary AWS security credentials. |
| | /connectors | GET | Get all AWS connectors. | Configurable | |
| | /connectors/{id} | GET | Get an AWS connector identified by its id. | Configurable | . |
| | /connectors/{id}/credentials | GET | Get the temporary AWS security credentials via a AWS connector identified by its id. | Configurable |  This is the main resource to use for calling AWS services in turn. |
| Panel |
|---|
/rest/identity-federation-for-aws/1.0/connectorsMethodsGET| Code Block |
|---|
| theme | RDark |
|---|
| language | javascript |
|---|
| title | Request |
|---|
| GET http://host:port/context/rest/identity-federation-for-aws/1.0/connectors (200) |
| Code Block |
|---|
| theme | RDark |
|---|
| language | javascript |
|---|
| title | Response Headers |
|---|
| collapse | true |
|---|
| Server: Apache-Coyote/1.1
X-AREQUESTID: 1384x1779x1
X-ASESSIONID: 1dteqyw
X-Seraph-LoginReason: OK
X-AUSERNAME: admin
Cache-Control: no-cache, no-store, no-transform
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 04 Jun 2013 21:04:32 GMT |
| Code Block |
|---|
| theme | RDark |
|---|
| language | javascript |
|---|
| title | Response Body |
|---|
| {
"values": [
{
"id": 1,
"id2": "1f2d5aee-839e-49ae-8a5b-e9ae27a2f2d8",
"name": "Development Team A",
"type": "FEDERATION_TOKEN"
},
{
"id": 2,
"id2": "1521fbf0-fa97-4c4a-9877-9f0c5e9982d3",
"name": "Development Team B",
"type": "SESSION_TOKEN"
},
{
"id": 3,
"id2": "bddc8430-cea7-4e09-98f6-354edcb841c4",
"name": "Operations Team",
"type": "FEDERATION_TOKEN"
}
],
"size": 3
} |
|
| Panel |
|---|
/rest/identity-federation-for-aws/1.0/connectors/{id}MethodsGET| Code Block |
|---|
| theme | RDark |
|---|
| language | javascript |
|---|
| title | Request |
|---|
| GET http://host:port/context/rest/identity-federation-for-aws/1.0/connectors/1 (200) |
| Code Block |
|---|
| theme | RDark |
|---|
| language | javascript |
|---|
| title | Response Headers |
|---|
| collapse | true |
|---|
| Server: Apache-Coyote/1.1
X-AREQUESTID: 1390x1780x1
X-ASESSIONID: 1dteqyw
X-Seraph-LoginReason: OK
X-AUSERNAME: admin
Cache-Control: no-cache, no-store, no-transform
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 04 Jun 2013 21:10:08 GMT |
| Code Block |
|---|
| theme | RDark |
|---|
| language | javascript |
|---|
| title | Response Body |
|---|
| {
"id": 1,
"id2": "1f2d5aee-839e-49ae-8a5b-e9ae27a2f2d8",
"name": "Development Team A",
"type": "FEDERATION_TOKEN"
} |
|
| Panel |
|---|
/rest/identity-federation-for-aws/1.0/connectors/{id}/credentialsMethodsGET| Code Block |
|---|
| theme | RDark |
|---|
| language | javascript |
|---|
| title | Request |
|---|
| GET http://host:port/context/rest/identity-federation-for-aws/1.0/connectors/1/credentials (200) |
| Code Block |
|---|
| theme | RDark |
|---|
| language | javascript |
|---|
| title | Response Headers |
|---|
| collapse | true |
|---|
| Server: Apache-Coyote/1.1
X-AREQUESTID: 1390x1782x1
X-ASESSIONID: 1dteqyw
X-Seraph-LoginReason: OK
X-AUSERNAME: admin
Cache-Control: no-cache, no-store, no-transform
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 04 Jun 2013 21:10:56 GMT |
| Code Block |
|---|
| theme | RDark |
|---|
| language | javascript |
|---|
| title | Response Body |
|---|
| {
"expiration": 1370423461000,
"sessionToken": "AQoDYXdzEN7//////////wEa8AEmChyr2gLDNxQATlASOWNkI0ORBVCkbPuMdTPQxpQR7NrqxjBo+O13lg2KjKdsxoXfR3fzCG/L0g9k2YQOMWVZjQLkd6cS4F3NL3qa/dtheXaYmcCeUXwJoznMWsXvGV3OQyizKD7hHcQbrYDzJWr1hcoksx03NazuG1xx6uWn8uwcktsyMCwATlasC8tqw6ffozllgQr2eZK1lBPyXWQy7Jwx3EyXLP/rulAhEBE9mrAUzp0xq0Yiekc7I06dSAQT7fBsuHzWoNQ0O8zmX4S35AL+pP+kBzAJZ75qvviNZYmoqXCBcSEOmWLFnyAuCSUg5a+5jQU=",
"accessKeyId": "ASIJATLAS2XBO2MQ77VQ",
"secretAccessKey": "FeJioaEdLa0RJsVCSBYAtLaskADEzkq1VFriuJla"
} |
|
...