Connect to G Suite
When you connect G Suite, you sync your users to sites that are part of your Atlassian organization.
We’re releasing a new G Suite admin experience. If you connected to G Suite before mid-August 2020, the admin experience won’t change (at least not now). If you connect to G Suite after mid-August 2020, the admin experience will be different. We’ll note those differences.
Before you connect
Before connecting your G Suite account, check that:
You’re a site admin (if you find G Suite from your site) or an organization admin (if you find G Suite from your organization).
You’re an admin for yourG Suite account with following permissions:
Organization Units > Read
Users > Read
If your G Suite admin access is revoked, your G Suite sync will stop working.
Connect to G Suite
You can find G Suite from your site’s administration under Site setting or your organization administration view after clicking Directory.
Go to your organization at admin.atlassian.com.
Select G Suite.
Click Connect G Suite.
Sign in to yourG Suite account.
Click Allow to provide consent for Atlassian to view the information needed to connect G Suite. This information includes who you are on Google and your email address, domain, and users and groups on your domain.
If you connect to G Suite after mid-August 2020, your setup will be different. Learn how to configure the new settings for G Suite.
6. From the Select users page, select how you want to sync users from G Suite.
6a. If you select Sync all users, we’ll sync all existing and future users from your G Suite to your organization.
6b. If you select Sync users from specific groups, select the groups you want to sync. We’ll sync all existing and future users in those groups. Any G Suite users who don’t belong to those groups won’t be synced.
After you connect
We’ll sync your users. After the sync here's what happens:
Product access for new users
- If your G Suiteusers don’t already have an Atlassian account, you need to grant them product access.
To grant new users product access:
Go to your organization at admin.atlassian.com
Select Sites and Products.
Select Product Access
Add the group and its new users to products.
Product access for previously synced users
If you disconnect your org, we maintain product access for your previously synced org users. When you reconnect the org, any previously synced users that are not in the new sync are removed from the site(s) and lose product access.
Linking Google and Atlassian accounts
If a user you’re syncing from G Suite already exists in a site, we’ll link the Google and Atlassian accounts based on their primary email address and Google identification.
Automatically sync product details
If a user already exists in a site but isn’t in the G Suite group you’re syncing, the user keeps their product access after you sync.
However, we won’t sync your updates to product details of unsynced users in G Suite. Add the user to a synced group or sync all users to automatically keep their details up to date in your organization.
If you find G Suite from your organization, we sync all G Suite users to a single group called All users from G Suite. To find this group, go to Directory > User provisioning under the Groups tab.
If you connect after mid-August 2020 to G Suite and subscribe to Atlassian Access, you can sync specific G Suite users to specific groups.
All domains and sub-domains associated with your G Suite account become verified for your organization. Go to Directory > Domains and select the G Suite tab to see a list of those domains.
Going forward, any updates you make to a synced Google account will get updated in your organization when G Suite syncs (every 4 hours). You’ll see all synced users from the Directory > Managed accounts in the organization.
Disconnect from G Suite
When you disconnect from G Suite, users permanently stop syncing. Your users can still log in to your products with their Google credentials or log in with Atlassian credentials after they reset their password. However, their details won't sync when you make changes to their Google accounts.
Unless you verify your domain from your organization at admin.atlassian.com, you won’t be able to manage or edit account details for users with accounts from that domain.
To disconnect your organization’s site(s) from G Suite:
Navigate to G Suite at admin.atlassian.com.
If you’re an organization admin, select your organization name and go to Directory > G Suite in the left navigation.
If you connect to G Suite after mid-August 2020, you'll see G Suite from your org. If you connected before mid-August 2020, you'll see G Suite from your site.
If you’re a site admin, select your site name and go to G Suite in the left navigation.
1. Click Disconnect account and follow the prompts.
2. After you disconnect, we don't save any of your G Suite settings. You can start syncing your users again by setting up another connection to G Suite.
Product access for users after you disconnect G Suite
Users will not lose product access when you disconnect G Suite. If you require users to log in with Google, they will need to reset their password to log in.