1. Set up credentials
- Go the settings page of AWS Widgets at https://yourdomain.atlassian.net/wiki/plugins/servlet/upm.
- Put in your access key and secret key and click "Save".
IMPORTANT SECURITY INFORMATION
This application uses AWS SDK for Browser to fetch information of your resources. In other words, it is the user's browser that makes the network request to the AWS APIs.
Therefore credentials that required to access the AWS APIs need to be made available to the browser. The credentials are stored with your Confluence instance. When AWS SDK make requests, the Macro load the credentials and use that to sign the requests. So the credentials is not transmitted via network.
Our recommendation is to use credentials that grant only the minimum access. In all cases, a read-only access to the resource is sufficient. You can also limit it to only having permissions to access only part of your resources.
To summarise:
- Credentials are stored within your confluence instance and are used to sign the request sent to AWS.
- Credentials will be made available to the AWS SDK running in the browser, so it is possible to access them from the browsers developer tools.
- Credentials is not sent to any third party (including AWS server, AWS Widgets server).
- Make sure to use least privileged permissions (readonly).
2. Add a Widget to your page
- Click the far-right "+" icon to add the AWS Widgets macro to the page.
- Input the "ARN or Resource ID".
- Click Describe.
On this page:
3. View the Widget on your page
When the page is published, anyone with the reading permission will be able to see the live status of the resource.
0 Comments