2020-02-18 19:14:54 +00:00
# Amazon Web Services Integration
## What is AWS
!!! note ""
Amazon Web Services (AWS) is the world’ s most comprehensive and broadly adopted cloud platform, offering over 175 fully featured services from data centers globally. Millions of customers—including the fastest-growing startups, largest enterprises, and leading government agencies—are using AWS to lower costs, become more agile, and innovate faster.
## Preparation
The following placeholders will be used:
2020-06-18 18:44:25 +00:00
- `passbook.company` is the FQDN of the passbook install.
2020-02-18 19:14:54 +00:00
2020-06-18 18:44:25 +00:00
Create an application in passbook and note the slug, as this will be used later. Create a SAML provider with the following parameters:
2020-02-18 19:14:54 +00:00
- ACS URL: `https://signin.aws.amazon.com/saml`
- Audience: `urn:amazon:webservices`
- Issuer: `passbook`
2020-06-18 18:44:25 +00:00
You can of course use a custom signing certificate, and adjust durations.
2020-02-18 19:14:54 +00:00
## AWS
2020-06-18 18:44:25 +00:00
Create a role with the permissions you desire, and note the ARN.
2020-02-18 19:14:54 +00:00
AWS requires two custom PropertyMappings; `Role` and `RoleSessionName` . Create them as following:
![](./property-mapping-role.png)
![](./property-mapping-role-session-name.png)
2020-06-18 18:44:25 +00:00
Afterwards export the metadata from passbook, and create an Identity Provider [here ](https://console.aws.amazon.com/iam/home#/providers ).