SSO Application

Last Updated

December 2022

Authors

  • Veaceslav Mindru, Sr. Technical Account Manager, AWS
  • Stephanie Gooch, Sr. Commercial Architect, AWS OPTICS

Introduction

Cloud Intelligence Dashboards (CID) helps you to visualize and understand AWS cost and usage data in your organization by exploring interactive dashboards. To simplify access for users you can now set up an SSO application for them to enter into. We recommend combining this with the Row Level Security customization to ensure they see the data they really matters to them.

Prerequisite

For this solution you must have the following:

  • Access to your AWS Organizations and ability to tag resources
  • An AWS Cost and Usage Reports (CUR) or if from the multiple payers these must be replicated into a bucket, more info here
  • A CID deployed over this CUR data, checkout the new single deployment method here.
  • A list of users and what level of access they require. This can be member accounts, organizational units (OU) or payers.
  • Enable IAM Identity Center

Step 1: Quicksight Check

  1. Login into your Cost Account where your CID is deployed and go into Amazon QuickSight Images/sso_sso_quicksight.png

  2. Select your CID and open it Images/sso_qs_dashboard.png

  3. On the top right click on the Share icon then Share Dashboard Images/sso_qs_share_button.png

  4. Share your CID Dashboard in Amazon QuickSight with all users by clicking on the toggle Everyone in this account Images/sso_qs_share.png

  5. Copy the Dashboard URL to somewhere local as we will use this later Images/sso_iic_qs_url.png

Step 2: Create Users and Group

  1. Open the IAM Identity Centre. Click on Groups on the left then Create group

  2. Under Group name, give the name CID then click Create group Images/sso_user_group.png

  3. Click on Users then Add user Images/sso_user_users.png

  4. Fill out the details using the same email that will be used for Amazon QuickSight. Click Next. Images/sso_user_user_email.png

  5. Click on the box next to the CID group you made earlier. Then Click Next. Images/sso_user_add_to_group.png

  6. Scroll down and click Add user

Step 3: IAM Identity Centre

  1. Open the IAM Identity Centre and select Applications on the left and Click Add application Images/sso_iic_add_app.png

  2. Search in Preintegrated applications for Amazon Quicksight then click Next Images/sso_iic_qs.png

  3. Type a Display name Billing Dashboard. Under IAM Identity Center metadata Download IAM Identity Center SAML metadata file. Images/sso_iic_config.png

  4. Under Application properties paste your CID Link under Relay state. Click Submit Images/sso_iic_qs_url.png

  5. Click into your application and slick Assign Users Images/sso_iic_assign.png

  6. Click on the Groups tab and select the CID group the click the Assign Users button Images/sso_iic_group.png

Step 4: Provider

note: This step is done in the target account where the CID lives, this may differ from the SSO account.

  1. Open IAM, on the left click Identity providers then click the Add provider button Images/sso_iam_provider.png

  2. Under Provider type choose SAML, give it the name QuickSightProvider then upload the SAML file you downloaded earlier using the Choose file button. Click Add provider Images/sso_iam_provider_saml.png

  3. Click into your new provider Images/sso_iam_provider_qs.png

  4. Click the button Assign role and choose Create a new role and click Next Images/sso_iam_provider_create_role.png

  5. Ensure SAML 2.0 federation is clicked at the top the click the Allow programmatic and AWS Management Console access radio button and click Next: Permissions Images/sso_iam_role_saml.png

  6. Click Create policy Images/sso_iam_policy.png

  7. Select the JSON tab and past in the below code replacing your ACCOUNT_ID with your CID account ID. Click Next:Tags

             {
                "Statement": [
                     {
                     "Action": [
                             "quicksight:CreateReader"
                     ],
                     "Effect": "Allow",
                     "Resource": [
                             "*"
                     ]
                     }
             ],
             "Version": "2012-10-17"
             }
    

Images/sso_policy_json.png

  1. Click through Next:Review

  2. For Name call it QuickSightSAMLPolicy then click Create Policy Images/sso_iam_policy_name.png

  3. Go back to previous IAM tab to attach permissions, refresh the list then search for QuickSightSAMLPolicy and click the tick box. Click Next:Tags, Next:Review Images/sso_iam_add_policy.png

  4. Provide a Role name as QuickSightSAMLRole and click Create role Images/sso_iam_role_name.png

  5. Search for your new role and click into it. Select the Trust relationships tab and click Edit trust policy Images/sso_iam_tr.png

  6. Replace the json with the below, replacing your ACCOUNT_ID with your CID account ID.

            {
            "Version": "2012-10-17",
            "Statement": [
                    {
                    "Effect": "Allow",
                    "Principal": {
                            "Federated": "arn:aws:iam::ACCOUNT_ID:saml-provider/QuickSightProvider"
                    },
                    "Action": "sts:AssumeRoleWithSAML",
                    "Condition": {
                            "StringEquals": {
                            "SAML:aud": "https://signin.aws.amazon.com/saml"
                            }
                    }
                    },
                    {
                    "Effect": "Allow",
                    "Principal": {
                            "Federated": "arn:aws:iam::ACCOUNT_ID:saml-provider/QuickSightProvider"
                    },
                    "Action": "sts:TagSession",
                    "Condition": {
                            "StringLike": {
                            "aws:RequestTag/Email": "*"
                            }
                    }
                    }
    
            ]
            }
    

Images/sso_iam_tp_edit.png

Update Attribute Mappings

  1. Return to your IAM Identity Center and find your Amazon Quicksight application for CID and click into it. Images/sso_iic_app.png

  2. Click the Actions button and select Edit attribute mapping Images/sso_iic_edit_mapping.png

  3. Add two new mappings by clicking on Add new attribute mapping, replacing your ACCOUNT_ID with your CID account ID

Images/sso_iic_mapping_update.png

  1. After this step is done, a new ICON will appear in SSO, give it 5 minutes to start