After completing this guide, your Amazon load balancer will work with the AWS ALB & Amazon Cognito Authentication app.

If you want to create users during login based on the JWT sent by your load balancer or setup UserSync to connector via your identity provider, please see User Provisioning.


This guide assumes the following:

  • You have set up a Jira or Confluence instance on AWS with an ALB or ELB load balancer
  • You have set up either Amazon Cognito or OIDC with your load balancer
  • A GSuite subscription
  • A (trial) subscription for the AWS ALB Auth app
  • Admin access to your Atlassian product and AWS


  1. Go to the AWS ALB & Amazon Cognito Authentication configuration and choose the GSuite preset.

  2. This tutorial assumes that the username is sent in the x-amzn-oidc-data header via a claim called email. If that does not matches your setup, you can change the used header token via the Token Header Name option and the Username Claim.
    Preset Token Names

  3. This app automatically checks the signature of the x-amzn-oidc-data token. You must also enter the Issuer and the Amazon Ressource Name. To know where to find them please follow the instructions below.

    The Issuer can be found in the OIDC settings in your load balancer authentication rule.

    The ARN can be found in the Description tab of your Load Balancer in AWS.

  4. Finally, click Save to save the configuration.