Enable or disable G Suite integration

Before you begin

To enable G Suite integration, you'll need to organize two things: administrator permissions, and Atlassian account.

Permissions

Before integrating with G Suite, make sure you've:

  • Allowed access to the Google Administrative APIs for your domain. Ensure this setting is enabled on your domain before integrating G Suite.
  • Obtained administrator access on your G Suite domain to set up the integration. 
    Note: If your administrator access is revoked in the future, your integration will stop functioning.
  • Become a site admin in Atlassian Cloud. 
    Note: Once the connection is established, you won't have to keep your admin permission in Atlassian Cloud to maintain the connection.

Check out the G Suite FAQs for additional permissions that may be required to set up group-based syncing. 

Atlassian account

We also highly recommend enabling Atlassian account - our authentication system that lets users log in to all Atlassian Cloud products with a single account and password. This will make managing your G Suite users much simpler. The information in our G Suite documentation has been written for sites with Atlassian account enabled, and you may get unexpected behaviour if you don't enable it first.

Check out  Introducing Atlassian account for more information.

To enable Atlassian account:

  1. Select  > User management.
  2. In the left-hand menu, select Atlassian account.
  3. Select Enable Atlassian account.

How to connect G Suite to your Atlassian Cloud site

  1. Go to 
     >  User management
    .
  2. Select G Suite in the sidebar
  3. Select Connect G Suite.
  4. Follow the prompts to select which groups you want to sync from G Suite. When you're done, your screen should look like this:



    You can connect multiple Atlassian Cloud sites to the same G Suite account - if you do, ownership of the domain and users from the domain would be shared across instances. 

Domain management

When you connect your Atlassian site to G Suite, all domains associated with your G Suite account, including sub-domains, will be automatically claimed on your behalf and all domains that you have previously manually claimed will be revoked. Claiming domains gives you the ability to manage any users coming from those domains, by being able to manage their account details. As long as you remain connected to G Suite, you won't be able to manually claim any domains via Atlassian administration.

Note that if you have users who belong to a claimed domain, but aren't part of the groups you've synced, you can't edit their details anywhere. If you'd like to update a user's details, they'll need to be synced.

To learn more, check out our page on Domain verification

Password policies

When you connect your Atlassian Cloud site to G Suite, your existing password policy will be revoked. You can set a password policy for your Google-managed users in G Suite. Any users not belonging to your Google domains will have a default password policy set by Atlassian. Check out How G Suite users log in for more information.

How to set default application access

After you enable G Suite, you can set up which applications new Google users have access to, and which groups they're placed in when the users are initially created. See Manage application access for full details.

How to disconnect G Suite from your Atlassian Cloud site

When you disconnect your G Suite integration:

  • Your users will still be able to log in to your Atlassian Cloud site with their Google credentials. However, their details won't be synced.
  • If your domain hasn't been claimed by an Atlassian Cloud instance, then users with accounts from that domain will no longer be managed and will be able to edit their account details.

  1. Go to 
     >  User management
    .
  2. Select G Suite in the sidebar.
  3. Select Disconnect G Suite and follow the prompts.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport