Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Current »

1. Set up credentials

  • Go to Manage Apps  → upload.

  • In the local code repo, search` atlassian-connect.json` and change baseUrl to the url that ngrok generated for you and upload the url with /atlassian-connect.json in the end

  • 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.

Related pages

  • No labels