Skip to content

Commit

Permalink
Merge pull request #1513 from ngdo-pro/fix-aws-access-keys-creation-d…
Browse files Browse the repository at this point in the history
…ocumentation
  • Loading branch information
mnapoli authored Apr 25, 2023
2 parents 9446c60 + f87d52a commit dabfd14
Show file tree
Hide file tree
Showing 7 changed files with 20 additions and 4 deletions.
Binary file modified docs/installation/aws-keys-step-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/installation/aws-keys-step-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/installation/aws-keys-step-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/installation/aws-keys-step-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/installation/aws-keys-step-5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/installation/aws-keys-step-6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 20 additions & 4 deletions docs/installation/aws-keys.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,20 +5,36 @@ introduction: How to create AWS access keys for Bref.

To create AWS access key for Bref and the `serverless` CLI tool follow these steps:

1. In the AWS dashboard, go into IAM and create a new user: [**click here** for a direct link](https://console.aws.amazon.com/iam/home?#/users$new?step=details).
1. In the AWS dashboard, go into IAM and create a new user: [**click here** for a direct link](https://us-east-1.console.aws.amazon.com/iamv2/home#/users/create).

1. Set a user name (for example "bref-cli"), enable **Programmatic access** and move to the next screen.
1. Set a user name (for example "bref-cli") and move to the next screen.

![](aws-keys-step-1.png)

1. Click **Attach existing policies directly**, search for **AdministratorAccess** and select it.
1. Click **Attach policies directly**, search for **AdministratorAccess** and select it.

![](aws-keys-step-2.png)

> **Warning**: the "AdministratorAccess" policy grants full access to your AWS account. This is simpler when starting with AWS and Bref. However, it is recommended to restrict permissions further eventually.
>
> The Serverless documentation has an example of a configuration with stricter permissions: [read this article to create a more secure policy](https://serverless.com/framework/docs/providers/aws/guide/credentials/#creating-aws-access-keys).
1. Finish creating the user and **note the AWS access keys** that are generated.
1. Finish creating the user.

1. Once your user is created, select it and go to **Security credentials**.

![](aws-keys-step-3.png)

1. Scroll down to **Access Keys** and click on **Create access key**.

![](aws-keys-step-4.png)

1. Then select **Command Line Interface**.

![](aws-keys-step-5.png)

1. Add a description to your access keys and click on **Create access key**.

![](aws-keys-step-6.png)

[< Back to the installation guide](/docs/installation.md)

0 comments on commit dabfd14

Please sign in to comment.