@@ -22,6 +22,7 @@ Valid providers are :
2222- [DigitalOcean](#digitalocean-auth-provider)
2323- [Bitbucket](#bitbucket-auth-provider)
2424- [Gitea](#gitea-auth-provider)
25+- [Atlassian Cloud](#atlassian-cloud-auth-provider)
2526
2627The provider can be selected using the `provider` configuration value.
2728
@@ -540,6 +541,25 @@ The default configuration allows everyone with Bitbucket account to authenticate
540541```
541542
542543
544+### Atlassian Cloud Auth Provider
545+
546+1. Create a new OAuth2.0 integration app in the Atlassian Developer console as described [here](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-)
547+2. Under Permissions add access to the User REST API and User identity API
548+3. Under Authorization configure your callback url to match the proxy url, like `https://<proxy_host>/oauth2/callback`
549+4. Get Authentication details under Setting
550+5. Run proxy with the following options:
551+```
552+ --provider atlassian
553+ --provider-display-name "Atlassian"
554+ --client-id <client ID from step 4>
555+ --client-secret <secret from step 4>
556+ --redirect-url http://<proxy_host>/oauth2/callback
557+ --cookie-secret <cookie secret>
558+```
559+
560+Note: By default the app is limited to the user who created it. To start sharing the app with your team you must first Enable sharing under the Distribution settings in the Developer console.
561+
562+
543563## Email Authentication
544564
545565To authorize by email domain use `--email-domain=yourcompany.com`. To authorize individual email addresses use `--authenticated-emails-file=/path/to/file` with one email per line. To authorize all email addresses use `--email-domain=*`.