# AWS: Managing Access to Identity Center Groups

In this tutorial, you'll learn how to configure [#grant-kits](https://docs.abbey.io/how-abbey-works/concepts#grant-kits "mention") to automate access requests to an AWS Identity Center Group by attaching AWS Identity Center Group Membership resources. This use case models Role-Based Access Control (RBAC) using AWS Identity Center Groups.

This example has two accounts and two groups; we model access to a Staging and a Production account. Here we have two groups: R\&D and Prod Access. Members of the R\&D groups are allowed full access to resources within the Staging account and read-only access to resources within the Production Account. Members of the Prod Access group are given full access to EC2 and S3 inside the Production Account.

We will be using Abbey to allow a user to request EC2 or S3 access to the Production account by being adding them to the Prod Access group.

## Before you start

1. **Make sure you have:**
   * An [Abbey account](https://app.abbey.so/sign-up)
   * An [Abbey API Token](https://docs.abbey.io/admin/managing-api-tokens#creating-new-api-tokens)
   * An AWS Identity Center instance with the [IAMFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/IAMFullAccess.html) policy
2. **Make sure you setup:**
   * An [AWS Identity Center Starter Kit](https://github.com/abbeylabs/abbey-starter-kit-aws-identity-center-groups) by following [get-a-starter-kit](https://docs.abbey.io/build-a-grant-kit/get-a-starter-kit "mention")
   * A Connection to a repo by following [connect-a-repo](https://docs.abbey.io/build-a-grant-kit/connect-a-repo "mention")

## Step 1: Create Accounts Resources

The starter kit has two example accounts, *Staging* and *Production*, to get you started.

{% code title="accounts.tf" %}

```diff
resource "aws_organizations_account" "staging" {
  name = "Staging"
-  email = "replace-me@example.com" #CHANGEME
+  email = "staging_owner@example.com" # Use the email of an account in Identity Center.
}

resource "aws_organizations_account" "production" {
  name = "Production"
-  email = "replace-me@example.com" #CHANGEME
+  email = "production_owner@example.com" # Use the email of an account in Identity Center.
}
```

{% endcode %}

## Step 2: Configure your Grant Kit

### Configure Output

Grant Kits rely on your GitHub account and repository name to output access changes, which we'll set through Terraform local variables. Update the `locals` block in `main.tf` with your `account_name` and `repo_name`

{% code title="main.tf" %}

```hcl
 locals {
  account_name = "" #CHANGEME
  repo_name = "" #CHANGEME
  ...
}
```

{% endcode %}

### Configure Reviewers

Workflow defines who should approve an access request. 

Let's update the `reviewers` block by adding yourself as the reviewer by switching `replace-me@example.com` with the email address you use to sign into Abbey. 

{% code title="main.tf" %}

```diff
 resource "abbey_grant_kit" "..." {
   ...
   workflow = {
     steps = [
       {
         reviewers = {
-          one_of = ["replace-me@example.com"] # CHANGEME
+          one_of = ["alice@example.com"]
```

{% endcode %}

## Step 3: Link AWS Identity Center with Abbey

Now you'll need to link [AWS Identity Center with Abbey](https://developers.abbey.io/#operation/createAppData). 

{% code title="" %}

```diff

curl -X POST \
  -H "Authorization: Bearer $ABBEY_API_TOKEN" \
  -H 'Content-Type: application/json' \
  https://api.abbey.io/v1/users/<user_id>/apps \
  -d '{"type": "aws_identitystore", "data": {"id": "<your AWS Identity Center user ID>"}}'
```

{% endcode %}

## Step 4: Deploy Your Starter Kit

First, add your GitHub-related secrets to your repo's repository secrets:

* `AWS_ACCESS_KEY_ID`
* `AWS_SECRET_ACCESS_KEY`
* `ABBEY_TOKEN`

You can find the AWS keys in your AWS account.

The ABBEY\_TOKEN is your API token.

<details>

<summary>What should it look like?</summary>

<img src="https://1502779850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FudoTqG501gLo2MLzBG55%2Fuploads%2FQA6aayAqyVGNOddwjo9c%2Fimage.png?alt=media&#x26;token=128e6ac8-b8ea-4e24-a682-9a497c1d6847" alt="" data-size="original">

</details>

To deploy your Starter Kit, follow instructions from [deploying-your-grant-kit](https://docs.abbey.io/build-a-grant-kit/deploying-your-grant-kit "mention").

## Step 5: Automate Access Management

:tada: Congratulations! Abbey is now managing permissions to your Resource for you. :tada:

You can now start requesting and approving access by following the [requesting-access](https://docs.abbey.io/build-a-grant-kit/requesting-access "mention") and [approving-or-denying-access-requests](https://docs.abbey.io/build-a-grant-kit/approving-or-denying-access-requests "mention") guides.

{% hint style="success" %}
Abbey strives to help you automate and secure access management without being intrusive.

To that end, this Pull Request contains native Terraform HCL code using normal open source Terraform Provider libraries. It represents the permissions change. In this case, it's just a simple creation of a new Terraform Resource.
{% endhint %}

After approving the request, you should be able to see that the Identity Center User has been added to the Group in the AWS Identity Center console, and that they have an associated AWS Identity Center Permission Set for the account where the assignment was made.

<figure><img src="https://1502779850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FudoTqG501gLo2MLzBG55%2Fuploads%2FC5ZzIYBRLg4RWtcngH8g%2FScreenshot%202023-09-17%20at%208.27.21%20PM.png?alt=media&#x26;token=02f2ca29-19d3-4de2-9e17-a6916aa411a8" alt=""><figcaption><p>Read-Only Access to the Production account for this user</p></figcaption></figure>

## Next Steps

To learn more about what [resources](https://docs.abbey.io/resources "mention") you can configure, try one of our [](https://docs.abbey.io/getting-started/tutorials "mention").

For more information on how Abbey works, visit the [concepts](https://docs.abbey.io/how-abbey-works/concepts "mention") or [grant-kits](https://docs.abbey.io/reference/grant-kits "mention") page.